project-documentation

project-documentation 是一个面向软件开发团队的 Meta-Skill，专注于建立标准化的项目文档体系。它倡导"文档优先"（Docs-First）的哲学，即在编写代码之前先定义产品理念、用户画像和技术架构，确保团队在开发初期就建立完整的上下文认知。

核心用法

该 Skill 提供了一套完整的文档工作流框架。用户首先通过标准化的目录结构组织文档，将内容严格区分为"当前状态"（Current State）和"未来规划"（Planning）两大类，避免混淆已实现功能与设计草案。它内置了四种核心文档模板：架构决策记录（ADR）用于追踪技术选型理由，产品需求文档（PRD）明确功能定义与成功指标，用户画像（Personas）描述目标用户特征与旅程，以及运行手册（Runbooks）提供标准化的运维操作指南。此外，该 Skill 还包含质量门禁（Quality Gates）和常见反模式（Anti-Patterns）提醒，帮助团队维持文档的高质量和一致性。

显著优点

首先，该 Skill 提供了经过验证的文档分类方法论，通过强制分离"当前状态"与"未来规划"，有效避免了传统项目中常见的设计文档与实现文档混杂导致的认知混乱。其次，它提供了即用型的 Markdown 模板，覆盖了从架构决策到运维操作的全生命周期，显著降低了团队建立文档规范的门槛。第三，"文档优先"的方法论有助于在项目早期发现需求不一致或技术债务，减少后期返工成本。最后，作为纯文档型资产，它无需复杂的安装配置，可立即投入使用。

潜在缺点与局限性

作为纯指南性质的 Meta-Skill，它不提供自动化文档生成或 CI/CD 集成功能，所有文档仍需人工编写和维护，无法解决文档更新滞后的问题。此外，提供的目录结构和模板是基于通用最佳实践，对于特定行业（如金融合规、医疗监管）可能需要大量定制化调整。来源为个人开发者（T3 级），虽然内容安全，但长期维护的稳定性与更新频率不如企业级项目，且模板内容需要用户自行验证是否符合组织标准。

适合的目标群体

该 Skill 特别适合正在启动新项目的初创团队、需要规范文档流程的中小型技术团队，以及希望建立文档文化的产品经理和技术负责人。对于采用敏捷开发但需要保留架构决策记录的团队，以及需要为开源项目建立贡献者文档的维护者而言，该 Skill 提供了极佳的起点。同时，对于咨询顾问或技术负责人需要在多个项目间建立一致的文档标准时，该 Skill 也能提供有效的结构支持。

使用风险

从安全角度，该 Skill 几乎无风险。它是纯 Markdown 文档集合，不包含可执行代码、无数据收集行为、无网络通信需求，也无危险系统操作指令。唯一需要注意的是，使用时建议审查提供的文档模板是否符合所在组织的合规要求和行业标准，特别是在处理敏感项目或受监管行业时，需要对模板进行适当的本地化调整。