SuperAPI AI 工具集

aider-cli-workflow

编程与开发

查看项目

更新于 10-15 16:29

技能介绍

用途

Aider CLI Workflow 是一个面向本地代码仓库的 AI 结对编程技能,用于在明确边界内、以测试为验证依据地驱动 Aider 完成编码任务。它适合处理单个小功能或单个缺陷,并强调提交(commit)层面的整洁与可追溯。

适用时机

  • 需要一次性整理从 Aider 安装/初始配置检查到实际运行的完整流程时。
  • 需要以测试为基准,用 AI 结对编程处理一个小功能或一个缺陷时。
  • 需要按提交单位验证和整理 Aider 所产生的变更时。

不适用时机

  • 以托管平台 PR 评审、标签、分支保护策略为中心的工作(属于 code-review、GitHub workflow 一类)。
  • 仅需要处理 Git 冲突或恢复的场景(属于 git-workflow)。
  • 以根因调试为中心的工作(属于 debugging)。

使用方式

技能按以下步骤执行:

  1. 前置条件:确认仓库根目录(git rev-parse --show-toplevel);确认 Aider 已安装(aider --version);至少准备一条测试或 lint 验证命令。
  2. 范围锁定启动:一次只指定一个任务(一个缺陷或一个功能)。给 Aider 的提示中必须包含:变更目标文件范围、验收标准(acceptance criteria)、测试/验证命令。
  3. 以测试为依托的编辑循环:先运行基准测试(确定失败/成功基线);用 Aider 修改;重新运行测试;检查 diff,必要时继续修改。
  4. 提交规范:用 git add -p 审查变更范围;提交信息包含意图与验证命令;在提交或报告中明确风险(实验性补丁、不稳定测试、未验证路径)。
  5. 回退策略:若变更扩散过大,立即缩小范围并重试;若测试反复失败,停止 Aider 自动修改循环,转为原因分析。

输出格式

技能建议以如下简报形式输出:

Aider Run Brief

  • Goal:
  • Scope:
  • Validation commands:
  • Changed files:
  • Risks / follow-ups:

示例

示例 1:小型缺陷修复循环

  • 目标:让 1 个失败的单元测试恢复通过。
  • 范围:仅编辑测试文件及相关实现文件。
  • 验证:pytest -q tests/path/test_x.py

示例 2:窄范围功能增量

  • 目标:新增 1 个 API 字段并保持向后兼容。
  • 范围:schema + handler + 测试。
  • 验证:既有测试 + 新增测试。

最佳实践

  • 始终先取得基线测试结果。
  • 未明确文件范围的 Aider 会话不要启动。
  • 提交前用 git add -p 移除不必要变更。
  • 对不稳定或实验性变更,明确标注风险并留下后续 TODO。

限制

资料未提供该技能的具体安装命令、依赖版本、支持的编程语言范围、收费方式或平台限制,这些信息暂未提供。

参考

  • Aider:https://github.com/Aider-AI/aider
  • Aider 文档:https://aider.chat/