SuperAPI AI 工具集

implement

编程与开发

查看项目

更新于 10-15 17:29

技能介绍

用途:实现已接受的结果,直接修复已知的普通缺陷。对于清晰的编辑,沿用现有意图,无需 Plan、Recall 或 Learn 工作表。implement 负责源码变更与事实性检查,身份与回执由运行时推导。

主要能力与规则:修复根因而非测试预言,绝不通过放宽断言、容差、golden、fixture、抑制项,或用 mock、占位符替换来让检查变绿;若检查针对已接受行为失败,说明是产品缺陷,改变检查所接受的内容属于验收变更,需要调用方授权。编辑前先查找活跃消费者,搜索被改函数、类型、路径、格式或消息的调用方、读取方、脚本、文档与测试,逐一说明影响及覆盖检查;退役或重命名时,消费者包括安装、查找与旧名调用,需保留历史溯源。命名可区分的检查:行为变更需保留预期缺失行为的 RED,指出编辑前失败、编辑后通过的检查,以及每个受影响消费者的检查。只报告实际运行的内容,给出确切命令与结果,未运行或无法运行的检查列为 not run,绝不把未运行的工作称为已验证、已修复或已通过。

工作流:首次写入前读取意图、验收、范围与仓库边界,复用已加载契约。沿用已接受的行为示例不变,符号与测试使用仓库领域名称,通过相关接口检查可观察结果。编辑前后运行最小适用检查;纯重构、迁移或文档可有诚实的绿色基线,优先使用现有测试或小型区分性探针。做范围内最小变更;修复发现或检查时保留消费者现有输入选择,修复错误路径不授权扩大扫描,排除重要时使用阴性对照。批量传播前用代表性变更对照现有约束,广泛再生成前先检查作者源集。直接修复已知失败并用检查验证确切结果,修复不启动另一次评审。被证伪的假设可在范围内改变方法,仅对重大不确定性使用 Plan。

读取仓库实际的检查配方(含插桩与环境),而非凭记忆重建。集成前运行定向测试与 lint/静态检查,集成时运行必需的全量检查。仅在源码、工具与相关环境匹配时复用精确输入回执。不绕过必需钩子,也不仅为重命名回执而重放检查。必需 CI 任务的已知失败在运行结束前即可处理:在范围内修复,保留失败主体证据并重跑受影响检查;待处理任务不意味着成功。验收保持绿色时进行重构,交接前对照原始意图检查变更的测试、fixture、golden、容差、抑制项与规范文本。

由运行时推导实际变更路径与内容身份。委托增量等待集成时,在现有交接中返回确切提交或运行时推导的内容摘要、作者上下文 ID 与检查事实。集成调用方在判定前对完整最终主体推导 subject-manifest.v1(AgentOps schema schemas/subject-manifest.v1.schema.json);独立判定的增量需要自己的清单,不因工作被委托就同时生成两者。

在该边界,当仓库记录 AgentOps 证据绑定且变更路径影响已绑定验收证据时,运行 ao provenance evidence-orphans --root <repo-root>,每个推导路径一个 --changed <path>,保留其实际输出并在修复后刷新受影响绑定。没有 ao 时,将孤儿扫描列为 not run,绝不编造或抑制孤儿列表。

交接格式:changed、identity、checks(行为变更需前后各一行)、not run、consumers、gaps。保持完整日志在源头,不复制清单或状态文档。对未覆盖的活跃消费者报告调用方范围修正,并继续独立的已授权工作。已作为范围包含的生成伴随物无需新批准;验收变更始终需要调用方授权。

诊断、脚手架与委托:对无法解释的失败,先匹配报告症状并缩小复现,陈述一个因果预测,用区分性检查测试,并修复结果支持的根因,然后重跑原始场景;理解根因后不再继续收集假设。该紧凑诊断路径受 Matt Pocock 的工程技能启发。当请求的变更是脚手架时,从仓库现有布局与可工作的垂直切片开始,仅在相关工具形态时参考脚手架参考,仓库无合适模式时参考通用脚手架示例;避免占位成功路径与为一次性操作引入新框架。

优先当前会话执行。若委托已授权且有用,在隔离工作区划分独立写入,共享生成器与集成串行化。为每条通道提供意图、验收、范围与评审负责人,然后集成其确切内容与检查事实。选定的波次以调用方请求的波次结果结束,不发明另一波次。对集成候选的一次新评审可覆盖未判定增量;当集成方拥有该评审时,工作者返回交接而不委托另一次。保留任何单独要求的通道判定;进程成功退出不是语义 PASS。Agent Native 提供可选调度机制。

显式请求的一次性适配器对每个提供的操作派发一次,报告其输出或错误后停止;用 dry-run 或 fixture 展示派发次数与失败报告,不静默获取调度器、重试控制器或存储。工厂需要调用方选择。

完成:专家仅提供建议,已知缺陷仍属实现工作;真正的因果停滞允许在调用方授权内最多一个受限的新助手。遵守剩余调用方/原生边界并保留收尾能力,重试不重置二者。返回事实而非语义 PASS。仅实现的交接不授权 Git、跟踪器或交付转换,现有调用方授权仍可用。完整结果请求以其检查与 CI 结束;仅当调用方要求、错误落地后无法廉价撤销,或无确定性检查覆盖变更行为时,才继续一次新的独立判定。RPI 可选且需显式选择。成功是可工作的行为与可用证据,而非日志或过程产物的数量。