用途:在创建或编辑任何供智能体据以行动的文档时应用写作纪律,覆盖五个表面(CLAUDE.md、GLOSSARY.md、docs/standards/、design-system/、.omc/skills/)、规格、工单和技能文件。核心检验标准:全新的智能体会话仅靠阅读即可行动。
强制场景:drydock 生成表面种子、launch C5 sediment 将经验写入槽位时。其他编辑为可选,但面向智能体的文档编辑都应满足这些规则。
不适用:仅供人阅读的文档,如 docs/business/ 叙述、ADR 决策故事、面向人类入职的 README。
主要规则:为没有聊天历史的读者写作,文档自描述;每条规则可检验并附带理由;一个含义只有一个归属地;不重述环境已能自证的内容(包脚本、目录布局、--help 输出等可查项);步骤在前、参考在后、低频材料放在指针后;每步以完成标准收尾;三步以上流程编号;列表控制在一眼可读范围,更长枚举转为表格或小节;延后与计划工作注明时间;结尾给出读者可立即开始的下一步;读者中途重新加入时先重述当前状态;以正向表述为主,禁止项须配正向目标;写入时清除陈旧或冗余内容。
验证:报告文档修改完成前,确认新会话无需询问人类即可行动;每条规则可检验且说明理由;含义单一归属;指针标明触发分支;清除编辑中发现的陈旧冗余内容并保留有效无关内容;结尾给出可立即开始的下一步;重新加入的读者在新内容前看到当前状态;三步以上流程编号、列表一眼可读、每个延后项注明时间。
限制:资料未提供安装命令、平台、收费或价格信息。