agentsop-aider
SOP for terminal-based, git-native AI pair programming with Aider (git work-tree + tree-sitter repo-map + edit-format + human-in-loop REPL). Use when editing code in an existing git repo via an LLM, when you need to converge a change to 2-5 files, pick an edit format that fits the model, run architect+editor mode, or wire an auto-test loop.
npx skills add agentsope/SkillAlchemy --skill agentsop-aider --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Aider SOP — 终端结对编程的操作系统 > 一句话：Aider 是“**git 工作树 + tree-sitter 仓库地图 + 编辑格式 + 人类在环 REPL**”的四元组。理解这四个原语，剩下的都是配置。 ## 1. 何时激活本技能 下列任一情形成立时，按本 SOP 进入 Aider 工作模式： - 任务是**编辑已有 git 仓库**里的代码（不是从零起项目）。 - 你能把改动范围**收敛到 2–5 个文件**，或愿意先用 `/ask` 让模型借助 repo-map 把范围找出来。 - 你需要**逐步可回滚**的修改历史（每次编辑一个 commit，`/undo` 一步回退）。 - 你在**终端**里工作（tmux / 远程 ssh / CI）；或者你在写一个把 Aider 当子进程驱动的 agent。 - 你关心**编辑格式对模型质量的影响**（diff / udiff / whole / patch 的选择问题）。 - 你需要 BYOM（自带模型），跑本地 LLM 或非主流厂商。 **不应激活的反面信号**：见 §6 反模式与边界。 ## 2. 核心心智模型 ### 2.1 四个原语 ``` +------------------+ +------------------+ +------------------+ +------------------+ | 1. Git working | | 2. Tree-sitter | | 3. Edit format | | 4. REPL loop | | tree | | repo-map | | (wire proto) | | (你在环里) | | | | | | | | | | - per-edit | | - symbol-level | | - diff / udiff | | - /ask /code | | commit | | summary | | / whole / | | /architect | | - /undo | | - PageRank over | | patch | | - 每轮人手确认 | | - dirty 文件 | | import graph | | - 模型适配选择 | | - 不自主 | | 先 commit 再编 | | - 动态预算 | | - JSON 是反模式 | | | +------------------+ +------------------+ +------------------+ +------------------+ ``` 四者缺一不可： - 去掉 git → 失去回滚与审计； - 去掉 repo-map → 大仓库里 LLM 找不到正确文件（SWE-Bench Lite 上 repo-map 让 Aide
- 1. 何时激活本技能
- 2. 核心心智模型
- 2.1 四个原语
- 2.2 LLM 看到的上下文分三层（优先级递减）
- 2.3 上下文预算（25k 信号阈）
- 2.4 Repo-map 不是 RAG
- 2.5 编辑格式是“模型适配问题”，不是“用户偏好”
- 3. SOP 工作流
- Phase 1 — Bootstrap（每次会话开始）
- Phase 2 — 收敛范围（/add 纪律）
- Phase 3 — 讨论再动手（/ask → /code）
- Phase 4 — Architect 模式（reasoning ≠ editing）
- Phase 5 — 验证（lint / test / run）
- Phase 6 — 上下文卫生
git status aider aider src/auth.py tests/test_auth.py --read CONVENTIONS.md aider --architect --model o1-preview --editor-model gpt-4o aider --test-cmd "pytest -x" --auto-test cd packages/feature-foo && aider --subtree-only
What does the agentsop-aider skill do?
SOP for terminal-based, git-native AI pair programming with Aider (git work-tree + tree-sitter repo-map + edit-format + human-in-loop REPL). Use when editing code in an existing git repo via an LLM, when you need to converge a change to 2-5 files, pick an edit format that fits the model, run architect+editor mode, or wire an auto-test loop.
How do I install it?
Run `npx skills add agentsope/SkillAlchemy --skill agentsop-aider --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From agentsope/SkillAlchemy, a repository with 255 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.