mcpField
B
build-skill

build-skill

github.com/camachoAgent 工作流600 次安装
代码仓库

关于 build-skill

build-skill 是面向资深工程师的 Agent 技能，用于起草和验证操作型技能。它强调明确不变量、失效模式、决策边界和停止条件，避免不必要的流程。

主要功能

  1. 01判定范围与目标路径
  2. 02建立失效模式基线
  3. 03规划并审查技能
  4. 04起草并完善单一版本
  5. 05验证可发现性与文件
  6. 06适用时采用策略代数

适用场景

  1. 01根据需求起草技能
  2. 02针对 Agent 失误修订技能
  3. 03设计治理规则型技能
  4. 04审查并验证项目级技能

安装

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

$npx skills add https://github.com/camacho/ai-skills --skill build-skill

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

详细介绍

/build-skill

有意构建一份高质量的技能草稿。

此技能将技能写成操作简报，供不了解本地上下文的资深工程师使用。优先说明不变量、决策边界、证据和停止规则，而不是罗列 Shell 操作步骤或繁文缛节。

参数

参数字符串应包含：

  • 技能名称
  • 技能的作用
  • 会实质性影响设计的任何模式、命令或仓库上下文

如果请求信息不充分，请先提出一个澄清问题，再继续。

核心原则

  • 面向能力出众的资深工程师，而不是 Shell 自动机。
  • Frontmatter 描述用于帮助发现技能。应说明何时使用技能，而不是概述整个工作流。
  • 在保证质量的前提下，流程越精简越好。
  • 评审反馈应保护不变量或明确决策边界，而不是自动引入更多流程。
  • Token 效率很重要。如果某些细节很少用到，就不要放在正文中，或按需加载。

路由决策

起草前，先确定：

  • 范围：用户级还是项目级
  • 目标路径：根据范围确定的确切 SKILL.md 目标位置
  • 规则编码：此技能的主要目的是否是维护治理、策略或决策规则，而不是执行常规工作流

如果提出一个澄清问题后，其中任何一项仍不明确，请停止并升级处理。

RED 阶段

编写技能前，先建立失败基线。

以下情况必须执行基线失败演练：

  • 编辑现有技能
  • 编写用于约束规则、纪律或决策边界的技能
  • 请求是由已观察到的 Agent 失败、偏离或自我合理化所引发

对于规范明确且没有已观察失败历史的全新工作流技能，可以简化 RED 阶段：起草前至少找出一种合理的失败模式。

记录：

  • 没有此技能时会出什么问题
  • 较弱版本的技能无法防止什么问题
  • 此技能需要抵御哪些自我合理化或走捷径的行为

构建流程

  1. 了解情况

    • 提取技能名称和用途
    • 确定范围、目标路径和规则编码

  2. 隔离

    • 如果已在工作树中，则继续
    • 否则，在写入文件前使用 /isolate

  3. 设计

    • 如果初步澄清后技能形态仍不明确，则使用 /brainstorming
    • 保持简短；目标是明确，而不是进行冗长的探索

  4. 编写计划

    • 编写 ai-workspace/plans/build-skill-<name>.md
    • 包含技能规范、RED 基线、目标路径，以及此技能达到“良好”标准的定义

  5. 评审计划

    • 运行 /plan-review
    • 告诉评审者如何评估优质技能：
      • 目标明确
      • 不变量明确
      • 需要收集的证据明确
      • 安全的自动执行路径明确
      • 停止边界明确
      • 不因避免罗列 Shell 操作步骤而受到惩罚

  6. 起草一份技能

    • 按目标风格认真起草一份
    • 不要默认进行三份草稿的竞赛

  7. 评审草稿

    • 根据 RED 基线、不变量和自我合理化行为进行评审
    • 接受保护不变量或明确决策边界的反馈
    • 对主要是增加流程、却没有提升安全性或清晰度的反馈进行讨论

  8. 完善或升级处理

    • 持续修改，直至技能简洁、易于发现且安全
    • 出现以下情况时，应升级处理，而不是无限润色：
      • 提出一个澄清问题后，请求仍不明确
      • 评审发现尚未解决的不变量失效问题
      • 评审分歧实质上是仓库上下文无法解决的策略选择
      • 反复修改只增加流程，却没有提升安全性或清晰度

  9. 验证

    • 如果是项目级技能，确认它可在仓库的技能入口中发现
    • 运行针对已修改文件所需的仓库验证

  10. 归档并交付

  • 工作完成后归档计划
  • 按照仓库的常规工作流交付

Policy algebra

仅当技能主要编码必须在后续编辑中保持不变的治理规则、策略不变量或决策代数时，才使用 Policy algebra。

不要仅仅因为普通工作流或技术类技能中包含少量防护规则，就使用 Policy algebra。

如果适用 Policy algebra：

  • 起草前生成冻结规则块
  • 确保草稿在要求的位置原样包含该规则块
  • 发布前依据该规则块核验最终技能

优秀技能的特点

优秀的技能：

  • 易于发现
  • 告诉 Agent 何时使用
  • 快速明确目标
  • 保留重要的不变量
  • 收集安全行动所需的最少证据
  • 明确哪些操作可以自动执行
  • 明确 Agent 何时必须停止
  • 避免无法改善结果的繁文缛节

保留 / 避免

保留：

  • 触发条件优先的描述
  • 优先考虑故障模式的思路
  • 简洁的操作性语言
  • 明确的不变量和停止规则

避免：

  • 工作流摘要式描述
  • 除非精确语法是重点，否则避免编排 Shell 宏
  • 默认采用多草稿竞赛
  • 将冗长误认为高质量的审查循环

评论

支持 Markdown