메뉴
把零散的输入（聊天记录 / TAPD 摘要 / 用户描述）写成符合模板的 requirement.md。是 requirement-input-normalizer Agent 的核心子能力。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | requirement-doc-writer |
| description | 把零散的输入（聊天记录 / TAPD 摘要 / 用户描述）写成符合模板的 requirement.md。是 requirement-input-normalizer Agent 的核心子能力。 |
| allowed-tools | Read, Write, Edit, Glob |
原文 §8.3 文档撰写类。只产文档，不做判断——判断由
requirement-quality-reviewerAgent 负责。
严格按 context/harness-framework/templates/requirement.md 的结构：
1. 背景
2. 目标（带可衡量指标）
3. 非目标
4. 验收标准（REQ-*）
5. 影响面
6. 风险与权衡
7. Rollback 思路（如需）
8. 评审记录（自动填）
| 章节 | 准则 |
|---|---|
| 背景 | 3-5 句话，含现状 + 痛点 + 触发事件，不写"为了完成 XX 任务" |
| 目标 | 每条带 KPI/SLA/数值；模糊措辞如"提升体验"必须替换 |
| 非目标 | 至少 1 条，避免后续无限扩张 |
| 验收 | REQ-001 起编号，每条必须可被一条测试用例覆盖 |
| 影响面 | 服务名严格匹配 .service-matrix/dependencies.yaml，不存在就提示 onboard |
| Rollback | 涉及数据迁移时强制 3-4 步骤 |
notes/{date}.md 而非 requirement.md（保留原文与结构化产物的对应关系）校验业务代码与 IDL 契约同步、字段冻结状态是否被破坏。作为 8 维度 code review 的"契约一致"维度，可被 design-checker / code-review-preparer 调用，也可独立运行。
聚合 8 维度 review Agent 的产出，生成统一的 review 报告并写入 reviews/{ts}.md。
当 context/ 下新增/删除文件时，自动更新对应层级的 INDEX.md，避免"孤儿文件"。
按 templates/detail-design.md 模板撰写详细设计文档，包括数据模型、IDL 变更、接口设计、决策、错误处理、监控、灰度等。
运维操作中心（Operations Center）通用适配器——为团队的运营/运维操作（开关、灰度、限流、降级）提供统一调用约定。具体实现按团队接入。
DevOps CLI 通用适配器——把团队的部署/构建/发布命令包装成一致的高层接口。具体实现按团队接入。