mcpField
A
aider-cli-workflow

aider-cli-workflow

github.com/akillness开发53271 次安装4 天前更新
代码仓库

关于 aider-cli-workflow

用于在本地仓库中通过 Aider 完成小型、由测试支撑的代码修改的工作流技能，涵盖环境检查、范围控制、验证与提交审查。

主要功能

  1. 01检查仓库与 Aider 环境
  2. 02将工作限定为一项修改
  3. 03编辑前后运行测试
  4. 04审查差异与提交

适用场景

  1. 01用 Aider 修复小型错误
  2. 02实现范围明确的功能
  3. 03验证并整理 Aider 的修改

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/akillness/jeo-skills --skill aider-cli-workflow

安装后在 Claude Code 中输入/aider-cli-workflow确认已加载。

详细介绍

Aider CLI 工作流

当用户明确要求在本地仓库中使用 基于 Aider 的编码循环 时，使用此技能。

适用场景

  • 需要从确认 Aider 安装和初始设置到运行，一次性整理完整流程时
  • 需要以测试为依据，通过 AI 结对编程处理小型功能或错误时
  • 需要按提交单元验证和整理 Aider 所做的更改时

不适用场景

  • 以托管 PR 审查、标签或分支保护策略为中心的工作（code-review、GitHub 工作流系列）
  • 仅需处理简单的 Git 冲突或恢复操作时（git-workflow）
  • 以根因调试为中心的工作（debugging）

说明

步骤 1）前置条件
  1. 确认仓库根目录：git rev-parse --show-toplevel
  2. 确认已安装 Aider：aider --version
  3. 确认基本验证命令：至少准备一条测试或 lint 命令
步骤 2）启动时锁定范围
  • 一次只指定一项任务（一个错误或一项功能）。
  • Aider 提示词中必须包含：
    • 要修改的文件范围
    • 验收标准（acceptance criteria）
    • 测试或验证命令
步骤 3）以测试为依据的编辑循环
  1. 运行基准测试（确定失败或成功基线）
  2. 使用 Aider 进行修改
  3. 重新运行测试
  4. 检查 diff，并在必要时继续修改
步骤 4）提交规范
  • 使用 git add -p 检查更改范围
  • 提交消息应包含修改意图和验证命令
  • 在提交或报告中注明风险（实验性补丁、flaky 测试、未经验证的路径）
步骤 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 和测试
  • 验证：现有测试和新增测试

最佳实践

  1. 始终先获取基准测试结果。
  2. 未明确文件范围时，不要启动 Aider 会话。
  3. 提交前使用 git add -p 移除不必要的更改。
  4. 对 flaky 或实验性更改注明风险，并留下后续 TODO。

参考资料

评论

支持 Markdown