skill-os-complete
stillness990/skill-os-complete
Claude Code 自动技能路由系统:通过 Hook 自动分析用户输入,匹配关键词注入对应技能。内置 5 个技能:echo、summarize、code_assistant、sop、debug_log。
Instalação
npx convez-ai stillness990/skill-os-complete1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
skill-os-complete
Claude Code 自动技能路由系统 — 零延迟、纯本地、关键字驱动的技能自动注入引擎。
在 Claude Code 中输入文字时,Hook 自动分析内容并注入对应技能指令,让 Claude 按预定义规范回答。无需切换模式、无需手动选择技能。
工作原理
你在 Claude Code 中输入文字
↓
UserPromptSubmit Hook 触发
↓
skill-router.py 读取输入 → 对照 skill-rules.json 打分
↓
选中得分最高的技能 → 自动注入 SKILL.md 规范
↓
Claude 按规范回答(无命中则正常对话)
完整工作流
用户模糊想法
↓
ask(需求澄清,最多3个问题)
↓
planner(生成结构化执行计划)
↓
task_manager(任务状态追踪:下一步/进度/完成)
↓
code_assistant / sop(执行编码或生成操作手册)
↓
reviewer(代码审查:只给意见,不改代码)
↓
changelog(自动生成变更日志)
↓
debug_log(排查记录留档)
快速安装
# 1. 克隆项目
git clone https://github.com/stillness990/skill-os-complete.git
# 2. 进入你的项目目录
cd /path/to/your-project
# 3. 运行安装脚本
bash /path/to/skill-os-complete/install.sh
安装脚本自动完成:
- 复制
.claude/到项目目录 - 设置执行权限
- 验证 JSON 格式
- 运行 12 项路由测试
内置技能(11 个)
| 技能 | 优先级 | 触发方式 | 作用 |
|---|---|---|---|
ask | 1 | 我想做、有个想法、准备做、想实现 | 需求澄清:最多3个关键问题,确认后进入 planner |
echo | 1 | echo xxx、重复、原样 | 原样返回输入,调试验证 |
summarize | 2 | 总结、摘要、概括、summarize | 提炼 3~7 条核心要点 + 一句话总结 |
planner | 2 | 计划、规划、方案、怎么搞、roadmap | 生成结构化执行计划,只规划不执行 |
task_manager | 2 | 下一步、当前进度、任务状态、做完了 | 读写 task.json,追踪任务执行状态 |
code_assistant | 3 | debug、bug、修复、实现、报错 | 结构化输出:问题分析 → 代码 → 说明 |
sop | 2 | 写手册、怎么处理、SOP、操作手册 | 生成标准操作步骤(步骤 + 预期 + 分支) |
debug_log | 2 | 解决了、留档、排查记录 | 自动生成 debug-logs/ 目录 + .md 文件 |
sanitize | 2 | 脱敏、消毒、sanitize、安全发布 | 扫描替换敏感信息 + 一键发布到 GitHub |
reviewer | 2 | review、代码审查、看看这段代码 | 检查代码质量/Bug/安全,只给意见不改代码 |
changelog | 2 | changelog、更新日志、版本说明 | 按 Added/Changed/Fixed 生成发布日志 |
使用方式
触发技能
输入中自然包含关键词即可,无需特殊前缀:
| 你想做的事 | 这样说 |
|---|---|
| 需求澄清 | 我想做一个用户登录系统,帮我想想 |
| 原样输出 | echo 这段配置内容原样输出 |
| 总结文章 | 总结一下这篇文章的核心内容 |
| 出执行计划 | 帮我规划一下怎么把单体服务拆成微服务 |
| 任务进度 | 下一步做什么 / 当前进度怎么样了 |
| 修复代码 | 帮我 debug 这段代码,一直报 KeyError |
| 写操作手册 | 数据库连接失败怎么处理,帮我写操作手册 |
| debug 留档 | 问题解决了,帮我记录这次排查过程留档 |
| 项目脱敏 | 帮我对这个项目做脱敏处理,准备发布 |
| 代码审查 | 帮我 review 一下这段代码有没有问题 |
| 变更日志 | 生成这次的更新日志 |
| 正常聊天 | 今天天气怎么样(不触发任何技能) |
验证系统正常
依次输入以下 11 句话,确认各自触发正确技能:
我想做一个用户登录系统→ ask(需求澄清)echo 测试→ echo(原样返回)帮我规划一下怎么给项目加缓存→ planner(执行计划)下一步做什么→ task_manager(任务追踪)总结一下今天的对话→ summarize(要点格式)帮我 debug 这段代码→ code_assistant(结构化回答)帮我写一份数据库备份的操作手册→ sop(SOP 格式)问题解决了,帮我记录排查过程→ debug_log(生成文件)帮我对这个项目做脱敏处理→ sanitize(脱敏格式)帮我 review 一下这段代码→ reviewer(代码审查)生成这次更新的 changelog→ changelog(变更日志)
添加新技能
第一步:创建技能定义
mkdir -p .claude/skills/<新技能名>
创建 .claude/skills/<新技能名>/SKILL.md:
---
name: <技能名>
description: "<一句话描述>"
---
# <技能名> Skill
## 用途
…
## 行为规则
- …
- …
## 输出格式
…
参考模板:.claude/skills/sop/SKILL.md
第二步:注册路由规则
打开 .claude/skill-rules.json,在 "skills" 对象中添加:
"<新技能名>": {
"priority": 2,
"keywords": ["关键词1", "关键词2"],
"intentPatterns": [
"(正则模式1)"
]
}
第三步:验证并测试
# 验证 JSON 格式
python3 -c "import json; json.load(open('.claude/skill-rules.json'))"
# 测试路由
echo '{"prompt": "你的测试输入"}' \
| CLAUDE_PROJECT_DIR="$(pwd)" python3 .claude/hooks/skill-router.py
不需要重启 Claude Code,保存文件立即生效。
打分规则
| 匹配方式 | 得分 | 说明 |
|---|---|---|
| 基础优先级 | priority 字段值 | 仅兜底,不算命中 |
| 关键词命中 | 每个 +2 | keywords 列表匹配 |
| 正则命中 | 每个 +3 | intentPatterns 列表匹配 |
必须有关键词或正则命中(得分 > 基础分),技能才会触发。
故障排查
技能完全不触发
echo '{"prompt": "帮我 debug 这段代码"}' \
| CLAUDE_PROJECT_DIR="$(pwd)" python3 .claude/hooks/skill-router.py
预期输出中包含 "code_assistant" 和 "prompt_injection"。
如果输出 {},逐项检查:
| 检查项 | 命令 | 预期 |
|---|---|---|
| skill-rules.json 存在 | ls .claude/skill-rules.json | 文件存在 |
| JSON 格式正确 | python3 -c "import json; json.load(open('.claude/skill-rules.json')); print('OK')" | OK |
| python3 可用 | which python3 | 路径非空 |
| 输入包含关键词 | 检查 skill-rules.json 的 keywords | 至少命中一个 |
多个技能竞争选错了
echo '{"prompt": "你的原话"}' \
| CLAUDE_PROJECT_DIR="$(pwd)" python3 .claude/hooks/skill-router.py
处理方法:
- A:给期望技能加独特关键词
- B:降低冲突技能的
priority - C:给期望技能加精准的
intentPatterns正则
误触发(不该触发时触发了)
找到被误触发的技能,检查 keywords 列表。删除过于宽泛的关键词,改用更精确的正则。
JSON 格式损坏
python3 -c "import json; json.load(open('.claude/settings.json'))"
根据报错行号修正。如果完全损坏,从备份恢复:
ls .claude/backups/
cp .claude/backups/<最新备份> .claude/settings.json
常见错误速查
| 现象 | 原因 | 处理 |
|---|---|---|
技能不触发,输出 {} | 输入未匹配任何关键词 | 检查输入是否包含 skill-rules.json 中的关键词 |
settings.json 报错 | JSON 格式损坏 | python3 -c "import json; json.load(...)" 定位语法错误 |
skill-router.py 报 No such file | Hook 路径不对 | 确认 UserPromptSubmit 中 command 正确 |
| 新增技能不生效 | 文件名或路径不对 | 确认目录名与 skill-rules.json 的 key 一致 |
| QQ 通知 Hook 丢失 | 修改 settings.json 时覆盖了原有 hooks | 检查 UserPromptSubmit 中是否保留了 QQ 通知 hook |
备份与恢复
settings.json 有自动备份:
ls .claude/backups/
恢复:
cp .claude/backups/.claude.json.backup.<最新时间戳> .claude/settings.json
回滚/卸载
仅禁用技能路由: 删除 UserPromptSubmit 中 skill-router 对应的 hook。
完全移除:
rm .claude/skill-rules.json
rm .claude/hooks/skill-router.py
rm -rf .claude/skills
然后手动编辑 settings.json,移除 skill-router 对应的 hook 条目。
项目结构
skill-os-complete/
├── CLAUDE.md # 项目说明
├── install.sh # 一键安装脚本(12项路由测试)
├── README.md # 本文件
└── .claude/
├── settings.json # Hook 注册入口
├── skill-rules.json # 路由关键词规则(11个技能)
├── hooks/
│ └── skill-router.py # 自动路由脚本
└── skills/
├── ask/SKILL.md # 需求澄清
├── echo/SKILL.md # 原样返回
├── summarize/SKILL.md # 总结摘要
├── planner/SKILL.md # 计划生成
├── task_manager/SKILL.md # 任务追踪
├── code_assistant/SKILL.md # 代码助手
├── sop/SKILL.md # 操作手册
├── debug_log/SKILL.md # 排查记录
├── sanitize/
│ ├── SKILL.md # 脱敏技能
│ └── sanitize.py # 脱敏扫描与发布脚本
├── reviewer/SKILL.md # 代码审查
└── changelog/SKILL.md # 变更日志
License
MIT