用途:用于编写或评审 AGENTS.md、CLAUDE.md、SKILL.md、ADR、README 和知识库笔记,判断某项内容是否值得记录,处理持续偏离现实的文档,规划项目知识组织方式,以及为遗留系统补写或抢救文档。
主要能力:提供一组便于记忆的格言与八个主题(准确性、什么值得记录、知识存放位置、理由与决策、以强制替代散文、整理与导航、生成式活文档、反馈循环),并配有按文档类型(代理文档、技能、ADR、知识库)重新应用的分析材料。原则包括:只记录相对默认值的增量、第二次纠正时才写规则、代码展示 what/how 而文档解释 why、把知识放在它所描述的对象旁、引用易变指向稳定、链接而非重复解释、不把派生结果存为源。
使用方式:评审文档时执行引用中列出的检查,如显著性检查、两分钟测试、常青/易变分类,并为每个手工维护的事实命名保持其为真的机制。文档持续腐烂时,增加对账检查、把规则改为强制或从源头派生事实。抢救遗留系统时参考相应材料。对于可机械强制的规则,指向其他相关技能而非重复表述。
限制:资料未提供具体安装命令、平台支持、收费方式或与具体工具的集成步骤。