用途
Harness Skill Creator 面向需要为智能体创建 harness 导向技能的场景。它的定位是:创建一个尽可能小的技能,使另一个智能体能够带着证据、验证和清晰的所有权,重复完成某一项 harness 工作。它适用于从已有仓库、工作流、评估语料或 harness 分析链路中进行引导或收紧。
主要能力
技能围绕一套结构化的工作流组织:
- 解析来源(source)、目标(target)与宿主(host):确定规范的
skills/<name>/目录、.agents/skills/包装器,或两者兼有。 - 在设计前检查源链:入口
SKILL.md、第一跳引用、脚本、验证器、模板、规格、测试、插件清单,以及任何真实的冒烟证据。 - 在首次盘点之后加载
references/bootstrap-patterns.md,用于提取模式,而不是产品特定的规则。 - 草拟最小可行技能地图,包含:技能名称与触发句、技能拥有的单项工作、需要在
skills/<skill-name>/下创建的文件(通常为SKILL.md加一个引用)、证据边界与验证命令、正向测试提示与通过/失败门。 - 在可用时,使用系统 skill-creator 助手初始化新的规范技能。
- 将
SKILL.md编写为路由器:把触发条件放在 frontmatter description 中,正文保持简短,将详细规则路由到第一跳引用。
使用方式
技能给出一套明确的操作与验证命令。验证环节运行最窄的可用门:
python3 <skill-creator-root>/scripts/quick_validate.py <skill-dir>qodercli --cwd <neutral-dir> --plugin-dir <harness-root> -p "<forward-test prompt>"qodercli plugin validate <harness-root>
仅当存在稳定的重复自动化时才添加 scripts/;将临时的评估提示排除在运行时脚本之外。在本地验证后再进行正向测试,将 qodercli 输出视为模型证据,本地验证器与文件检查决定通过/失败。任何正向测试之后,对模型被允许读取或写入的每个仓库验证 git 状态或文件清单。
适用场景
该技能适用于需要为重复性 harness 任务建立最小技能的开发与自动化场景,包括从现有仓库、工作流、评估语料或分析链路引导技能,或对已有技能进行收紧。
限制
技能包含多项设计门约束:优先使用单个技能而非阶段树,直到目标流程证明存在多个可复用阶段;复制所有权形态而非产品名称、分支策略、私有命令或来源特定团队路由;当工作流由插件共享时,将 .agents/skills/ 保留为包装器或镜像,规范判断归属于根 skills/。除非用户要求且源证据支持,否则不要添加安装、网络、服务器、迁移或更改依赖的命令。优先使用可移植的 Node/Python 验证器或目标自有命令,不要将生成的验证门默认设为仅限 Unix 的 grep/find 检查。在仅附件或无工具的正向测试中,绝不要输出工具调用标记、shell 探测或检查计划;需要时返回带有 status: "insufficient-evidence" 的技能地图。正向测试文件是字符串数组(skills/<skill-name>/... 路径),而非对象。如果生成的技能无法通过 quick_validate.py <skill-dir>,则不要将其描述为可用。需拒绝缺失 frontmatter、过期占位符、损坏链接、不受支持的命令、仅来源假设、伪工具调用或宽泛报告。