用途:为编码智能体仓库创建、审阅和重组可持续维护的技术文档,核心是把“读者目的”和“内容交付时机”作为两条独立轴线来安排材料。
主要能力:一是按 Diátaxis 对信息块(而非整份文件)分类:教程用于安全引导式学习,How-to 用于完成真实任务,Reference 用于查阅准确事实,Explanation 用于说明系统为何如此设计及取舍。二是按激活方式选择交付位置:始终加载的内容(根 AGENTS.md、CLAUDE.md、权威 README)放权限、优先级、通用不变量与路由触发;按需触发加载的内容放技能,承载可执行操作流程与任务级规则;源码本地内容放包 README、类型、模式、清单中的参考信息;解释类文档可搜索获取;计划、PR、变更日志、事故记录按生命周期保存证据。三是给出了文档重组的步骤:识别读者与任务、清点信息块及其现有归属、按目的与激活方式分类、为每条事实规则流程选取唯一归属、移动而非复制并留短链接、按目的地用途重写、删除过期重复并校验链接与机制。
使用方式:该技能作为文档编写工作流使用,适用于整理智能体仓库的文档结构。当编辑任何对智能体发出指令的界面时,如可用应加载 writing-agent-rules;计划与 RFC 优先用 writing-technical-plans;面向人类读者的报告用 writing-user-facing-reports。
限制与注意事项:交付位置映射只是默认建议,不应为凑齐框架而创建空的 tutorial/、how-to/、reference/、explanation/ 目录树;没有明确学习需求就不建教程。索引可以链接但不应复述可从规范来源直接获得的事实。历史记录不属于第五个 Diátaxis 象限,当前行为应写在代码、测试或所属参考/技能中;若持久性理由仍有效,应提炼进当前解释或参考。成功标准是读者能回答:从哪里开始、此任务加载什么、当前准确契约在哪、为何如此设计、哪些记录是历史证据。资料未提供具体收费、平台、命令或版本信息。