Skill 一多,新问题就不是「怎么改」,而是「谁有权改、改坏了找谁」,尤其团队的Skill管理尤其重要 。这篇文章讲治理。工具很少,规矩很多——而且这些规矩,你们仓库里其实已经有一半雏形了。

前言

一句话:让 Skill 需要治理管理工程化规范。

开场:CI 挂了,没人知道该找谁

Skill 一多,新问题就不是「怎么改」,而是「谁有权改、改坏了找谁」,尤其团队的Skill管理尤其重要 。

典型现场:有人顺手改了触发词,PR 上 regression 红了三条。 群里问「这是谁的 Skill?」——半天没人认。 最后靠 git blame 找到人,对方说:「我以为改两句 description 不用跑 eval。」

09 篇的流水线能拦住「改坏」。拦不住的是:

•没人维护的僵尸 Skill 还挂在清单里

•draft 实验品被当成正式能力推广

•Owner 离职后,下游编排器还在调用

这篇文章讲治理。工具很少,规矩很多——而且这些规矩,你们仓库里其实已经有一半雏形了。

治理要解决的三件事

问题

做法

谁负责?

一人一 Skill,写进 .skill-meta.json

能不能给别人用?

draft → beta → stable,别混着用

什么时候扔掉?

季度盘点:无 Owner、长期不用、覆盖率崩了就归档

L4 CI 解决「别改坏」。治理解决「别散架」。要做工程质量把控,不能无序无约束。

Skill Card:一张卡片说清责任

脚手架模板里,每个 Skill 都有 .skill-meta.json。别把它当成装饰字段——它就是团队契约。

最小够用的字段:

{
"skill_name":"frontend-dev-prompt-craft",
"version":"0.1.5",
"maturity":"beta",
"owner":"nathan",
"status":"active",
"updated_at":"2026-07-03T00:00:00Z"
}

编排器再多写上下游,例如 wechat-review-pipeline 会声明子技能、toolchain。 个人 Skill 先把 owner + maturity + status 填实,比写一堆空字段有用。

Owner 到底干什么

不是挂名。三件实事:

1.改之前:写假设、跑基线(09 那套)

2.用之后:高频问题进 skill-issues.jsonl,该转 eval 就转

3.每季度:参加盘点,决定晋级还是归档

没有 Owner 的 Skill = 待退役候选。 不是立刻删,是进盘点名单。

换人怎么换

情况

建议

Owner 离职

优先让下游 Skill 的 Owner 接手;接手前跑一遍 regression

暂时没空

可加 co-owner 帮忙审 PR,但 owner 字段别偷偷改

两个 Skill 合并

新目录、新 Owner,别继承一笔糊涂账

co-owner 可以审、可以跑回归;改 SKILL.md 仍建议 Owner approve。规矩简单,执行才省事。

Inventory:团队的 Skill 资产表

你们仓库里已经有一份活的清单:skills/skills-quality/skill-inventory.md

它现在长这样(节选):

Skill

定位

当前状态

下一步

pm-md-to-openspec-pipeline

编排器

L3 ready

跑 pipeline baseline

loop-engineering

闭环工程文档

L3 ready

live eval 补跑

frontend-dev-prompt-craft

前端提示词

(见 meta)

自进化 backlog

grill-me

对抗审查

L3 ready

grill-001~006

清单不需要漂亮。需要每周还能信

更新节奏建议:

时机

做什么

新建 / 改名 Skill

当天登记

maturity 变更

当天改一行

每周 Review

扫一遍 status、Owner 是否空缺

季度 Stocktake

淘汰、晋级、换 Owner

Inventory 失效的征兆很明确:表上 20 个 Skill,真正有人用的不到 5 个,还没人敢删。

发布阶梯:draft / beta / stable

别「写完 SKILL.md 就算发布」。三级就够:

级别

什么意思

最低条件

draft

个人实验

有 SKILL.md;不保证稳定

beta

可以给同事试用

eval 覆盖够用;有 baseline 记录

stable

团队正式依赖

CI / 回归门禁能拦住 high;连续一段时间没被自己改崩

升级不是仪式,是证据:

