mcpField
C
coach

coach

github.com/netresearchAgent 工作流1383 次安装11 周前更新
代码仓库

关于 coach

Coach 是一项 Claude 技能，可检测用户纠正、重复指令和工具失败等摩擦，并提出可复用的改进建议。所有更改都需明确批准后才会应用。

主要功能

  1. 01检测用户纠正和重复指令
  2. 02记录工具失败等摩擦信号
  3. 03生成去重后的改进建议
  4. 04审查并批准建议更改
  5. 05将已批准规则应用到项目或全局文件

适用场景

  1. 01将反复出现的纠正转为项目规则
  2. 02在工具失败后审查改进建议
  3. 03查找过时的 CLI 工具和依赖
  4. 04从手动工作中识别技能缺口

安装

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

$npx skills add https://github.com/netresearch/claude-coach-plugin --skill coach

安装后在 Claude Code 中输入/coach确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
architecture.md
schema.md
scope_heuristics.md
signal_patterns.md
scripts/
aggregate.py
apply.py
detect_signals.py
fingerprint.py
hook_healer.py
init_coach.py
ledger.py
propose.py
root_cause_analyzer.py
scope_analyzer.py
skill_analyzer.py
scripts/tests/
test_process_violation_clustering.py

详细介绍

Coach - 自我改进学习系统

Coach 让 Claude 能够从遇到的阻碍中学习并不断改进。它会检测学习机会（用户纠正、重复指示、工具故障、语气升级），提取可执行的改进候选项，并提出需要用户明确批准的更改。

核心原则：绝不静默写入。所有改进都必须通过 /coach approve 获得用户批准。

激活触发条件

出现以下情况时激活：用户纠正（“不”“停下”“不要”）、重复指示、工具／命令故障、语气升级（全大写、“！！！”）、技能补充（“还要记住……”）、弃用工具警告、显式 /coach 命令或会话结束。

信号类别（按优先级排序）

  1. COMMAND_FAILURE（最高）— 非零退出码、stderr 模式
  2. USER_CORRECTION（高）— 明确的纠正措辞
  3. SKILL_SUPPLEMENT（高）— 对某项技能的补充指导
  4. VERSION_ISSUE（中高）— 弃用／过时警告
  5. REPETITION（中）— 语义相似的指示被重复提出
  6. TONE_ESCALATION（低）— 受挫迹象

候选项类型

类型说明示例
rule稳定约束“绝不编辑生成的文件”
checklist工作流步骤“代码更改后运行测试”
snippet可重复执行的命令“预检脚本”
skill技能更新建议“将 X 指导添加到 Y 技能”
antipattern绝对不要做的事“绝不假设工具存在”

工作流摘要

  1. 检测 — 钩子捕获事件 → ~/.claude-coach/events.sqlite
  2. 生成 — 将信号汇总为提案（通过指纹去重）
  3. 范围 — 根据路径／语言确定项目级或全局级
  4. 审核 — /coach review 批准／拒绝／编辑提案
  5. 应用 — 已批准的规则 → ~/.claude/CLAUDE.md（全局）或仓库中的 AGENTS.md（项目级）
  6. 回顾 — /coach retro 将手动工作映射到技能缺口，并在源代码仓库中创建 PR

文件位置

~/.claude-coach/
├── events.sqlite      # Raw friction events
├── candidates.json    # Pending proposals
└── ledger.sqlite      # Cross-repo fingerprints

~/.claude/CLAUDE.md     # Global rules destination
<repo>/AGENTS.md        # Project rules destination

~/.claude/ or <repo>/.claude/
├── checklists/        # Workflow checklists
└── snippets/          # Reusable commands

范围

Coach：会话期间的实时信号 — events.sqlite 捕获、/coach 命令。 retro：会话结束时／跨会话分析、技能 PR 路由。/coach retro 的功能与 retro 重叠；是否合并仍未决定。

脚本

scripts/（此目录）— 适用于技能目录安装的独立脚本。插件路径： ${CLAUDE_PLUGIN_ROOT}/skills/coach/scripts/：

脚本用途
init_coach.py初始化 Coach 系统
detect_signals.py检测阻碍模式
aggregate.py将信号转化为候选项
skill_analyzer.py分析技能并扫描过时工具
apply.py应用已批准的提案

主动命令

  • /coach scan — 检查是否存在过时的 CLI 工具和依赖项
  • /coach retro — 会话回顾：分析手动工作，并创建 PR 以改进源代码中的技能

详细架构、架构定义和模式请参阅 references/ 目录。

评论

支持 Markdown