By name: ys-team-spec-talk description: "Create or review a ys-team verifier card for a non-trivial change. Use when 用户说「起一个 spec」「为这件事开 spec-talk」「grill 我」「把刚才讨论写成 spec」等。"
ys-team-spec-talk
被调用时立即执行：
- 读取
.ys_team/config.yaml、.ys_team/rules.md、.ys_team/reality.md、.ys_team/glossary.md和相关项目文档。 - 做意图三段判断：当前对象、当前目标、当前阻塞。
- 如果边界不清，先 grill；问题过多时生成
questions.md。 - 收敛后写 verifier 卡到
docs/specs/queued/<initiative-id>/spec.md。 - 运行结构 lint；不通过则继续澄清或标记 BLOCKED。
- 对关键、不可逆、多模块工作，可请求跨模型对抗审阅。
- 更新
.ys_team/status.md。
Read Order
.ys_team/config.yaml.ys_team/rules.md.ys_team/reality.md.ys_team/glossary.md- 相关项目文档、ADR、已有 spec
.ys_team/memory/中相关领域错题本.ys_team/templates/spec.md与questions.md
只读取与任务相关的错题本，不加载无关历史。
Intent First
先判断：
- 当前对象：idea / requirement / existing spec / implementation gap
- 当前目标：澄清 / 起草 verifier 卡 / 审阅 / 执行准备
- 当前阻塞：边界不清 / 验收不清 / scope 不清 / 无阻塞
阻塞不清时先问用户。
Grill
适用于需求模糊、验收不清或用户明确要求“问我”。
规则：
- 一次只问一个问题。
- 优先问会影响验收和 Write-Scope 的问题。
- 5-7 轮内收口。
- 收口后形成“已澄清命题”，再写 verifier 卡。
文件化 Grill
触发：
- 待确认问题超过 5 个。
- 横跨目标、范围、行为、验收、迁移、风险多个维度。
- 聊天追问会丢失问题树。
产物：docs/specs/queued/<initiative-id>/questions.md，优先使用 .ys_team/templates/questions.md。
Ready For Spec：
- 目标清楚
- 非目标清楚
- 关键行为清楚
- 验收方式清楚
- Write-Scope 可估计
Verifier Card
必须包含：
- 意图
- 非目标
- Write-Scope
- 验收
- 保真度等级 L3/L2/L1/L0
- 人等价验收脚本，或降级理由
- Feedback Loop
- 交付清单
- 依赖 / 风险
兼容仓库旧 spec 模板时，也必须让这些信息可追溯。
Structure Lint
进入 spec-review / spec-work 前必检：
- Write-Scope 非空。
- Delete-Scope 覆盖删除行为。
- 每个交付项能追溯到 Write-Scope。
- 验收声明 L3/L2/L1/L0。
- UI/交互类验收低于 L2 时 REJECT。
- Feedback Loop 存在且可运行，或 N/A 理由成立。
- 文档同步、发布 gate、本地 SOP 交付项已列入。
v1.0 采用文档化必检规则，不默认生成脚本。
Adversarial Review
关键改动可启用跨模型对抗审阅。审阅者只看 verifier 卡、代码 diff 和验证结果，不看起草推理过程。
触发建议：
- 不可逆发布或数据迁移
- 安全、权限、支付、计费
- 多模块协议变化
- 用户明确要求独立审
trivial / 低风险 patch 可跳过。
Status
写入 .ys_team/status.md：
- active spec
- 当前阶段
- 最新判断
- 阻塞项或待确认问题
Output
输出应包含：
- 决策：PASS / BLOCKED / REJECT
- 当前状态
- 为什么
- 产出路径
- 下一步
可追加结果状态尾缀；尾缀不是完成条件。