mcpField
A
auto-skill-guide

auto-skill-guide

github.com/matrixyAgent 工作流2842 次安装20 周前更新
代码仓库

关于 auto-skill-guide

auto-skill-guide 是面向编码 Agent 的插件和命令行工具，可检测会话中重复的工具流程，并将获批模式整理为可复用技能。它还支持在会话进行中发现和加载生成的技能。

主要功能

  1. 01检测重复工具序列
  2. 02从获批模式生成技能
  3. 03在会话中途加载技能
  4. 04审核模式并查看诊断
  5. 05数据存储在本地

适用场景

  1. 01将重复编码步骤转为技能
  2. 02在任务中加载相关技能
  3. 03审核检测到的工作流模式

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/matrixy/auto-skill --skill auto-skill-guide

安装后在 Claude Code 中输入/auto-skill-guide确认已加载。

附带文件install-cli.sh

详细介绍

Auto-Skill 插件

此插件会自动检测编码 Agent 会话中的工作流模式，生成可复用的技能，并可在会话进行期间动态加载。

CLI 工具安装

Agent 技能现已安装，但若要使用 auto-skill init、auto-skill discover 等 CLI 命令，需要安装 npm 软件包。

快速安装：

# Option 1: Run the included install script
bash ~/.agents/skills/auto-skill-guide/install-cli.sh

# Option 2: Install globally via npm
npm install -g @matrixy/auto-skill

# Option 3: Use without installing (via npx)
npx @matrixy/auto-skill init

验证： auto-skill version

工作原理

Session 1: Grep → Read → Edit    ─┐
Session 2: Grep → Read → Edit     ├──▶ Pattern Detected → SKILL.md
Session 3: Grep → Read → Edit    ─┘
  1. 观察：通过 PostToolUse hook 记录每次工具调用
  2. 检测：分析模式是否重复出现（3 次或以上）
  3. 生成：经批准的模式会生成带有适当 frontmatter 的 SKILL.md 文件
  4. 发现：Claude 会主动为你的任务提供相关技能
  5. 加载：无需重启即可在会话进行期间加载技能

命令

/auto-skill:review

审核并批准检测到的模式：

/auto-skill:review              # List all detected patterns
/auto-skill:review preview ID   # Preview a pattern as a skill
/auto-skill:review approve ID   # Generate skill from pattern
/auto-skill:review reject ID    # Dismiss a pattern
/auto-skill:load

将生成的技能加载到当前会话：

/auto-skill:load                # List available skills
/auto-skill:load <name>         # Load specific skill immediately

通过此方式加载的技能会立即生效，无需重启会话。

/auto-skill:status

显示系统诊断信息：

/auto-skill:status              # Display stats, patterns, and config

模式检测

满足以下条件时会检测到模式：

  • 相同的工具序列在多个会话中出现 3 次或以上
  • 序列长度为 2 到 10 个工具
  • 模式在过去 7 天内出现过
置信度评分
因素权重描述
出现次数40%出现次数越多，置信度越高
长度20%3 到 5 个工具最理想
成功率25%成功的模式得分更高
最近程度15%优先考虑近期的模式
模式示例
Grep → Read → Edit        # Search, read context, make changes
Glob → Read → Write       # Find files, read, create new file
Read → Edit → Bash        # Read file, edit, run tests

动态技能加载

与标准 Claude Code 技能（在会话开始时加载）不同，自动生成的技能可通过注册表系统在会话进行期间加载。

工作原理
  1. 轻量级注册表会为所有技能编制索引（仅元数据）
  2. 脚本会按需检索并格式化技能内容
  3. 输出使用清晰的分隔符来标示生效的指令：
======================================================================
SKILL LOADED: <name>
Confidence: <score>
Allowed tools: <tools>
======================================================================

<skill instructions>

======================================================================
END OF SKILL - INSTRUCTIONS ARE NOW ACTIVE
======================================================================
主动发现

Claude 可使用 skill-discovery 技能自动发现相关技能：

  1. 用户请求一项多步骤任务
  2. Claude 搜索匹配的技能
  3. 如果找到，Claude 会询问：“要我加载此技能吗？”
  4. 用户批准 → 加载并遵循技能
CLI 命令
auto-skill discover             # Discover skill patterns
auto-skill stats                # Show adoption statistics
auto-skill graduate             # Manage skill graduation
auto-skill agents list          # List known agents
auto-skill agents detect        # Detect installed agents

若要搜索社区技能，请使用 Skills CLI：

npx skills find "query"         # Interactive search
npx skills add owner/repo       # Install skill

执行上下文

生成的技能会自动获得适当的执行设置：

模式类型上下文Agent原因
Grep → Read内联Explore只读，安全
Read → Edit → Bash分叉general-purpose会产生副作用

内联：在当前对话上下文中运行。

分叉（context: fork）：在隔离的子 Agent 中运行。适用于：

  • 会产生副作用的任务（部署、构建）
  • 不应污染对话历史记录的工作流
  • 长时间运行的操作
工具限制

生成的技能会根据模式包含 allowed-tools：

allowed-tools: Grep, Read, Edit

这可以防止范围蔓延并确保行为可预测。

生成的技能

自动生成的技能会保存到：

~/.claude/skills/auto/<skill-name>/SKILL.md

每项技能都包含：

  • 带有元数据的 YAML frontmatter
  • auto-generated: true 标志
  • 适用时包含 context: fork
  • allowed-tools 限制
  • 置信度评分和来源会话
  • 根据模式提炼出的操作步骤

配置

检测阈值（位于 ~/.claude/auto-skill.local.md 中）：

---
detection:
  min_occurrences: 3      # Minimum pattern repetitions
  min_sequence_length: 2  # Shortest pattern
  max_sequence_length: 10 # Longest pattern
  lookback_days: 7        # Analysis window
  min_confidence: 0.7     # Suggestion threshold
---

数据存储

数据位置
事件~/.claude/auto-skill/events.db
技能~/.claude/skills/auto/
跟踪~/.claude/auto-skill/skills_tracking.db

隐私

  • 所有数据都存储在本地
  • 不会向外部服务发送数据
  • 可通过 AUTO_SKILL_NO_TELEMETRY=1 或 DO_NOT_TRACK=1 禁用匿名遥测

故障排除

未检测到任何模式？

  • 同一序列需要至少出现 3 次
  • 检查回溯周期（默认：7 天）
  • 运行 /auto-skill:status 查看事件计数

技能未加载？

  • 运行 auto-skill discover 刷新
  • 检查技能是否存在于 ~/.claude/skills/auto/

钩子无法正常工作？

  • 确认插件已正确安装
  • 检查 hooks/hooks.json 配置
  • 确保 Node.js 18+ 可用

想要重置？

  • 删除 ~/.claude/auto-skill/events.db
  • 从 ~/.claude/skills/auto/ 中移除技能

评论

支持 Markdown