Doc Workflow

文档工作流

管理项目文档的完整生命周期：创建 → 评审 → 发布。

文档类型映射

状态流转

draft → review → approved → released
  ↓        ↓         ↓          ↓
 创建    提交评审   评审通过    正式发布

状态说明

创建文档流程

当用户说"创建 PRD"或类似指令时：

1. 确认文档类型

   📝 将创建文档类型: PRD (产品需求文档)
   目标路径: docs/product/
   
   请确认或提供更多信息：
   - 文档标题: [等待输入]
   - 所属模块: [等待输入]
   

2. 收集必要信息

   • 文档标题
   • 所属模块（如果有）
   • 关联的需求背景（如果是技术方案）

3. 应用模版

   • 读取 templates/{type}.md
   • 填充 Front Matter:

     ---
     title: {标题}
     type: {类型}
     status: draft
     author: {当前用户}
     version: "1.0"
     created: {日期}
     updated: {日期}
     module: {模块}
     ---
     

4. 生成草稿

   • 根据上下文生成初步内容
   • 保存到目标路径
   • 更新 .claude/context/doc-index.md

5. 确认完成

   ✅ 文档已创建: docs/product/prd-{module}.md
   
   下一步建议:
   - 完善内容后修改 status 为 review
   - 使用 /skill feishu-sync 同步到飞书
   

状态变更流程

当用户修改文档的 status 字段时：

draft → review

📋 文档已提交评审

建议操作:
1. 通知评审人（如果在 team.md 中配置）
2. 在飞书 Bitable 创建评审任务
3. 同步到飞书知识库便于评审

是否执行？[全部] [选择] [稍后]

review → approved

✅ 文档评审通过！

根据项目流程，建议下一步:
- PRD 通过 → 创建技术方案
- 技术方案通过 → 拆解开发任务
- 测试方案通过 → 开始测试执行

是否继续？[是] [稍后]

approved → released

🎉 文档已正式发布！

可选操作:
- 同步到飞书知识库（公开可见）
- 通知相关团队成员
- 归档评审记录

模版版本检查

当用户说"检查模版更新"时：

1. 扫描 templates/ 目录获取模版版本
2. 对比 docs/ 中各文档的 template_version
3. 输出报告：

   📋 模版更新检查结果:
   
   templates/prd.md: v1.2.0 (最新)
   - docs/product/prd-order.md 使用 v1.1.0 ← 可更新
   
   templates/tech-design.md: v2.0.0 (最新)
   - docs/tech/tech-order.md 使用 v2.0.0 ✓
   
   是否更新过时文档？[选择] [全部] [取消]
   

Front Matter 规范

所有文档必须包含以下 Front Matter：

---
title: 文档标题           # 必填
type: prd|tech-design|... # 必填
status: draft|review|...  # 必填
author: 作者              # 必填
version: "1.0"            # 必填
created: 2026-03-09       # 必填
updated: 2026-03-09       # 必填
module: 所属模块          # 可选
template: prd             # 可选
template_version: "1.0"   # 可选
reviewers: [reviewer1]    # 可选
related_docs: [doc1]      # 可选
---

错误处理