SuperAPI AI 工具集

openspec-implementation-loop

编程与开发

查看项目

更新于 10-16 08:36

技能介绍

该技能用于围绕单个 OpenSpec 变更编排完整的实现循环,来自 elastic/terraform-provider-elasticstack 仓库的技能集合。

用途:自动化完成一个 OpenSpec 变更从选择到交付的流程,适用于需要按规范实现 Terraform 相关代码、运行校验并跟踪 CI/PR 的场景。

主要流程与能力:

  1. 选择变更:若未提供变更名,运行 openspec list --json 并用 AskUserQuestion 让用户选择一个活动变更,不猜测、不自动选择、不支持一次实现多个变更。
  2. 交付方式:选定变更后立即询问「仅提交」还是「Pull request」,仅提交模式推送后监控 GitHub Actions;PR 模式创建 PR 并调用 pr-monitoring-loop 技能监控 CI、评审、评论与合并可行性。
  3. 加载上下文:运行 openspec status --change "<name>" --json 与 openspec instructions apply --change "<name>" --json,读取 contextFiles;若状态为 blocked 则停止并说明缺失产物,若为 all_done 则直接进入推送阶段。
  4. 分诊策略:依据顶级任务数、子任务数、文件范围、任务耦合度和复杂度,选择 inline、single-implementor 或 per-task 三种执行策略,并公布理由,用户可覆盖。
  5. 实现任务:按所选策略顺序实现剩余顶级任务及其子任务,遵循 openspec-apply-change 流程,同步 delta 规范但不归档变更(归档由 verify-openspec 负责),保持改动最小并创建小粒度提交,实现中运行针对性校验,且绝不推送远程。
  6. 校验与评审:基准命令为 make lint 与 make build;相关验收测试用 go test -v [-run 'filter'] <package> 并设置 TF_ACC=1,必要时配置 ELASTICSEARCH_ENDPOINTS、ELASTICSEARCH_USERNAME、ELASTICSEARCH_PASSWORD、KIBANA_ENDPOINT;仅在用户明确要求时运行 make testacc 全量验收套件。评审包含关键代码评审、提案合规评审,Terraform 实体变更额外做覆盖率评审,非实体变更则做测试覆盖分析。
  7. 聚合修复:汇总可执行发现并修复,重跑校验与相关评审,直到通过或受阻或同一问题反复无进展,停滞时询问用户。
  8. 推送与监控:校验通过后推送分支(如 git push -u origin HEAD),除非用户明确要求否则不强制推送。仅提交模式监控分支/提交的工作流运行,CI 失败时启动新实现子代理修复并再次推送;PR 模式创建 PR 后交由 pr-monitoring-loop 监控,状态文件默认使用 .agents/skills/pr-monitoring-loop/scripts/state/.pr-monitor-<pr>.json,不要放在 .git/ 下。

限制:需依赖 OpenSpec CLI 与相关子技能;命令、验收测试时长、环境变量等细节视资料而定;未提供收费、价格等信息。