用途:这是一个可移植的指令型技能,用于在代码交付前对生成或改动的代码进行质量守卫。它不依赖 MCP 服务器、网络、API key、shell 命令或本地可执行文件,可在任何支持 SKILL.md 及直接链接的 references 文件的运行时中使用;agents/openai.yaml 仅为轻量展示元数据。它不替代项目的 linter、格式化器、类型检查器或测试运行器,机械验证交给项目自身工具,本技能负责代码质量与审阅的判断层。
主要能力:覆盖命名与函数(函数目标不超过20行、参数不超过4个、禁止布尔标志参数、命令与查询分离)、注释与结构(注释只解释为什么、匹配现有文件风格)、SOLID(单一职责、开闭、里氏替换、依赖倒置)、DRY/KISS/YAGNI(删除重复知识而非重复文本、圈复杂度不超过10、嵌套不超过5、不做投机设计),以及最高杠杆的 AI 特有失败模式(禁止宽泛捕获吞错、在信任边界做校验、核实每个导入与外部调用、禁止硬编码成功返回或测试夹具、从规格重新推导而非复制、先枚举边界情况、交付前清除死代码、先读后写、不为少量代码引入新依赖)。
使用方式:有三种模式。守卫通过模式为推荐默认,在代码生成、修改、重构或修复后检查 diff 或目标文件,交付前修复违规。实时模式在用户于风险代码修改前显式调用时启用,边写边应用规则并在交付前自检。审阅模式在用户要求 review、audit、critique 或评分时触发,按 references/review-checklist.md 输出结构化发现报告,未经要求不修改代码。规则正文位于 references/ 下,包括 naming-and-functions.md、comments-and-formatting.md、solid.md、dry-kiss-yagni.md、ai-failure-modes.md、review-checklist.md、sources.md;其中 ai-failure-modes.md 对 AI 代理建议优先阅读。交付前需走自检清单,并输出如 clean-code-guard: N fixed, M flagged for author 或 clean 的报告,仅报告实际改动,不估算质量分数或百分比。
适用场景与限制:适合代码编写、代码审阅和重构任务,期望避免所列失败模式、审阅给出带证据的优先级发现、重构保持可观察行为不变。对概念性任务、CI、git 工作流、文字写作、数据分析和测试运行等任务应保持静默。若规则与项目显式约定冲突,遵循项目约定。若用户有情境化理由需覆盖某规则,可在代码注释中记录被覆盖的原则、原因与重新审视触发条件。技能不运行 linter 或静态分析、不强制语言特定格式偏好、不替代测试。具体安装与调用细节、作者其他信息暂未提供。