SuperAPI AI 工具集

forge

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

forge — Changeset Implementation & Verification 是一个用于实施并验证授权变更集(changeset)的技能。其用途是接收已授权的变更树、验收标准、约束条件,以及支撑该解决方案的证明或适用的官方参考,然后按依赖顺序执行创建、移动、更新和删除,运行适用的类型检查、代码检查、针对性测试与受影响子系统检查,直至实现与验收标准全部通过。

主要能力包括:按授权范围实施变更,主动移除被替代的旧逻辑、无用辅助代码和过时测试,清理 .agents/scratch/ 临时产物与临时工作树;在约定方向内纠正实现错误,但当成功需要大幅改变方向、契约、风险或影响范围时停止改动并报告重新设计缺口;保持验证完整性,要求每项验收标准和必要检查在 DONE 前通过,保留失败证据,不静默回退或弱化断言;使用 git reset --soft HEAD~1 安全撤销本地提交以保留暂存区未提交差异;不检查或修改 .env*、.key、.pem 等密钥文件,测试与代码检查依据 .agents/environment.md 执行。

使用方式:先检查就绪状态,缺少方向或必要变更集时报告 UNRESOLVED 并交接;仅缺执行授权时报告 STAGED 并停止编辑。实施阶段先为缺陷修复建立确切的失败基线,为功能覆盖约定的验收标准,再应用最小实现并运行检查。普通编译器、代码检查和测试失败在范围内继续修复,并区分实现错误、无效设计假设与无关的基线失败。完成后清理相关临时产物,按规范输出实现报告,包含状态、验证结果、剩余事项、检出状态,且仅在 DONE 时给出提交信息。

适用场景:已有明确授权变更集与验收标准的代码修改任务、缺陷修复、行为保持型改动、需要严格验证证据的仓库内实施工作。

限制:提交、合并与发布不在该技能的完成范围内;新所有权、模式语义或显著范围扩展需要重新设计;缺少工具链或测试数据存储导致无法验证时需转交环境修复流程。