用途
该技能用于在开发过程中从一次纠正或反复出现的错误中学习,把口头叮嘱转化为可强制执行、可验证的结构性约束,避免同类错误再次发生。
主要能力
- 将模糊的提醒改写为可检测的检查项,例如把“注意列表输出”写成“列表命令在名称之前打印 id”。
- 按强度从高到低选择约束方式:编译器拒绝的类型、.oxlintrc.json 中的 lint 规则、扫描代码或命令树的测试(如 src/lib/root-options.test.ts 检查 cli-core 的 argv 扫描与 commander 一致)、.agents/scripts/ 中的脚本检查(verify、hook)、.agents/checks/ 中供人工判断的评审检查,最后才是 AGENTS.md 或技能中的一行说明。
- 对已有规则仍被违反的情况,直接跳到前四种更强结构,并说明更强选项不适用的原因。
- 通过故意犯错验证新结构会失败、移除后通过,并运行 npm run verify 确认。
- 清理被新检查取代的冗余说明,更新 docs/agents.md 规则表中的规则、承载方式与确定程度。
- 以只含该规则的独立 pull request 交付,标题使用 chore: 或 test: 以免触发发布。
使用方式
按五个步骤执行:命名错误、选择最强结构、验证能捕获错误、删除被替代的内容、独立提交。每一步都有明确的完成标准。
适用场景
适用于需要把团队约定和纠错经验固化为代码级约束的开发项目,尤其是命令行工具类代码库。
限制
该资料未提供具体安装命令、依赖版本、支持平台或收费信息,相关内容暂未提供。