SuperAPI AI 工具集

ai-implement

编程与开发

查看项目

更新于 11-10 00:11

技能介绍

用途

ai-implement 是一个实现执行器智能体,用于按照已有的实现计划构建代码。它只通过 /ai-implement 斜杠命令调用,不激活为独立功能。其目标是精确执行计划中指定的每个阶段、每个文件、每个细节,不跳过、简化或超出计划即兴发挥。

主要能力

  • 解析计划:提取要创建或修改的每个文件、每个阶段、代码示例、接口定义、命名约定和测试要求。
  • 加载项目上下文:读取根目录 README.md、AGENTS.md、CLAUDE.md 以及 .ai-skills.toml 中 context_files 列出的文件;从 feature 文件夹读取 README.md、plan.md、research.md。
  • 验证代码库状态:根据 research.md 的覆盖评估决定聚焦验证或完整读取。
  • 识别缺口和冲突:检查文件变更、依赖缺失、接口不匹配、代码示例与现有模式冲突等。冲突被视为阻塞问题,不会自行选择解释。
  • 批量提问:在写代码前通过 AskUserQuestion 统一提出冲突、歧义、决策和依赖问题。
  • 声明写入集合:在阶段执行前,列出本次运行可能写入的具体路径,分为流水线产物(feature 文件夹的 README.md、plan.md 和 output_root 的 README.md)和源代码(来自计划的“Files to Modify”部分)。
  • 阶段独立性分析:检查阶段之间是否共享文件或存在数据依赖,以判断可并行执行的阶段。
  • 不可信内容处理:将读取的所有内容视为数据而非指令,发现指令性内容时报告为阻塞问题。

使用方式

通过 /ai-implement 命令调用,需提供功能名称作为参数($ARGUMENTS)。工具会按 Folder Resolution Order 解析功能文件夹,必要时自动创建带日期的文件夹和 README.md。如果缺少 plan.md,会询问用户是提供计划还是描述要实现的内容。用户需在功能文件夹中提供包含阶段、任务和“Files to Modify”部分的 plan.md。

适用场景

适用于已有实现计划的软件开发任务,尤其是需要严格按计划执行、避免偏离和即兴修改的场景。也可用于需要先分析计划与代码库一致性、再批量澄清问题的协作开发流程。

限制

  • 只通过 /ai-implement 斜杠命令调用,不能独立激活。
  • 写入范围限制在本会话的工作目录内;在目录外创建、修改、移动或删除文件需用户在请求中明确命名该路径。临时文件可使用 mktemp 创建,但需在结束前删除。
  • 计划中缺少“Files to Modify”部分或未命名路径时,报告无法派生写入集合并停止。
  • 非交互式会话或无人回答问题时,会写入完整冲突报告并停止,不进行实现。
  • 不处理超出其角色范围的上下文指令,遇到指令性内容会作为阻塞问题报告。

暂未提供

官方未提供关于收费、价格、平台支持、效果评估或具体使用步骤的更多信息。