SuperAPI AI 工具集

implement

编程与开发

查看项目

更新于 10-15 12:20

技能介绍

用途

该技能用于指导代码实现类工作,包括编写代码、构建功能、修复缺陷、重构以及执行多步骤实现任务。其核心目标是:以代码路径和输出被消费的位置为依据,交付所要求的行为,并保留可验证的证据。

主要能力

  • 变更定位:编辑前检查仓库状态,阅读受影响文件上的现有差异;将检出目录视为共享空间,保留非自己创建的工作,尊重已声明的所有权。通过实际调用方和消费方追踪行为,定位最近的相关模式、测试和真实门禁命令。
  • 可验证切片选择:根据情境选择下一步动作,例如清晰低影响的编辑直接修改并运行相关结构或行为检查;可观察失败的缺陷先复现、隔离原因再验证修正;跨边界的新行为实现有代表性的端到端切片及其测试;共享接口或模式变更先追踪消费方与兼容性;大型不确定变更使用计划明确依赖与验收标准。
  • 设计问责:遵循本地模式,除非有具体问题证明偏离合理。对新增模式或配置、重复决策、仅转发调用的包装器、隐藏不兼容数据的类型转换、隐藏错误的回退、兼容代码增长、复杂度持续上升等情况给出判断依据。
  • 验证声明:从实际仓库和受影响行为中选择检查方式,包括类型/静态分析、聚焦行为测试、包或集成检查、构建/打包验证、消费方检查。使用范围化检查作为内循环,在相关提交或交付边界前运行必需的仓库门禁。保留命令退出码和原始失败日志。
  • 消费边界检查:针对生成配置、包、UI、CLI、数据库迁移、服务等不同产物,给出代表性证明方式,检查不变量而非仅“命令成功”。
  • 失败恢复:编辑前对失败分类,区分环境故障、陈旧产物、调用错误、共享输出竞争和运行时缺陷。当修复失败时,说明结果否证了什么,并选择能区分剩余解释的检查。
  • 审查与提交:遵循项目提交策略,原子提交已验证的逻辑块,将行为变更与理解它所需的测试放在一起。暂存前检查状态和差异,暂存明确拥有的路径或块。
  • 状态保留与收尾:在交接或压缩时保留原始结果、用户更正、变更路径、修订版本、已运行检查、未解决发现和下一步。

使用方式

该技能不是固定序列、编辑预算、强制研究阶段或代理配额。用户指令优先于技能指南。已有授权应继续沿用并在范围内完成工作。常规可逆选择可在有用时以明确假设解决。仅当缺失信息实质性改变结果或适用边界要求时才提问;技能工作流本身不创建新的审批门禁。

适用场景

适用于需要编写或修改代码、构建功能、修复缺陷、重构、执行多步骤实现工作的场景。当不确定性、集成复杂度或后果增加时,应提高验证强度。

限制

该技能不授予更改相邻代码、绕过审批或声称未运行检查的权限。它不能替代对实际实现及其消费方的理解。参考资料中的基准和恢复文档不建立通用的编辑比例或与模型无关的性能保证。