Aide Skill 技能

技能简介

Aide 是一套面向 Claude Code、Codex、OpenCode 和 GitHub Copilot 的「Spec-Driven Development」规格驱动开发套件。它把每一次改动先落成 4 个 Markdown 规格文件（description / analysis / solution / status），再用本地 Dashboard 把整套 create → analyze → implement → archive 流程串起来，让 AI CLI 真正"按图施工"而非即兴发挥。

核心能力

• 四段式规格工作流：1-description.md 写问题与验收，2-analysis.md 检索代码库事实，3-solution.md 形成实施计划，4-status.md 记录每一步成本、token 与产出。
• aide-* 技能族：/aide-create、/aide-analyze、/aide-implement、/aide-archive，每一步对应一个 Markdown 规格阶段，可在 Claude Code、Codex、OpenCode、Copilot 之间无缝接力。
• 本地 Dashboard：默认监听 http://127.0.0.1:8788，列出全部规格、串行排队 create→analyze→implement→archive，记录每步花费、token 消耗和产出结果，规格未勾选验收前不会归档。
• 跨 CLI 接力：同一份规格被 Claude Code、Codex、OpenCode、Copilot 任意一方读写延续，每一步可挑最合适的工具执行，规格本身作为工作交接载体。
• Git 友好的可审计：规格目录提交到项目仓库或独立 specs 仓库，决策理由、受影响文件、变更前 diff 都留底，一月后仍能复盘。

安装配置

• 克隆仓库：git clone https://github.com/ragnarwestad/aide 到本地任意目录。
• 在 Claude Code / Codex / OpenCode / Copilot 中加载 aide-* 技能族，按工具文档约定暴露读取路径即可生效。
• 启动 Dashboard：aide dashboard（默认 127.0.0.1:8788），按提示登录即可。

使用步骤

• 第一步：在项目根目录运行 /aide-create，生成 1-description.md 与初始 status.md。
• 第二步：人工或自动触发 /aide-analyze，让 AI 扫一遍代码库，写出 2-analysis.md（受影响文件、行号、风险点）。
• 第三步：触发 /aide-implement，按 solution.md 的工作流执行代码改动，status.md 实时写入每一步成本。
• 第四步：验收勾选 acceptance criteria 后，触发 /aide-archive 归档，规格随 git 提交留作团队知识资产。

适用场景

• 重构或迁移类大改动：先写规格让 AI 分析影响面，再实施，避免无规格代码 review 散乱。
• 跨工具接力：让 Claude Code 写规格、Codex 执行实现、Copilot 跑 review，规格即协议。
• 团队代码审计：每改一处都留规格底，PR 评审时直接对照 acceptance criteria。
• 客户定制项目：规格目录提交到客户仓库，第三方接手时直接读规格继续推进。
• 长尾维护：1 个月后回头看，规格目录就是完整的决策日志。

适用人群

• 独立开发者：用规格约束 AI 不"幻觉"，告别 chat 里跑题的工作记忆。
• 技术负责人：让 AI CLI 在团队里按统一规格协作，避免风格漂移。
• 咨询 / 外包团队：把交付物全部写成规格，客户随时可读可改。
• AI 重度用户：把 chat 里消失的决策理由固化到 git，与他人共享。

工作原理

Aide 的核心思想是把"对话里瞬时成立"的事——决策理由、受影响文件、行号——沉淀到一组 Markdown 文件里。规格被所有支持 Agent 平等读写，每一步骤是单一职责的 aide-* 命令，Dashboard 充当调度器与审计器。规格目录本身就是 git 提交对象，能 diff、能回滚、能跨会话延续。

官方链接

• GitHub: https://github.com/ragnarwestad/aide