
Claude Code Harness 技能路由规则详解AI 如何一句话选中正确的 Skill【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harnessClaude Code Harness 是一个专为 Claude Code 打造的开发套具Development Harness它通过Plan → Work → Review的自主循环实现高质量开发。而这套循环能否顺畅运转关键就在于技能路由规则Skill Routing Rules——当你只说帮我实现这个功能这样一句话时AI 如何从 21 个技能中准确选中harness-work而不是误触发harness-plan或harness-review本文带你完整看懂这套路由机制的底层设计。为什么 AI 需要路由规则Claude Code Harness 把工作流拆成了 5 个核心动词技能5 Core Verbsplan计划、work实现、review审查、sync同步、release发布外加 16 个辅助技能共 21 个。技能越多选错的风险就越大。想象这样一个尴尬场景你说review this PR结果 AI 加载了harness-setup开始给你初始化项目……这就是路由失败。Claude Code Harness 的解决方案是把路由规则写进每个技能自己的自我介绍里让 AI 依据关键词做确定性判定而不是靠猜上下文。完整技能清单可以在 docs/CLAUDE-skill-catalog.md 中查阅。SSOT 设计description 字段就是路由的唯一权威这是整个路由系统最重要的设计理念。在 skills/routing-rules.md 中明确写道SSOT 的位置每个技能的description字段就是路由的 SSOTSingle Source of Truth唯一事实来源。翻译成人话每个技能的自我介绍description既是给它自己的说明书也是给路由器的匹配规则。路由器不依赖任何隐藏配置只认 description 里写明的两类词字段作用示例harness-reviewTrigger触发关键词命中则加载该技能review、code review、plan review、scope analysisDo NOT Load For排除关键词命中则绝对不加载implementation、new features、bugfix、setup、release打开任意一个技能的 SKILL.mdfrontmatter 里都能看到这种格式description: HAR: Multi-angle code, plan, scope review. Trigger: review, code review, plan review, scope analysis. Do NOT load for: implementation, new features, bugfix, setup, release.注意一个工程纪律description 里的排除词与正文中的 Do NOT Load For 表格必须完全一致——这是 skills/routing-rules.md 中的硬性更新规则防止文档说一套、实际匹配另一套的漂移。路由判定流程三步决策无歧义当你的输入进入 Claude Code 时路由判定按以下流程执行摘自 skills/routing-rules.md用户输入 │ ├── 命中某个技能 description 的触发关键词 → 加载该技能 ├── 命中某个技能的排除关键词 → 该技能被排除 └── 都没命中 → 走常规技能匹配如果一句话同时匹配了多个技能有两条优先级规则排除最优先命中排除关键词的技能绝对不加载一票否决具体词优先完全匹配 部分匹配。项目还刻意放弃了上下文判定——因为看情况而定会带来歧义和不可复现的行为。description 里的关键词决定一切这让路由结果可预测、可测试。实战示例一句话如何命中正确技能docs/bootstrap-routing-contract.md 中维护了一份黄金提示词Golden Prompts对照表覆盖中英文输入是理解路由最直观的材料你说的一句话路由到的技能为什么Todoアプリを作って / build a todo appharness-plan命中create a plan / build意图先规划再动手実装して / work on thisharness-work命中implement, execute触发词全部やって / breezing allbreezing命中breezing, do everything触发词启动团队并行执行レビューして / review this PRharness-review命中review, code review触发词進捗確認 / sync statusharness-sync命中sync-status, where am I触发词セットアップして / setup harnessharness-setup命中setup, init触发词再看一个排除词发挥作用的例子你说帮我 review 这个 bug fix——bug fix 命中harness-review的排除词bugfix但review 命中其触发词此时完全匹配优先于排除加载harness-review而harness-work因review命中其排除词被一票否决。整个过程无歧义。各技能的触发/排除关键词原文可以直接查看skills/harness-plan/SKILL.mdskills/harness-work/SKILL.mdskills/breezing/SKILL.mdskills/harness-sync/SKILL.md这套规则如何被验收路由规则不是写完就算数项目用测试把它钉死tests/test-bootstrap-skill-trigger-acceptance.sh校验各宿主Claude Code / Codex / OpenCode 等的启动路由配置完整tests/test-skill-trigger-telemetry.sh技能触发遥测检查scripts/skill-trigger-telemetry.sh触发记录采集脚本。配合Golden Prompts 只是静态契约夹具、不代表运行时自动路由永远成功的诚实声明见 docs/bootstrap-routing-contract.md 的Purpose一节这套机制做到了声明、文档、测试三者一致——新手照着文档写技能就不会和 AI 的实际行为打架。给你的 3 条实操建议写新技能时先写 description。把 Trigger 和 Do NOT Load For 关键词直接写进 frontmatter 的 description 字段正文表格保持同步关键词要具体。skills/routing-rules.md 明确要求不用泛用表达如〜全般逐一列举具体关键词——模糊词是路由错误的温床用排除词划清技能边界。相邻技能互相把对方的核心动词写进排除词如 plan 排除implementationwork 排除planning冲突自然消失。技能编写的完整模板见 docs/rules/skill-editing-templates.md路由细节可对照 skills/routing-rules.md 原文。小结一句话路由靠的是确定性Claude Code Harness 的技能路由规则本质上是一次对 AI 行为去模糊化的工程实践description 字段即 SSOT触发词决定加载、排除词一票否决完全匹配压过部分匹配。你不需要学习任何新语法一句自然的帮我实现、review 一下、同步进度就能被精确路由到正确的技能上——这也是 Plan → Work → Review 循环能够全自动跑起来的地基。【免费下载链接】claude-code-harnessClaude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-harness创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考