用途
Aider CLI Workflow 是一个面向本地代码仓库的 AI 结对编程技能,用于在明确边界内、以测试为验证依据地驱动 Aider 完成编码任务。它适合处理单个小功能或单个缺陷,并强调提交(commit)层面的整洁与可追溯。
适用时机
- 需要一次性整理从 Aider 安装/初始配置检查到实际运行的完整流程时。
- 需要以测试为基准,用 AI 结对编程处理一个小功能或一个缺陷时。
- 需要按提交单位验证和整理 Aider 所产生的变更时。
不适用时机
- 以托管平台 PR 评审、标签、分支保护策略为中心的工作(属于 code-review、GitHub workflow 一类)。
- 仅需要处理 Git 冲突或恢复的场景(属于 git-workflow)。
- 以根因调试为中心的工作(属于 debugging)。
使用方式
技能按以下步骤执行:
- 前置条件:确认仓库根目录(git rev-parse --show-toplevel);确认 Aider 已安装(aider --version);至少准备一条测试或 lint 验证命令。
- 范围锁定启动:一次只指定一个任务(一个缺陷或一个功能)。给 Aider 的提示中必须包含:变更目标文件范围、验收标准(acceptance criteria)、测试/验证命令。
- 以测试为依托的编辑循环:先运行基准测试(确定失败/成功基线);用 Aider 修改;重新运行测试;检查 diff,必要时继续修改。
- 提交规范:用 git add -p 审查变更范围;提交信息包含意图与验证命令;在提交或报告中明确风险(实验性补丁、不稳定测试、未验证路径)。
- 回退策略:若变更扩散过大,立即缩小范围并重试;若测试反复失败,停止 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/