SuperAPI AI 工具集

harness-1-boot

通用与其它

查看项目

更新于 10-16 06:19

技能介绍

用途:这是 harness 循环(Boot → Backpressure Check → Do Work and Observe → Retro and Magic Wand → Improve)的 Boot 阶段技能。在会话开始时运行,确认工程 harness 是否健康,并报告其成熟度级别。核心理念是:若全新智能体会话无法在 30-60 秒内仅凭治理文档到达健康、可观测的运行系统,这就是任何功能开发前最应先修复的事。

主要能力:

  • 两种模式:--validate 运行实时 Boot → Interact → Observe 健康检查(治理文档存在时为默认);--status 输出只读成熟度报告,不启动、不修改。
  • 自动检测:有治理文档则 VALIDATE,否则报告 UNAVAILABLE。
  • 三阶段校验:Stage 1 Boot Check(健康检查通过则跳过启动,否则运行启动命令,最多 30×2s=60s 重试);Stage 2 Interact Check(按文档发送测试输入,单次尝试,5s);Stage 3 Observe Check(捕获证据,单次尝试,5s)。
  • 判定:✅ HEALTHY(三项通过且启动≤45s)、⚠️ SLOW(三项通过但启动>45s)、❌ UNHEALTHY(任一失败)、🔴 UNAVAILABLE(无治理文档且无启动命令)。
  • 信号就绪度摘要:运行时可检视性、冒烟路径、架构/静态检查、安全/依赖/模式检查、证据路径、背压缺口,各取 present / missing / not declared,不编造数值评分。
  • 成熟度模型 L0-L4:L0 无 harness、L1 前门、L2 命令已编码、L3 改进循环活跃、L4 自改进。

使用方式:读取治理文档(优先 docs/project-rules/engineering-harness.md,回退 agent-harness.md、harness.md,命中遗留文件名时输出一行迁移提示但不修改文件),解析启动命令、健康检查、交互方法、观察方法、成熟度与信号清单;按 bash 运行三阶段检查;更新成熟度评估与历史表;输出验证报告(Boot/Interact/Observe、Signals、Gaps、Verdict、Maturity、Checklist、Missing)。

适用场景:会话启动阶段的 harness 健康自检;跟踪跨会话成熟度轨迹以衡量复利价值;识别值得在 Observe/Retro 阶段改进的信号缺口。

限制:本技能不创建或脚手架化治理文档、harness CLI、fixtures 等(由独立的 engineering-harness setup 工作负责),缺失时优雅降级为 UNAVAILABLE 而非阻塞会话;不设门槛、评分或背压阈值,信号缺口仅为建议性改进候选;不实现产品特定的传感器;仅在实时 Boot/Interact/Observe 检查失败时判为失败。文档未声明信号维度时报告为未声明,不据此重写文档。具体命令、参数与配置细节以实际治理文档为准。