detail-design-doc-writer

name	detail-design-doc-writer
description	按 templates/detail-design.md 模板撰写详细设计文档，包括数据模型、IDL 变更、接口设计、决策、错误处理、监控、灰度等。
allowed-tools	Read, Write, Edit, Glob, Task

Skill: detail-design-doc-writer

原文 §8.3 文档撰写类。是 detail-design-quality-reviewer 的"上游写作器"。

强制章节

1. 总览
2. 数据模型（含索引设计、迁移、Rollback）
3. IDL 变更（涉及时；必须含字段冻结状态）
4. 接口设计（新增 / 修改）
5. 关键决策 DEC-*（每条带 traces_to: [REQ-*]）
6. 错误处理（错误码 ⊆ context/team/error-code-space.md 段位）
7. 安全考量
8. 监控与告警
9. 性能与容量
10. 测试计划
11. 灰度计划

跨文档一致性

• DEC 编号必须连续（不与 outline-design.md 冲突；通常 detail 复用并扩展）
• 涉及的 service 必须在 .service-matrix/dependencies.yaml 中存在
• 错误码必须符合域段位（写之前调用 engineering-spec-query Skill 校验）

触发的协同 Skill

时机	调用
写错误码时	engineering-spec-query 查段位
写监控时	engineering-spec-query 查告警基线
写 IDL 变更时	api-contract-consistency-validator 做 K5/K6 预审
写完后	traceability-gate-checker 跑 T1
写完后	detail-design-quality-reviewer Agent（强制门禁）

反模式

• ❌ 把"待定"内容写成已决定
• ❌ 数据迁移没写 rollback
• ❌ IDL 变更没标字段冻结状态
• ❌ 决策点没 traces_to（直接被 3.3 门禁拦下）