draft → beta
  补 eval(至少盖住 high 风险场景)
  跑通一次 baseline,写入 results.tsv
  Owner 在 Review 里点头

beta → stable
  回归门禁接入(至少 high risk 必阻)
  一段时间里改动都过得了棘轮
  Inventory 与 .skill-meta.json 同步改 maturity

降级也要敢做:

•stable 连续被 regression 打脸 → 先降回 beta,修完再升

•beta 长期没人用、也没人补 eval → 降 draft 或直接进淘汰候选

draft 被误用是团队推广期最高频事故。解法很土:在 Inventory 和触发说明里写清楚「draft,勿当正式能力」;稳定前不要写进编排器默认路径。

季度 Stocktake:盘点,不是开会表演

议程可以短:

1.Inventory 汇览:active / deprecated / archived 各多少

2.淘汰候选:无 Owner、长期无调用、覆盖率崩了的

3.晋级候选:beta 里证据够的升 stable

4.Owner 交接

5.下季度只定 3 个目标(别定 15 个)

淘汰规则不必精确到算法,但要有默认值,例如:

条件

动作

无 Owner,且很久没人用

deprecated → 观察期 → archived

有 Owner,但 high regression 反复挂

警告 + 修复计划;再挂就降级

纯实验、已有替代 Skill

直接 archived,仓库保留历史

archived 不是删除。 目录留着,Inventory 移出「在用」区。以后要考古,git 还在。

盘点输出三样就够:stocktake-summary-Qx.md、更新后的 Inventory、各 Skill 的 meta。

一个更老实的推广预期

旧稿里写过「90 天 15 个 stable」。当激励可以,当承诺容易打脸。

更贴近真实仓库的节奏是:

阶段

大概在干什么

更现实的产出

前 30 天

把正在用的 Skill 补 meta + inventory

3~5 个 beta,Owner 齐

30~60 天

1~2 个接回归门禁

出现第一个 stable

60~90 天

自进化跑通 1 个案例 + 清僵尸

stable 缓慢增加,而不是冲数量

你们现在的 inventory 里,大量是 L3 ready——有 eval、能跑 baseline。 这已经比「文件夹里一堆 SKILL.md」强一个数量级。 治理的下一步不是堆 Skill,而是:把 L3 里真正高频的那几个,推到有门禁的 beta/stable。

新人改 Skill 的默认路径

写进团队约定,比写进文章更有用:

提 PR
  → Owner(或 co-owner)review
  → 改动触及 Skill 目录则跑 grade_evals / check_regression
  → 过了再合
  → 合入后改 CHANGELOG + meta.updated_at

「我只改了一句 description」——也算改动。触发词一变,误触发成本是全团队的。

这个对于内容文本创作者,或者AI改文章,改资讯信息的来说,改动Skill之后,会存在AI改文章之后的产物会很奇怪,有时候发现AI改文章之后的产物跟之前的一样,有时候发现改的面目全非。

读完先做这三件

1.打开 skills-quality/skill-inventory.md,给每个在用 Skill 补上(或核对)Owner

2.扫一遍 .skill-meta.json 的 maturity,draft / beta / stable 别再混用

3.约一次 45 分钟盘点:只决定「淘汰谁、谁升 beta、谁缺 Owner」

总结

本篇只记住三件事:

1.一人一 Skill:Owner 写进 .skill-meta.json;没人认领的,进退役候选,而不是继续躺在清单里装活跃。

2.draft / beta / stable 分开用:实验品别当正式能力推广;升级靠证据(eval、基线、门禁),降级也要敢做。

3.季度盘点清僵尸:Inventory 要能信;治理的目标不是堆数量,而是把高频 L3 推到有门禁的 beta/stable。

有计划有规律的进行把控Skill ,适合团队 Skill 治理,如果是存粹的个人Skill 治理,我认为也是需要这样的。

这个只是我认为的Skill 治理方法论。

也非常适合工程化管理团队/个人 Skill。

Logo

中国智能体开发者社区,聚焦智能体与大模型开发,提供前沿资讯、实用工具链、开源项目及行业案例。通过技术沙龙、开发者大赛等活动,促进经验交流与协作,助力开发者快速构建创新智能应用。

更多推荐