【免费下载链接】guard-skillsGuard skills for coding agents, quality gates that catch AI-generated failure modes in code, tests, and docs项目地址https://gitcode.com/gh_mirrors/gu/guard-skills点击查看免费下载guard-skills 是一套面向 AI 编程智能体Coding Agent的质量门禁技能包让 Claude Code、Codex、Cursor 等 Agent 写完代码后先用专门的 guard 技能对改动做一遍复查在 AI 提交、合并之前拦住那些看起来能跑、实际上埋雷的问题——从吞掉错误的 catch-all到不存在的函数名再到文档里编造的 API。上手只需三步一条命令安装 → 记住 3 种运行模式 → 丢一句提示词给 Agent。下面带你快速跑通。guard-skills 是什么AI 代码的第二道安检传统 lint、格式化工具只检查代码合不合规而 AI 生成的代码往往语法完美、逻辑翻车。已公开的研究显示这类失败是系统性的代码重复量在 2021–2024 年间增长 8 倍16 个主流模型平均有 19.6% 的包名幻觉率——引用根本不存在的依赖Agent 会测试失败却声称成功用硬编码数据应付交付。guard-skills 就是为此设计的反应式复查层Agent 负责干活guard 负责在交付前把关。仓库内置 5 个技能按场景分工技能复查对象重点拦截的问题clean-code-guard任意语言的生成/改动代码吞错误、坏命名、过度抽象、SOLID/DRY/KISS/YAGNI 违规test-guard测试代码pytest/PHPUnit/Jest 等Mock 滥用、重复测试、测框架自身、抓不到 bug 的测试docs-guardREADME、docstring、变更日志幻觉函数、跑不通的示例、文档与代码漂移wp-guardWordPress 插件/主题/REST/AJAX未转义输出、缺 nonce、SQL 拼接、翻译缺失woo-guardWooCommerce 订单/结账/支付HPOS 兼容、绕过结账校验、金额计算错误每个技能的入口都是一个小巧的 SKILL.md详细规则放在references/目录按需加载不占 Agent 的上下文——比如 AI 特有失败模式清单在 ai-failure-modes.md。一条命令安装guard-skills 最快配置方法先确认机器支持 Skills CLIClaude Code、Codex、Cursor、OpenCode 等主流 Agent 均支持然后一条命令装全npx skills add amElnagdy/guard-skills只想要某一个技能加--skill参数即可npx skills add amElnagdy/guard-skills --skill clean-code-guard npx skills add amElnagdy/guard-skills --skill test-guard也可以按 Agent 或安装范围定制# 只装给某个 Agentcodex / claude-code / cursor npx skills add amElnagdy/guard-skills --skill clean-code-guard --agent codex # 全局安装 npx skills add amElnagdy/guard-skills --global安装前想先看看有哪些技能加--list即可浏览整个包。guard-skills 的 3 种运行模式Guard-pass、Live、Review每个技能都内置三种模式在 SKILL.md 中定义对应三种使用意图模式一Guard-pass 模式推荐—— 写完再查适用时机Agent 刚生成、编辑或重构完代码之后。Agent 对刚产出的 diff 逐条比对规则发现问题先修好再交给你看。这是官方推荐的默认用法——让 Agent 干活让 guard 把关。模式二Live 模式 —— 边写边查适用时机你明确希望 guard 规则在写代码时就生效高风险改动前。Agent 一边实现一边对照规则自检交付前再跑一遍 self-check。相当于把门禁从事后前移到事中。模式三Review 模式 —— 只评不改适用时机你说review 一下这段代码 / 这个 PR 能合吗。Agent 按 review-checklist.md 走查输出一份带文件:行号证据的结构化问题报告不改代码把决策权留给你。 一句话记忆Guard-pass 修完交你Live 边写边管Review 只出报告。一句话提示词让 AI 在提交前自动过一遍门禁guard-skills 的设计哲学是轻量触发——你不需要背诵规则只要用一句话点名技能。README 里给出的标准句式就是Use $clean-code-guard on the diff you just produced. Use $test-guard on the tests you just wrote. Use $docs-guard on this README update before we ship it. Use $wp-guard on this WordPress plugin change. Use $woo-guard on this WooCommerce checkout change.想启用 Live 模式也一样简单Use $wp-guard while implementing this REST endpoint, then self-check before delivery.小技巧guard 跑完后会主动汇报结果格式类似clean-code-guard: 3 fixed, 1 flagged for author——看到这一行说明门禁确实执行过了而不是自我感觉良好。该跑哪个 guard按场景对照选不确定用哪个技能时对照下表的Agent 刚改了什么那一列你刚让 Agent 做了……跑哪个 guard搭配建议任何语言的实现代码、重构、修 bugclean-code-guard平台特定 guardwp/woo新增或改动测试test-guard测试辅助函数含真实逻辑时加 clean-code-guardREADME、docstring、API 文档、changelogdocs-guard任何被文档描述的 guardWordPress 插件、主题、REST、AJAXwp-guardclean-code-guard涉及 Woo API 时加 woo-guardWooCommerce 结账、订单、支付、HPOSwoo-guardwp-guard 覆盖 WordPress 层规则细节都在各技能的references/里按需展开例如 WordPress 安全规则见 security.md金额处理纪律见 checkout-and-money.md文档核验流程见 verification.mdpytest 具体模式见 pytest.md。更新与验证一条命令保持技能最新技能是以副本形式安装的仓库发新版本后不会自动同步到你的 Agent需要手动刷新npx skills update # 更新全部已装技能别名 upgrade npx skills update clean-code-guard # 只更新指定技能另外这个技能包刻意做得可审计全部内容只是 Markdown 和轻量元数据如 agents/openai.yaml没有任何可执行脚本、网络调用或密钥你可以放心逐行阅读。常见问题FAQQguard 会替代 linter 或 CI 吗不会。它不做机械校验而是补上判断层——项目工具负责格式与类型guard 负责代码质量判断和 AI 特有的失败模式。Qguard 模式会拦住提交吗不会硬性阻断。它执行后如实汇报修了什么、留了什么最终是否合并仍由你决定。Q我的项目有自己的约定怎么办项目约定优先。guard 会先读CLAUDE.md、AGENTS.md等项目规则文件与项目规范冲突时以项目为准。小结安装npx skills add amElnagdy/guard-skills一条命令模式Guard-pass写完再查推荐、Live边写边查、Review只评不改触发一句Use $xxx-guard on the diff you just produced即可让 AI 在提交前自动过一遍质量门禁配套5 个技能覆盖代码、测试、文档、WordPress 与 WooCommerce按需组合使用。从此AI 写 → guard 查 → 人来合让质量门禁成为提交前的标准动作。️赞分享【免费下载链接】guard-skillsGuard skills for coding agents, quality gates that catch AI-generated failure modes in code, tests, and docs项目地址https://gitcode.com/gh_mirrors/gu/guard-skills点击查看免费下载相关推荐WorldX造世界提示词技巧8个一句话句式让AI世界生成一次成功WorldX造世界提示词技巧8个一句话句式让AI世界生成一次成功 WorldX 是一款一句话生成 AI 驱动世界的开源项目你输入一句话它就能生成地图、人工智能大模型AI AgentAI 应用后端前端Episode-ReName质量门禁代码提交前的自动质量检查Episode ReName质量门禁代码提交前的自动质量检查 你是否曾因提交的代码中包含低级错误而导致程序运行异常是否希望在代码提交前就能自动检测出潜在问题CLI革命性AI提示词优化器prompt-optimizer一键提升AI对话质量300%革命性AI提示词优化器prompt optimizer一键提升AI对话质量300% 你还在为AI回复质量参差不齐而烦恼还在手动调整提示词却收效甚微本文将带人工智能大模型提示工程AI 应用AI 评测创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
