14 技能与能力编排

1. 为什么要“技能化”

技能（skills）把可复用方法沉淀为可调用资产，降低每次从头解释成本。

2. 团队技能目录建议

• skills/core/：通用能力（排障、代码评审、发布流程）
• skills/frontend/：UI、组件、文档站样式
• skills/backend/：API、数据库、迁移策略
• skills/ops/：部署、监控、回滚

3. 技能编写模板（建议）

• 目标：解决什么问题
• 输入：需要什么上下文
• 步骤：可执行流程
• 边界：不该做什么
• 验证：如何判断成功

4. 与 commands 的分工

• command：流程入口（触发器）
• skill：流程内专业能力（方法库）
• agent：执行角色（权限/模型策略）

5. 版本化与评审

• 技能文件必须 PR 评审
• 每个技能带变更日志（为什么改）
• 统一语义版本（例如 skill-x@1.2.0）

6. 常见反模式

• 一个技能做太多事
• 没有输入契约（导致调用方误用）
• 只有结论没有验证步骤

7. 落地建议

• 先把你们高频问题做成 5 个核心技能
• 每两周回顾一次“命中率”和“误用率”