用途:让项目文档和文档包易于阅读、续接、评审,并可作为代码工作的依据。大型工作可将文档集视为代码包:清晰入口、单一职责的小模块、明确的读者路径,并区分当前事实来源、证据、历史、草稿与陈旧材料。
模式:Document Compose(起草或重写单个文档)、Document Review(评审单个文档,先列问题与风险)、Package Compose(构建或重构多文件设计、迁移、运行手册、实现或交接包)、Package Review(评审包的所有权、导航、陈旧状态、重复与实现就绪度)。
原则:遵循仓库或工作区既有路径、文件名、日志、归档与工作区约定;本技能定义语义文档质量而非存储布局。保留源含义,不编造事实、承诺、负责人、日期、指标、约束或决策;保持试探性语言为试探性。将当前事实来源与证据、时间线、草稿、归档材料分开;一个当前决策、契约、门禁或计划应只有一个归属文档。包入口文档通常应为当前规范、路由或有界执行/运行手册包。保留有用源形式,如邮件、清单、ADR、运行手册、交接与日志。结构无实质改善时优先轻改或不改。评审澄清文档状态、所有权、范围与风险,不重新设计底层系统,除非源已如此框定。
包角色(作为视角而非模板):入口、路由、规范模块、门禁/运行手册、待办/TODO、证据/日志、工作/归档、参考候选。
编写规则:从读者任务出发(续接、决策、实现、验证、操作),只创建源支持的面。若两文档重复同一当前结论,在源或既有约定明确归属时择一归属,否则标记归属决策。迁移或所有权变更时显式降级旧文件,使其路由到新归属或标注历史/归档状态。已有面拥有某事实、决策或路由时,先编辑该面。将用户更正与删除请求视为编辑输入:替换、删除、降级到归档/工作区或指向归属面。
评审规则:先按严重度列问题/风险,再给证据与所需变更。检查入口缺失或误导、读者路径不清、重复归属、草稿/证据堆/陈旧报告看似当前、当前摘要被时间线或命令记录污染、日志或研究含唯一当前结论、待办风格模糊、门禁/运行手册缺前置条件/停止条件/回滚/恢复/证据/审批边界、迁移包旧文件仍似规范、链接陈旧材料无状态标签、需显式归属或策略选择的决策。需归属或策略选择而未由源确定的变更,标为决策请求而非静默重写。不要仅为整洁重写仅追加日志,除非明确要求历史清理。
输出契约:编写工作尽量直接编辑,否则返回可发布 Markdown 并列出受阻输入。评审工作使用:问题/风险、证据、所需变更、开放问题或决策请求。
限制:资料未提供具体安装命令、平台、收费或价格信息。