Aide Skill：让 AI 编码助手先写规格说明书再动手的 Spec-Driven 开发框架

Skill超级捕获手 技术创作者 2026-10-05 1094 阅读

Aide Skill：让 AI 编码助手先写规格说明书再动手的 Spec-Driven 开发框架

这个 Skill 是什么、为什么火

Aide 是一个专为 AI 编码助手设计的 Spec-Driven Development（规格驱动开发）框架。它不直接让 Claude Code / Codex / OpenCode / Copilot 写代码，而是强制 AI 先写规格说明书——包含问题描述、代码分析、实现方案和状态追踪四份文档，再进入编码环节。2026 年 10 月 4 日，它登顶 GitHub Trending Claude Skills 实时榜单第一名，被认为是”让 AI 慢下来、先想清楚再动手”的最佳实践工具。

功能与核心原则

Aide 的核心理念：规格文档是源代码的唯一真实来源（Spec-Anchored），而非用完即弃的临时物。

四大工作流步骤：
– Create：/aide-create 从标题和描述生成规格文件夹（含 4 份 Markdown 文件）
– Analyze：/aide-analyze 对代码库进行分级分析（LOW/MEDIUM/HIGH），标注受影响文件和实现计划
– Implement：/aide-implement 测试先行（TDD：RED → GREEN → VERIFY），严格按分析结果执行
– Archive：/aide-archive 归档完成规格，合并代码分支，写入项目文档

此外还有 /aide-explore（方案探索）、/aide-manifest（项目配置）、/aide-wiki（构建项目知识库）、/aide-close（关闭不做的规格）、/aide-reopen（重新开启归档规格）等辅助 Skill。

认可度

截至 2026-10-05，Aide 登上 GitHub Trending Claude Skills 实时榜单 第 1 名（数据来源：linny006/trending-claude-skills，每 15 分钟刷新），是当天热度最高的 Claude Code 相关 Skill。GitHub Star 数为 1（刚发布，数据随时间变化）。支持 Claude Code、GitHub Copilot、OpenCode、Codex 四种主流 AI 编码工具。

链接

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

原作者

ragnarwestad（GitHub 个人开发者），专注于 Spec-Driven Development 理念在 AI 编码助手领域的工具化落地。项目采用 TypeScript 编写，macOS 和 Linux 均支持（Windows 需通过 WSL）。

详细介绍

Aide 解决了一个 AI 编码助手领域的核心问题：聊天记录消失，决策理由也随之消失。传统工作流中，AI 和人类在对话框里讨论需求、方案和实现细节，一旦开启新会话，历史推理过程全部归零，后续开发只能从零猜测上下文。

Aide 的规格文档结构让每一次决策都有据可查：
– 1-description.md：描述问题本身和”完成”的含义，由用户撰写或由 /aide-create 从标题和描述自动起草
– 2-analysis.md：/aide-analyze 对代码库的扫描结果，标注受影响文件及行号
– 3-solution.md：/aide-analyze 输出的实现计划，/aide-implement 必须严格遵循
– 4-status.md：记录每个工作流步骤的执行状态，验收标准（Acceptance Criteria）需用户逐条勾选后方可归档

这套结构与 Martin Fowler 在《Exploring Gen AI》中描述的 Spec-Driven Development 三层模型（Spec-First → Spec-Anchored → Spec-as-Source）相吻合，Aide 定位在第二层”规格锚定”。

Dashboard（本地 Web 应用，运行于 http://127.0.0.1:8788）支持批量管理多个规格，可选择 AI 类型和模型并行执行步骤，记录每轮 token 消耗和执行结果。

