SuperAPI AI 工具集

coach

智能体与模型

查看项目

更新于 10-16 01:35

技能介绍

用途:Coach 让 Claude 从使用摩擦中学习并逐步改进。它检测学习机会(用户纠正、重复指令、工具失败、语气升级等),提取可执行的改进候选,并提出需用户明确批准才生效的变更。核心原则:不静默写入,所有改进都需通过 /coach approve 由用户批准。

激活触发:用户纠正(如 no、stop、don't)、重复指令、工具或命令失败、语气升级(全大写、!!!)、技能补充(also remember...)、弃用工具警告、显式 /coach 命令或会话结束。

信号类别(按优先级):COMMAND_FAILURE(最高,非零退出、stderr 模式)、USER_CORRECTION(高)、SKILL_SUPPLEMENT(高)、VERSION_ISSUE(中高,弃用或过时警告)、REPETITION(中,语义相似的指令重复)、TONE_ESCALATION(低,沮丧指标)。

候选类型:rule(稳定约束)、checklist(工作流步骤)、snippet(可重复命令)、skill(技能更新建议)、antipattern(绝不要做的事)。

工作流:检测——钩子捕获事件到 ~/.claude-coach/events.sqlite;生成——将信号聚合为提案(指纹去重);范围——按路径或语言区分项目与全局;审查——/coach review 批准、拒绝或编辑;应用——已批准规则写入 ~/.claude/CLAUDE.md(全局)或仓库 AGENTS.md(项目);回顾——/coach retro 将人工工作映射到技能缺口,在源仓库开 PR。

文件位置:~/.claude-coach/ 下有 events.sqlite、candidates.json、ledger.sqlite;全局规则目标为 ~/.claude/CLAUDE.md,项目规则目标为 <repo>/AGENTS.md;~/.claude/ 或 <repo>/.claude/ 下有 checklists/ 和 snippets/。

脚本:init_coach.py 初始化、detect_signals.py 检测摩擦、aggregate.py 生成候选、skill_analyzer.py 分析技能与过时工具、apply.py 应用已批准提案。插件路径为 ${CLAUDE_PLUGIN_ROOT}/skills/coach/scripts/。

主动命令:/coach scan 检查过时 CLI 工具与依赖;/coach retro 做会话回顾,分析人工工作并创建 PR 从源头改进技能。

范围与限制:Coach 负责会话内实时信号与 /coach 命令,retro 负责会话结束与跨会话分析及技能 PR 路由,二者职责重叠、是否合并尚未决定。详细架构、模式与模式见 references/ 目录。(简介内未提供收费、价格与平台信息。)