About

Imported from akillness/jeo-skills (.agent-skills/aider-cli-workflow/SKILL.md). Install upstream with npx skills add akillness/jeo-skills --skill aider-cli-workflow. Copyright stays with the author.

Aider CLI Workflow

Name: aider-cli-workflow
Author: akillness

Use this skill when the user explicitly wants an Aider-based coding loop in a local repo.

When to use this skill

Aider 설치/초기 설정 확인부터 실행까지 한번에 정리해야 할 때
작은 기능/버그를 테스트 기준으로 AI pair-programming으로 처리할 때
Aider가 만든 변경을 커밋 단위로 검증/정리해야 할 때

When not to use

Hosted PR 리뷰/라벨/브랜치 보호 정책 중심 작업 (code-review, GitHub workflow 계열)
단순 Git 충돌/복구만 필요한 경우 (git-workflow)
루트 원인 디버깅 중심 작업 (debugging)

Instructions

Step 1) Preconditions

저장소 루트 확인: git rev-parse --show-toplevel
Aider 설치 확인: aider --version
기본 검증 명령 확인: 테스트/린트 명령 1개 이상 확보

Step 2) Scope-lock kickoff

한 번에 한 작업(버그 1개/기능 1개)만 지정한다.
Aider 프롬프트에 반드시 포함:
- 변경 대상 파일 범위
- 수용 기준(acceptance criteria)
- 테스트/검증 명령

Step 3) Test-backed edit loop

기준 테스트 실행(실패/성공 기준선 확보)
Aider로 수정
테스트 재실행
diff 확인 후 필요 시 추가 수정

Step 4) Commit hygiene

git add -p로 변경 범위를 검토
커밋 메시지는 의도 + 검증 명령을 포함
리스크(실험적 패치, flaky test, 미검증 경로)는 커밋/보고서에 명시

Step 5) Fallback

변경이 과도하게 퍼지면 즉시 범위를 축소하고 재시도
테스트가 반복적으로 깨지면 Aider 자동 수정 루프를 멈추고 원인 분석으로 전환

Output format

# Aider Run Brief
- Goal:
- Scope:
- Validation commands:
- Changed files:
- Risks / follow-ups:

Examples

Example 1: small bugfix loop

Goal: failing unit test 1개를 green으로 복구
Scope: 테스트 파일 + 관련 구현 파일만 편집
Validation: pytest -q tests/path/test_x.py

Example 2: narrow feature increment

Goal: API 필드 1개 추가 + 역호환 유지
Scope: schema + handler + 테스트
Validation: 기존 테스트 + 신규 테스트

Best practices

항상 baseline 테스트 결과를 먼저 확보한다.
파일 범위를 명시하지 않은 Aider 세션은 시작하지 않는다.
커밋 전에 git add -p로 불필요 변경을 제거한다.
flaky/실험적 변경은 리스크를 명시하고 후속 TODO를 남긴다.

References

Aider: https://github.com/Aider-AI/aider
Aider docs: https://aider.chat/

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/akillness-jeo-skills-aider-cli-workflow/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

akillness-jeo-skills-aider-cli-workflow.ocm.jsonjson

{
  "ocm": "1",
  "id": "akillness-jeo-skills-aider-cli-workflow",
  "kind": "skill",
  "name": "aider-cli-workflow",
  "description": "Runs a scope-locked, test-backed Aider coding loop with commit hygiene; use for local-repo AI pair-programming on one small feature or bug.",
  "publisher": "akillness",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "aider",
      "cli",
      "ai-pair-programming",
      "git",
      "test-driven",
      "code-review",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Runs a scope-locked, test-backed Aider coding loop with commit hygiene; use for local-repo AI pair-programming on one small feature or bug."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/akillness/jeo-skills",
      "path": ".agent-skills/aider-cli-workflow/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/akillness/jeo-skills/blob/HEAD/.agent-skills/aider-cli-workflow/SKILL.md",
      "key": "akillness/jeo-skills/.agent-skills/aider-cli-workflow/SKILL.md"
    },
    "allowed_tools": [
      "Bash",
      "Read",
      "Write",
      "Edit",
      "Glob",
      "Grep"
    ]
  },
  "instructions": "# Aider CLI Workflow\n\nUse this skill when the user explicitly wants an **Aider-based coding loop** in a local repo.\n\n## When to use this skill\n- Aider 설치/초기 설정 확인부터 실행까지 한번에 정리해야 할 때\n- 작은 기능/버그를 테스트 기준으로 AI pair-programming으로 처리할 때\n- Aider가 만든 변경을 커밋 단위로 검증/정리해야 할 때\n\n## When not to use\n- Hosted PR 리뷰/라벨/브랜치 보호 정책 중심 작업 (`code-review`, GitHub workflow 계열)\n- 단순 Git 충돌/복구만 필요한 경우 (`git-workflow`)\n- 루트 원인 디버깅 중심 작업 (`debugging`)\n\n## Instructions\n\n### Step 1) Preconditions\n1. 저장소 루트 확인: `git rev-parse --show-toplevel`\n2. Aider 설치 확인: `aider --version`\n3. 기본 검증 명령 확인: 테스트/린트 명령 1개 이상 확보\n\n### Step 2)",
  "cost": {
    "context_tokens": 439
  }
}

Fetch it by URL: GET /api/v1/registry/akillness-jeo-skills-aider-cli-workflow/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.