特点

  • 跨工具通用：同一规格文档可在 Claude Code、Copilot、Codex、OpenCode 之间无缝切换，不必重新解释上下文
  • 规格即文档：归档时自动将变更说明写入项目自身文档，规格仓库（specs repo）成为活的开发知识库
  • 测试先行编码：/aide-implement 强制 RED → GREEN → VERIFY 循环，代码改动必须先有测试失败，显著减少回归问题
  • 分级分析：根据变更规模（LOW/MEDIUM/HIGH）自动调节分析深度，小改动不会做过度的架构扫描
  • 不接受乱序执行：Analyze 未完成时 Implement 无法启动，确保 AI 不会跳步、不会凭空编造实现方案
  • Dashboard 可视化管理：浏览器界面统一管理所有规格项目，批量排队、分阶段执行，适合有多个并行需求的团队

使用方法

安装步骤：

# 1. 安装依赖工具
curl https://mise.run | sh
mise use -g node@lts

# 2. 安装 AI 编码工具（以 Claude Code 为例）
curl -fsSL https://claude.ai/install.sh | bash

# 3. 克隆 Aide 并运行安装脚本
git clone https://github.com/ragnarwestad/aide.git
cd aide && ./install-all.sh

# 4. 登录 Claude Code（只需一次）
claude  # 登录后输入 /exit 退出

# 5. 启动 Dashboard（可选）
# macOS: dashboard/install.sh（设为开机自启服务）
# Linux: dashboard/serve.sh（终端运行）

基本调用流程：

# 进入项目目录
cd your-project

# Step 1: 创建规格
/aide-create "迁移表单从 Redux Form 到 React Hook Form" "项目中的表单仍使用已停止维护的 Redux Form。需要逐个表单迁移到 React Hook Form，并保留原有验证规则。"

# Step 2: AI 分析（生成 2-analysis.md 和 3-solution.md）
/aide-analyze <规格编号>

# Step 3: AI 实现（测试先行）
/aide-implement <规格编号>

# Step 4: 归档
/aide-archive <规格编号>

最小示例（Dashboard 操作）：

  1. 在 Dashboard 的 Projects 页面添加项目（会自动克隆到本地）
  2. 在 New Spec 表单填写标题和描述，队列自动执行 Create → Analyze → Implement → Archive
  3. 在执行前勾选 Acceptance Criteria，全部勾选后规格方可归档

使用场景与目标人群

适用场景：
– 需要在多个 AI 编码工具之间协同工作的开发者（同一规格文档跨工具使用）
– 团队需要对 AI 生成代码进行可追溯、可审查的开发流程（规格文档进 Git，易于 Code Review）
– 需要管理多个并行规格的大型重构或功能开发项目（Dashboard 批量管理）
– 对 AI 生成代码质量有高要求、希望强制 TDD 流程的开发者

目标用户：
– 使用 Claude Code、Copilot、Codex、OpenCode 的专业开发者
– 希望 AI 编码过程更可控、更可追溯的工程师
– 实践 Spec-Driven Development 理念的团队

输入与输出案例

案例 1：表单迁移

  • Input（用户）：
    /aide-create "迁移表单到 React Hook Form" "Redux Form 已停止维护，需逐个表单迁移"
  • Output（规格文档结构）：
  • specs/001/1-description.md：问题描述和验收标准（用户填写）
  • specs/001/2-analysis.md：AI 扫描代码库，找到所有使用 Redux Form 的文件及行号
  • specs/001/3-solution.md：AI 输出的分步骤迁移计划
  • specs/001/4-status.md：create ✓ → analyze ✓ → implement 待执行

案例 2：分级分析

  • Input（小改动，LOW 级）：
    /aide-analyze 42 → 生成精简版分析，聚焦于改动的 3 个文件
  • Output（3-solution.md 片段）：
    “`
    受影响文件：
  • src/components/LoginForm.tsx:45 — useForm 初始化
  • src/hooks/useValidation.ts:12 — 验证规则导出
  • src/types/form.ts:8 — FormData 类型定义

实现计划：
1. 替换 useForm 引入，移除 Redux Form 依赖
2. 逐字段迁移验证规则至 useValidation hook
3. 运行表单交互测试验证
“`

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

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

评论区

0 条评论

登录后可评论。

Skill超级捕获手 1094 阅读