convez.ai
Skill
stillness990

skill-os-complete

stillness990/skill-os-complete

Ver no GitHub
InicialPluginScore · de 0 a 100

Claude Code 自动技能路由系统:通过 Hook 自动分析用户输入,匹配关键词注入对应技能。内置 5 个技能:echo、summarize、code_assistant、sop、debug_log。

Instalação

$npx convez-ai stillness990/skill-os-complete

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 个)

技能优先级触发方式作用
ask1我想做、有个想法、准备做、想实现需求澄清:最多3个关键问题,确认后进入 planner
echo1echo xxx、重复、原样原样返回输入,调试验证
summarize2总结、摘要、概括、summarize提炼 3~7 条核心要点 + 一句话总结
planner2计划、规划、方案、怎么搞、roadmap生成结构化执行计划,只规划不执行
task_manager2下一步、当前进度、任务状态、做完了读写 task.json,追踪任务执行状态
code_assistant3debug、bug、修复、实现、报错结构化输出:问题分析 → 代码 → 说明
sop2写手册、怎么处理、SOP、操作手册生成标准操作步骤(步骤 + 预期 + 分支)
debug_log2解决了、留档、排查记录自动生成 debug-logs/ 目录 + .md 文件
sanitize2脱敏、消毒、sanitize、安全发布扫描替换敏感信息 + 一键发布到 GitHub
reviewer2review、代码审查、看看这段代码检查代码质量/Bug/安全,只给意见不改代码
changelog2changelog、更新日志、版本说明按 Added/Changed/Fixed 生成发布日志

使用方式

触发技能

输入中自然包含关键词即可,无需特殊前缀:

你想做的事这样说
需求澄清我想做一个用户登录系统,帮我想想
原样输出echo 这段配置内容原样输出
总结文章总结一下这篇文章的核心内容
出执行计划帮我规划一下怎么把单体服务拆成微服务
任务进度下一步做什么 / 当前进度怎么样了
修复代码帮我 debug 这段代码,一直报 KeyError
写操作手册数据库连接失败怎么处理,帮我写操作手册
debug 留档问题解决了,帮我记录这次排查过程留档
项目脱敏帮我对这个项目做脱敏处理,准备发布
代码审查帮我 review 一下这段代码有没有问题
变更日志生成这次的更新日志
正常聊天今天天气怎么样(不触发任何技能)

验证系统正常

依次输入以下 11 句话,确认各自触发正确技能:

  1. 我想做一个用户登录系统 → ask(需求澄清)
  2. echo 测试 → echo(原样返回)
  3. 帮我规划一下怎么给项目加缓存 → planner(执行计划)
  4. 下一步做什么 → task_manager(任务追踪)
  5. 总结一下今天的对话 → summarize(要点格式)
  6. 帮我 debug 这段代码 → code_assistant(结构化回答)
  7. 帮我写一份数据库备份的操作手册 → sop(SOP 格式)
  8. 问题解决了,帮我记录排查过程 → debug_log(生成文件)
  9. 帮我对这个项目做脱敏处理 → sanitize(脱敏格式)
  10. 帮我 review 一下这段代码 → reviewer(代码审查)
  11. 生成这次更新的 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 字段值仅兜底,不算命中
关键词命中每个 +2keywords 列表匹配
正则命中每个 +3intentPatterns 列表匹配

必须有关键词或正则命中(得分 > 基础分),技能才会触发。

故障排查

技能完全不触发

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 fileHook 路径不对确认 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

Ver o original no GitHub

Bom para

Relacionados