结构化项目管理技能，提供ADR/PRD/用户画像等标准化文档模板与Docs-First方法论，帮助团队建立可维护的文档体系，适合需要规范化工程文档的中大型团队。
说明：
## 核心用法
`project-documentation` 是一个**工程文档元技能（Meta-Skill）**，采用”文档优先（Docs-First）”方法论，强制要求团队在编码前先定义问题、用户画像、功能需求和技术栈。核心交付物包括五类标准化文档：
– **ADR（架构决策记录）**：记录技术选型理由与权衡
– **PRD（产品需求文档）**：定义问题、用户、需求边界与成功指标
– **Persona（用户画像）**：描述目标用户的背景、痛点与使用旅程
– **Runbook（运维手册）**：可执行的操作步骤与故障排查指南
– **Roadmap（路线图）**：分离当前迭代与待办事项
### 目录结构规范
技能强制区分**Current State（现状）**与**Future（规划）**文档，避免用户混淆。`architecture/`、`guides/`、`runbooks/` 面向真实系统状态，可公开；`planning/` 存放未来规格，仅限内部。
### 质量门禁
提供7项发布前检查清单，核心红线包括：禁止混合未来计划与当前状态、禁止规划文档上站点、禁止文档一次性写完即弃。
## 显著优点
1. **方法论完整性**：ADR+PRD+Persona 的组合覆盖架构、产品、用户三层视角，减少”先写代码后补文档”的债务
2. **模板标准化**：提供可直接使用的 Markdown 模板，降低团队启动成本
3. **状态隔离设计**：通过目录结构强制分离”是什么”与”将是什么”，避免文档站信息过时
4. **反模式警示**：明确列出5类常见错误（如单文档适配所有读者），帮助团队规避典型陷阱
## 潜在局限
– **适用规模门槛**：Docs-First 流程对小规模快速原型项目可能显得过重，存在流程摩擦
– **执行依赖纪律**：模板和结构提供了”形式”，但内容质量仍依赖团队写入时的自律，系统无法强制内容深度
– **技术栈偏向**：示例中的 `npx clawhub` 安装命令暗示特定工具链（OpenClaw/Moltbot），对非该生态用户存在迁移成本
– **动态更新挑战**：虽强调”Living docs”，但未提供自动化检测代码-文档漂移的机制，维护仍需人工驱动
## 适合人群
– **技术负责人/架构师**：需要建立团队级决策记录规范
– **产品经理与工程师协作场景**：PRD与ADR的双轨并行适合产品驱动型工程团队
– **中大型项目维护者**：已有代码库需要补全或重构文档结构
– **开源项目维护者**：需要对外提供清晰的架构说明与贡献指南
## 常规风险
– **文档腐败风险**：若团队未建立”代码变更同步更新文档”的纪律，Current State 文档将迅速失效
– **过度设计风险**：小团队可能因遵循完整模板而产生冗余文档，反而降低效率
– **工具锁定风险**：`clawhub` 生态的安装命令可能限制跨平台使用，建议确认模板内容的工具无关性
会员专属
