SuperAPI AI 工具集

preset-creator

编程与开发

查看项目

更新于 10-16 06:13

技能介绍

用途:当用户需要创建、审查、改进或安装 Harness 预设时使用。预设不是普通文件夹模板,而是可复用的任务方法包,记录一类任务何时应存在、代理必须索要哪些输入、需要哪些任务元数据、必须先读哪些共享参考资料、必须产出哪些证据,以及生成的任务如何证明正确使用了预设。该技能独立存在,不假定代理已了解 Harness 任务契约。

主要能力与设计:至少两个未来任务共享同一方法或上下文时才创建预设;一次性任务或需求含糊的任务不应使用预设。设计前需回答任务族、预算(standard 或 complex)、task.kind、CLI 输入、task_plan.md 元数据、模板追加、证据文件、共享参考资料和写作用范围等问题。包结构通常包含 preset.yaml、templates 和 resources。运行时路径必须使用 {{paths.*}}(如 {{paths.tasksRoot}}/**),不得硬编码 coding-agent-harness/...。使用 references/structure-aware-paths.md、references/complex-task-skeleton/ 与 references/preset-package-skeleton.md 等参考文件。

用法:创建后运行 harness preset check <path>,安装用 harness preset install <path> --force,冒烟测试用 harness new-task <id> --budget <budget> --preset <preset-id> ... <target>,并运行 harness status --json、harness task-index --json、harness check --profile target-project,以及 harness preset audit。

限制:writeScopes 应尽量窄,生成文件须位于新建任务目录内;预设不得在创建任务时改动源代码、Git 状态或全局治理表;不得为 new-task 行为加入 JavaScript;如果行为需要代码,应识别缺失的内置处理器并停下来做设计评审。用户安装的预设位于 ~/.coding-agent-harness/presets/<preset-id>/。