Back to Details

aider-cli-workflow

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Aider CLI Workflow

Aider CLI 工作流

Use this skill when the user explicitly wants an Aider-based coding loop in a local repo.
当用户明确希望在本地仓库中使用基于Aider的编码循环时，使用此技能。

When to use this skill

适用场景

  • Aider 설치/초기 설정 확인부터 실행까지 한번에 정리해야 할 때
  • 작은 기능/버그를 테스트 기준으로 AI pair-programming으로 처리할 때
  • Aider가 만든 변경을 커밋 단위로 검증/정리해야 할 때
  • 需要从Aider安装/初始设置检查到运行一次性完成时
  • 需要以测试为基准，通过AI结对编程处理小功能/漏洞时
  • 需要以提交为单位验证/整理Aider所做的变更时

When not to use

不适用场景

  • Hosted PR 리뷰/라벨/브랜치 보호 정책 중심 작업 (
    code-review
    , GitHub workflow 계열)
  • 단순 Git 충돌/복구만 필요한 경우 (
    git-workflow
    )
  • 루트 원인 디버깅 중심 작업 (
    debugging
    )
  • 以托管PR评审/标签/分支保护策略为核心的工作（
    code-review
    、GitHub工作流系列）
  • 仅需要解决简单Git冲突/恢复的情况（
    git-workflow
    ）
  • 以根本原因调试为核心的工作（
    debugging
    ）

Instructions

操作步骤

Step 1) Preconditions

步骤1) 前置条件

  1. 저장소 루트 확인: 
    git rev-parse --show-toplevel
  2. Aider 설치 확인: 
    aider --version
  3. 기본 검증 명령 확인: 테스트/린트 명령 1개 이상 확보
  1. 确认仓库根目录：
    git rev-parse --show-toplevel
  2. 确认Aider已安装：
    aider --version
  3. 确认基础验证命令：获取至少1个测试/ lint命令

Step 2) Scope-lock kickoff

步骤2) 锁定范围启动

  • 한 번에 한 작업(버그 1개/기능 1개)만 지정한다.
  • Aider 프롬프트에 반드시 포함:
    • 변경 대상 파일 범위
    • 수용 기준(acceptance criteria)
    • 테스트/검증 명령
  • 一次仅指定一项任务（1个漏洞/1个功能）
  • Aider提示中必须包含：
    • 目标文件的修改范围
    • 验收标准
    • 测试/验证命令

Step 3) Test-backed edit loop

步骤3) 基于测试的编辑循环

  1. 기준 테스트 실행(실패/성공 기준선 확보)
  2. Aider로 수정
  3. 테스트 재실행
  4. diff 확인 후 필요 시 추가 수정
  1. 执行基准测试（确定失败/成功基准线）
  2. 使用Aider进行修改
  3. 重新执行测试
  4. 查看diff后，如有需要进行额外修改

Step 4) Commit hygiene

步骤4) 提交规范

  • git add -p
    로 변경 범위를 검토
  • 커밋 메시지는 의도 + 검증 명령을 포함
  • 리스크(실험적 패치, flaky test, 미검증 경로)는 커밋/보고서에 명시
  • 使用
    git add -p
    审查变更范围
  • 提交信息需包含意图 + 验证命令
  • 风险（实验性补丁、不稳定测试、未验证路径）需在提交/报告中明确说明

Step 5) Fallback

步骤5) 回退方案

  • 변경이 과도하게 퍼지면 즉시 범위를 축소하고 재시도
  • 테스트가 반복적으로 깨지면 Aider 자동 수정 루프를 멈추고 원인 분석으로 전환
  • 若变更范围过度扩散，立即缩小范围并重试
  • 若测试反复失败，停止Aider自动修改循环，切换至原因分析

Output format

输出格式

markdown
undefined
markdown
undefined

Aider Run Brief

Aider 运行简报

  • Goal:
  • Scope:
  • Validation commands:
  • Changed files:
  • Risks / follow-ups:
undefined
  • 目标:
  • 范围:
  • 验证命令:
  • 修改文件:
  • 风险 / 后续工作:
undefined

Examples

示例

Example 1: small bugfix loop

示例1：小型漏洞修复循环

  • Goal: failing unit test 1개를 green으로 복구
  • Scope: 테스트 파일 + 관련 구현 파일만 편집
  • Validation: 
    pytest -q tests/path/test_x.py
  • 目标：将1个失败的单元测试恢复为通过状态
  • 范围：仅编辑测试文件 + 相关实现文件
  • 验证：
    pytest -q tests/path/test_x.py

Example 2: narrow feature increment

示例2：窄范围功能增量

  • Goal: API 필드 1개 추가 + 역호환 유지
  • Scope: schema + handler + 테스트
  • Validation: 기존 테스트 + 신규 테스트
  • 目标：添加1个API字段 + 保持向后兼容
  • 范围：schema + 处理器 + 测试
  • 验证：现有测试 + 新增测试

Best practices

最佳实践

  1. 항상 baseline 테스트 결과를 먼저 확보한다.
  2. 파일 범위를 명시하지 않은 Aider 세션은 시작하지 않는다.
  3. 커밋 전에 
    git add -p
    로 불필요 변경을 제거한다.
  4. flaky/실험적 변경은 리스크를 명시하고 후속 TODO를 남긴다.
  1. 始终先获取基准测试结果
  2. 不启动未明确文件范围的Aider会话
  3. 提交前使用
    git add -p
    移除不必要的变更
  4. 不稳定/实验性变更需明确标注风险，并留下后续待办事项

References

参考资料