（4347期）Project Documentation – 文档优先的项目治理框架

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