| name | requirements_write |
| description | Manager 起草需求文档 needs/requirements.md 的 skill。当 requirements_guide 判定 coverage_complete=true 且用户 approve 时**一定**加载本 skill。按 5 节模板从对话历史里提炼产出 needs/requirements.md。任何'需求已清、可以落文档'的时刻都走此 skill。 |
| type | reference |
requirements_write — 起草 requirements.md
🚨 Critical Rules
- 5 节缺一不可：Goal/Boundary/Constraint/Risk/Acceptance。
- Acceptance 必须可机械验证：每条能写成 pytest 断言（不是"体验流畅"这种模糊词）。
- Not-doing 清单越具体越好：否则 PM 会悄悄把它做进去。
步骤
Step 1 — 汇总对话
从 requirements_guide 四维对话历史整理关键决定。
Step 2 — 按模板生成
# {产品名} 需求文档
## 1. 目标（Goal）
- 核心痛点：...
- 目标用户：...
- MVP 功能清单：
1. ...
2. ...
3. ...
## 2. 边界（Boundary）
- **做**：...
- **不做**：...（3 条起）
- 时间预算：...
## 3. 约束（Constraint）
- 技术栈：...
- 部署：...
- 安全/合规：...
## 4. 风险（Risk）
| 风险 | 影响 | 缓解 |
|------|------|------|
## 5. 接受标准（Acceptance，每条可机械测）
- [ ] POST /diary 能创建日记并返回 201 + id
- [ ] GET /diary?limit=200 返回 422
- [ ] ...
Step 3 — 写入
write_shared(project_id, "needs/requirements.md", content)。
Step 4 — 记录事件
append_event(project_id, "requirements_drafted", {"sections": 5, "acceptance_count": N})
Step 5 — 发 checkpoint_request 请求最终确认（可选但推荐）
send_to_human(routing_key, message=摘要 + "请回复 同意/修改建议", kind="checkpoint_request", project_id=..., checkpoint_id=...)；配合 CheckpointStore.register。
输出
{
"status": "success",
"artifacts": [{"path": "needs/requirements.md", "kind": "doc"}],
"metrics": {"sections": 5, "acceptance_count": 8, "mvp_features": 5}
}
