skill coach:给 AI skill 定方向和做评审

前言

写一个 AI skill,最难的不是把它跑起来,而是动工之前不知道该做成什么样,收工之后不知道该不该上线。description 写得宽,agent 什么任务都来触发;写得窄,真正该用的时候又不进来。评审这类东西时,也没有一个稳定的说法,往往凭感觉改两行就交差。

skill coach 把这件事拆成一套五步法:事前给方向,事后查好坏。判断结果落到三种之一——可以放心用、先修再用、干脆别要。

这是什么

skill coach 是一个面向 AI skill 的设计与评审技能,坐标 @user_dc515faf/skillcoach,由社区开发者 user_dc515faf 发布并维护,当前版本 1.0.1,分类 ai-agent。

它只做一件事:围绕 skill 本身给方向、做审查、做优化。技能基于通用 SKILL.md 格式,不依赖额外的 API key(标签 requires_api_key=false)。在 SkillHub 上评分为 100000,下载 1120 次,安装数显示为 0。

核心功能

支撑这套方法的是 R-V-C-E 心智模型,按顺序走四步:风险(Risk)→ 价值(Value)→ 工艺(Craft)→ 证据(Evidence)。风险预判这件事该不该存在,价值判断它解决什么问题,工艺决定触发边界画在哪、确定性靠什么,证据回答怎么验证它真的有效。

它提供两种模式,对应事前和事后两个阶段。

1、设计模式。用于用户想新建一个 skill、或者问”这个 skill 该怎么设计 / 怎么做 / 做成什么样”时。做法是像产品经理一样用 R-V-C-E 反向给设计方向:先做风险预判,判断这个 skill 该不该存在;再画触发边界,明确什么任务进来、什么任务不进来;然后确定确定性靠什么保证;最后定怎么验证。产出的是可执行的设计方案,不是笼统的建议。

2、评审模式。用于评审、检查已有 skill 好不好的时候。包括优化 description 或触发条件、判断该不该上线或合并、分析 skill 之间会不会互相抢触发,以及回答”这个 skill 写得怎么样 / 能不能用 / 有什么问题”。

触发方式支持中英文混合的自然表达,常见触发词包括:做一个 skill、这个 skill 该怎么设计、新建 skill、审查 skill、评审 skill、检查 skill、优化 skill、skill 质量、skill review、这个 skill 好不好、skill 该不该上、skill 触发不准、skill 互相抢。

安装与启用

skill coach 是标准 SKILL.md 格式的技能,本地启用把技能目录放进项目的 skill 目录,由 agent 在会话中按触发词自动调用即可。例如 Cursor 放在 .cursor/skills/,Claude Code 放在 .claude/skills/,Codex CLI 按其技能目录约定放置;安装后在会话里直接说”做一个 skill”或”评审这个 skill”即可唤起。

它不需要配置 API key,也没有额外的环境变量要填。

典型用法

下面三个例子都来自技能自身的触发词约定,可以直接复现。

新建 skill 前先要方向:

我想做一个把 PDF 表格抽成 Excel 的 skill,这个 skill 该怎么设计?

skill coach 会进入设计模式,按 R-V-C-E 先判风险(该不该存在、会不会和已有 skill 抢任务),再定触发边界,最后给出验证方式。

写完之后做质量把关:

审查这个 skill,看看触发条件准不准

此时进入评审模式,检查 description 的触发表述、确定性来源和验证证据,结论会落在”放心用 / 先修再用 / 干脆别要”之一。

排查多个 skill 互相干扰:

我的几个 skill 之间会不会互相抢触发?

这类问题直接指向评审模式中的触发冲突分析,适合在上线或合并之前做一遍。

适用场景与注意

适合两类人。一是正在新建 skill、卡在设计阶段拿不准方向的开发者;二是手上已有 skill、准备上线或合并、想先做一遍质量检查的人。

有几条边界要留意。

第一,如果对”要做什么”本身还没想清楚,先不要急着上 R-V-C-E。技能自身给出的衔接方式是:先用 grill 理清需求,再用本技能给设计方向。

第二,明确不要用它处理这些场景:与 skill 无关的普通编码和调试,应该用 debug-session;与 skill 无关的产品或流程设计,应该用 grill;不涉及”某个 skill 该怎么做或好不好”的一般问答,也不适合。它只评价 skill,不代替调试和需求梳理。

第三,评审结论分三档,其中”干脆别要”是有意识的输出,不是失败。如果 R 阶段判断风险过高、价值不成立,正确做法是不做,而不是勉强上线再修补。

结尾

skill coach 的价值在于把 skill 的设计和评审从凭感觉变成一套可复用的四步判断:风险、价值、工艺、证据。事前用它定方向,事后用它查好坏,两种情况下都能拿到明确结论。

官方地址:https://api.skillhub.cn/user_dc515faf/skillcoach,SkillHub 页面:https://www.skillhub.cn/skills/user_dc515faf/skillcoach。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