用途:这是一个文档治理技能,针对仓库文档缺失、过时、重复、难以导航,或需要更清晰的唯一事实来源结构时使用。也适合在不使页面膨胀的前提下补充长期有效的工程指引。
主要能力:决定每个事实的规范存放位置;偏向编写可导航的文档,通过链接指向细节而非复制细节;保持引导页精简,把工作流脚手架移入技能;在修改代码或策略的同一变更中同步更新过时文档。交付物包括更清晰的文档结构、更好的事实来源放置,以及与实际代码和工作流一致的文档。
使用方式:先阅读最近的 AGENTS.md 确认范围与约束;通过 Ralph Loop 执行技能工作流至结果可接受;按固定结果格式返回具体产物与验证证据。Ralph Loop 要求先头脑风暴(分析现状、定义问题与目标、列出约束与风险、比较方案),再制定执行计划(含最终验证技能及顺序),每次执行一个步骤并产出具体改动,审查后小批量修复并重跑检查,反复直至可接受或仅剩明确例外。
输入与验证:需提供当前文档结构与入口页、文档应反映的代码/策略/工作流、重复或冲突的事实来源。验证标准为每个持久事实只有一个明确归属、入口页能正确引导读者、页面不因模板或参考内容堆积而膨胀、文档匹配真实仓库而非预期中的未来仓库。
限制:不用于编写已有技能可覆盖的具体功能规范或 ADR;不用于把大段模板内容倾倒入公开页面。若依赖缺失,可自行引导或返回 status: not_applicable 并说明原因与回退路径。官方资料未提供收费、价格与平台信息。