requirements-write

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

1. 5 节缺一不可：Goal/Boundary/Constraint/Risk/Acceptance。
2. Acceptance 必须可机械验证：每条能写成 pytest 断言（不是"体验流畅"这种模糊词）。
3. 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}
}