SuperAPI AI 工具集

agent-harness

智能体与模型

查看项目

更新于 10-16 01:35

技能介绍

用途:把仓库改造成对智能体友好、可自我维持的工程化仓库。该技能负责安装与配置,之后的强制执行由 CI、git 钩子和项目约定完成。

三种模式:

  1. 验证(主要模式):始终先执行。在目标仓库根目录运行 ${CLAUDE_SKILL_DIR}/scripts/verify-harness.sh,根据输出分析并修复或给出建议。检查内容包括失效引用、行数、缺失产物,以及命令与目标的对应关系。
  2. 引导(Bootstrap):当产物缺失时,按模板创建 AGENTS.md、docs/ARCHITECTURE.md、docs/exec-plans/{active,completed}/ 目录、各平台的 harness-verify.yml 与 harness-checkpoints.yml(GitHub/GitLab/Forgejo/Gitea)、PR/MR 模板、.envrc、Makefile harness 目标、scripts/verify-harness.sh、.harness/checkpoints.yml。需填入仓库专属值,未经确认不得覆盖已有文件。
  3. 审计:报告仓库成熟度等级(1、2、3)并说明达到下一级所需条件,详见 references/maturity-levels.md。

运行技能自带的检查:仓库在 .harness/checkpoints.yml 中按 ref 固定声明适用的技能检查点,CI 任务执行 ${CLAUDE_SKILL_DIR}/scripts/run-shipped-checkpoints.sh。严重级别为 error 的检查点失败会使任务失败,其余只报告;遇到无法解析的声明以退出码 2 退出而非静默通过。verify-harness.sh 会在有声明无任务、或有任务无声明时报错。

关键原则:AGENTS.md 是索引而非百科,保持 150 行以内,细节放 docs/;强制在项目层实现;先验证后引导;专门工作委派给其他技能;学习环节交给 retro-skill,harness 仅验证集成点存在,不在运行时调用 retro。

成熟度:1 级基础——存在 AGENTS.md 且为索引并记录命令;2 级已验证——CI 强制 harness 完整性、引用可解析、命令与 Makefile/脚本一致、有 ARCHITECTURE.md;3 级已强制——分支保护要求 harness CI、git 钩子自动激活、PR 模板含检查清单、推送时漂移检测。

限制:资料未提供具体安装命令、价格、平台限制与效果保证;该技能检查产物而非工具,且本身不执行学习与回顾。