技能自动改进器

安全 社区

技能解读

当前原文的自动摘译,尚未人工审校。

编辑前同步仓库(强制)

此技能会改变 git 存储库中的文件。在进行任何编辑之前,将本地分支与远程同步:如果工作树是脏的,git stash,同步,然后git stash pop。如果 origin 丢失或 git pull 发生冲突,请在继续之前停止并询问用户 - 不要跳过或强制同步。

何时使用

用户要求“改进”、“升级”、“修复”、“抛光”或“达到标准”现有技能 技能失败quick_validate.py或分数低于 asm-eval 85/8 层,必须交付 您正在为 asm publish 准备一项技能或将其包含在目录中 您想要对自己的一项技能进行测试质量改进 如果用户只想要一份未经编辑的报告,请运行直接asm eval <path>和python scripts/quick_validate.py <path>——那不是这个技能。如果用户从头开始编写全新的技能,请将其发送到/skill-creator - 该技能假设 SKILL.md 已经存在。

先决条件

在接触任何文件之前验证以下所有内容。如果有任何失败,请停止并告诉用户。 asm 在 PATH 上可用(command -v asm 或 which asm) Python 3 可用,并且 ~/.claude/skills/skill-creator/scripts/quick_validate.py 存在(技能创建器必须在本地安装) 目标技能路径包含一个 SKILL.md 文件 工作树没有不相关的未提交编辑(脏文件会混合到差异中)

输入

用户提供以下之一: 本地技能路径:skills/foo 或 /abs/path/to/skill 直接 SKILL.md 文件路径(视为其父目录) GitHub 简写:github:owner/repo 或 github:owner/repo:path/to/skill 对于 GitHub 输入,要求用户首先在本地克隆,或者是否应该打开返回该存储库的 PR。该技能的默认路径是本地编辑 - 远程编辑超出了 v1 的范围。

1号门——技能创造者标准(必经楼层)

当所有这些都为真时,技能就会通过此门:python "$QV" "$SKILL_PATH"退出0(没有意外的键,名称是kebab-case≤64个字符,描述是单行≤1024个字符等)Frontmatter审核(references/frontmatter-audit.md中的完整清单)通过SKILL.md主体低于500行(拆分为references/ 如果没有)描述包括一个负面触发子句,命名不应触发技能的相邻域(quick_validate.py 缺失时发出警告)

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
安全
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
94 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@luongnv89 · MIT
上下文用量评级
较高消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
阶段 0 — 捕获两个门的基线

保存起始状态,以便可以审核之前/之后的差异:然后执行`references/frontmatter-audit.md`中描述的Frontmatter审核并将结果保存到`.asm-improver/baseline-frontmatter-audit.md`。如果目标技能位于 git 存储库中,建议将 `.asm-improver/` 添加到 `.gitignore`,以便迭代工件不受版本控制。阅读 JSON 并注意:`overallScore`,`grade`

02
第 1 阶段 — 应用确定性修复,然后标准化 frontmatter

运行评估器的自动修复程序以获得免费胜利:这可以处理尾随空格、CRLF 标准化、缺少 `effort` 和其他机械问题。然而,当作者或版本丢失时,`asm eval --fix`会写入顶级`author:`(来自`git config user.name`)和/或顶级`version: 0.1.0`——这两者都被`quick_validate.py`拒绝作为意外的键。立即执行下面的标准化步骤。

03
第 2 阶段 — 首先修复 Gate 1 故障

`quick_validate.py` 和 Frontmatter 审计结果是第一位的,因为它们限制了发布。阅读`references/skill-creator-checklist.md`以获取完整的改造手册。常见修复:描述缺少负面触发子句 → 附加“不要用于 X、Y、Z”。命名 2-3 个相邻域 描述超过 250 个字符 → 修剪对冲词,折叠同义词(1024 是硬上限,250 是运行时预算目标)

04
第 3 阶段 — 修复最低的 asm-eval 类别

按分数升序对 7 个类别进行排序。首先处理最低的一个。当全部都是`>= 8`时停止。对于 8 以下的每个类别:阅读 `references/category-playbook.md` 以查找该类别的修复模式 将其与 `Edit`(小的有针对性的更改)或 `Write`(重组整个部分时)一起应用 重新运行 `asm eval "$SKILL_PATH" --json` 和 `python "$QV" "$SKILL_PATH"` 并检查增量

05
第 4 阶段——注意跨门权衡(侧边栏——适用于第 3 阶段)

这些原则在进行第三阶段类别修复时持续适用,而不是作为一个单独的连续阶段。在第三阶段之前阅读一次,并在每次编辑时牢记它们。两个门在正文长度上拉向相反的方向:`asm eval`的`prompt-engineering`奖励最多3000字的正文`asm eval`的`context-efficiency`奖励1500字以下的正文Gate 1将SKILL.md限制在500行(硬技能创造者规则,〜几千字)

06
第 5 阶段 — 更改目标技能的元数据.版本

此阶段作为第 6 阶段循环的每次迭代中的最后一个操作运行,而不是作为第 6 阶段之后单独的一次性传递。对于叙述流,数字是连续的;实际执行是每次迭代。根据技能创建者的版本管理规则,对 SKILL.md 的每次编辑都必须在保存之前修改 `metadata.version`: 补丁 (`x.y.Z`):拼写错误修复、仅限 frontmatter 标准化、细微的措辞调整

07
第 6 阶段 — 带帽的环

每次迭代后重新运行这两项检查。当其中任何一个为真时,循环停止: 停止条件 · 结果门 1 通过 AND `overallScore > 85` AND `min(scores) >= 8` · PASS — 继续报告已完成的 8 次评估迭代 · BLOCKER — 写入报告 3 个连续迭代,任一门上都没有移动 · BLOCKER — 写入报告

08
第 7 阶段 — 撰写最终报告

通过时,写入`.asm-improver/report.md`:目标技能路径 两个门的基线与最终:`quick_validate.py`状态、Frontmatter审核结果已清除、`overallScore`、`grade`、每个类别之前/之后表目标技能`metadata.version`:基线→最终文件已更改(列出已编辑或创建的技能目录下的每个路径)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。