write-manual
Installation
SKILL.md
编写手册
手册深入解释协议、文件格式或运行时等主题的一个精确版本。课程讲完概念就继续,手册要让读者能预测未展示场景下的系统行为。
本技能包括研究、来源排序、冲突登记、离线运行记录、固定章节结构、写作限制,以及必须输出 TOTAL 0 的审计。适用于任意仓库。课程仓库已有工具,manuals/a2a-101/ 是完整示例。
适用情况
- 读者需要预测某系统固定版本在未展示场景下的行为。
- 主题有可固定到提交的规范、schema 或源码树。
- 能离线运行主题或忠实替代实现,记录请求与响应。
- 产物为 60 至 100 页,包含图表,且后续由其他人维护。
使用其他方式的情况
- 注意力或检索等通用概念:写课程。
- 无版本可固定,或每周变化:先明确稳定范围。
- 无法运行且无法记录输出:只能交付文章,不能声称有运行记录的手册。
- 简短操作指南或不足约十五节:无需这套完整结构。