| name | doc-dev |
| description | 技术文档编写专家,提供规范、设计、TDD计划三类文档的标准化模板和质量标准。 |
| version | v1.0 |
| tags | documentation, specification, design, tdd |
| allowed-tools | Read, Write, Edit |
| requires-skills |
技术文档编写
🎯 垂直职责
单一职责: 技术文档标准化 - 规范文档、设计文档、TDD计划
📦 三类文档模板
1. 规范文档 (Specification)
用途: 设计契约,定义高层约定
命名: {EP}_ABI_设计文档.md
结构:
# {标题} 规范
**版本**: vX.Y | **状态**: 草稿/评审中/已通过
## 1. 概述
### 1.1 设计目标
### 1.2 术语定义
## 2. 技术规范
### 2.1 核心概念
### 2.2 规范细节
## 3. 实现指南
### 3.1 使用示例
## 附录A: 版本历史
2. 设计文档 (Design)
用途: 实现指南,展示技术细节
命名: {EP}_{模块}_设计文档.md
结构:
# {EP} {模块} 设计文档
**版本**: vX.Y
## 1. 设计概述
### 1.1 设计目标
### 1.2 关键设计决策
## 2. 详细设计
### 2.1 核心组件设计
### 2.2 交互设计
## 3. 技术细节
### 3.1 算法实现
## 4. 测试验证
### 4.1 单元测试策略
3. TDD任务计划
用途: 任务驱动,追踪进度
命名: TDD_重构计划.md
结构:
# TDD重构计划: {主题}
**版本**: vX.Y
## 1. 概述
### 1.1 重构目标
### 1.2 成功标准
## 2. 任务追踪表
| 层级 | 任务ID | 描述 | 状态 | 优先级 |
## 3. 任务详情
### TASK-1.1: {任务名称}
**目标**: 明确目标
**验收标准**:
- [ ] 所有测试通过
**状态**: ✅/🔄/⏸️
📊 质量标准
| 维度 | 权重 | 目标 |
|---|---|---|
| 文档完整性 | 30% | ≥90 |
| 章节规范性 | 20% | ≥85 |
| 任务追踪率 | 25% | 100 |
| 综合 | 100% | ≥90 |
📐 命名约定
| 类型 | ✅ 正确 | ❌ 错误 |
|---|---|---|
| 规范文档 | EP21_ABI_设计文档.md | abi_doc.md |
| 设计文档 | EP21_SSA_设计文档.md | ssa.md |
| TDD计划 | TDD_重构计划.md | plan.md |
| 任务ID | TASK-001, TASK-2.1 | 1.测试 |
版本: v1.0 | 垂直职责: 技术文档编写 | 2025-12-23