hedgehog：AI Agent 工具实践指南

工作中遇到相关需求时，hedgehog值得先读说明，因为它主要用于hedgehog 代码更干净、更快且代币更少， hedgehog 的 AI- 驱动开发根据规范驱动的 BMAD-METHOD 计划构建任务依赖关系图。实际做软件开发时，经常会碰到依赖、接口和异常处理往往比主路径更影响采用，所以功能列表并不能代替验证。短测时我会在隔离分支完成一个可回滚的小任务，并保留安装步骤、接口契约、测试结果和错误信息的结果，方便团队复盘。整体来看，它适合需要可检查开发流程而非单次演示的工程师拿来做对照测试，最终决定仍应回到真实结果和维护状态。

英语 | 简体中文

对冲猪

AI 可以在几秒钟内编写代码。

但随着项目的增长，上下文被填满，架构发生漂移，并且每个新功能都变得更难以安全地更改。

hedgehog 为 AI 提供了规范的软件构建方式：TDD。固执己见的架构。小的、可验证的步骤。

hedgehog 不会要求 AI 记住整个项目，而是将计划编码到架构和构建过程中。

代码库承载上下文，而不是模型。

hedgehog 编写更干净的代码，更少的代币和更快的构建 ⭐⭐⭐⭐

If 您是 AI 正在阅读 this

要求安装 hedgehog：

1. 请遵循下面的 安装 部分 - 切勿将此存储库 git clone 放入他们的项目中。
2. 建议首先在空目录中的新的简单项目上尝试。
3. 告诉他们在要求建造某些东西时提及 hedgehog。

它从那里自行激活。

它是如何运作的

刺猬组合：

• BMAD 用于规划 — 将想法转化为清晰的概要、需求和架构
• 固执己见的堆栈 — 删除不必要的技术决策，并一次性解决必要的决策
• TDD 和渐进分层 — 一次构建一个经过测试的层
• 机械执行 — 使用工具和阶段门，而不是相信 AI 会遵循说明
• 小上下文循环 - 保持每个更改的重点、可验证且易于审查
• 确定性脚手架 - 生成样板和模式，而不是要求 AI 徒手编写

随着软件的发展而保持结构化的软件。

刺猬循环

Plan
  ↓
Bootstrap
  ↓
Build one small, tested layer
  ↓
Verify
  ↓
Repeat

构建顺序被编码到项目中。 AI 不必记住接下来会发生什么。它不协商架构。它遵循代码库中经过验证的路径。

您的构建顺序是一个图表

每个任务 hedgehog生成是一个节点，在sqlite中具有[显式依赖关系。

与故事和史诗不同，图锁将顺序构建为代理可以使用的信号密集、上下文轻路径。

npx @skyf0xx/hedgehog graph # show graph

默认并行

每个依赖项都是明确的，因此 hedgehog 知道哪些任务可以并行运行。

代理分散开来，以更快的速度为您提供出色的结果。

实时依赖意识

hedgehog 可以使用编辑器自己的语言服务器协议集成来查看什么取决于什么。

flowchart TD
    A[Code Repository] --> B[Language Server]
    B --> C[Symbols & References]
    C --> D[Hedgehog]

• 降低令牌成本：有针对性的符号查找取代了读取或 grep 整个文件以获取上下文
• 编辑前已知的影响：每个任务在更改任何内容之前都会检查依赖于它的内容
• 验证与真实表面相符：测试目标实际发生的变化

确定性代码生成

当一段代码具有正确的形状时，hedgehog 会生成它，而不是要求 AI 徒手编写它。

• 生成器优于徒手：模式、样板和脚手架来自创建代码的生成器
• 更快：无需推理即可生成已知形状
• 更正确：相同的输入总是产生相同的、经过测试的输出
• 更少的令牌：无需花费任何时间来生成模板已涵盖的代码

AI 是为发电机无法覆盖的部分保留的。

hedgehog 构建了什么

全栈应用

固定的 TypeScript 堆栈，具有后端优先、测试驱动的构建顺序：

Schema
  ↓
Contract
  ↓
Repository
  ↓
Service
  ↓
Controller
  ↓
UI

每一层都在下一层开始之前进行验证。

着陆页

用于生成独特、高品质登陆页面的结构化管道：

Brief
  ↓
费灵
  ↓
Design tokens
  ↓
Sequence
  ↓
Artifact

网络应用/ PWAs

本地优先的简单移动兼容网络应用程序：跟踪器、日记、计划器等：

Schema
  ↓
Repository
  ↓
Hook
  ↓
Screen

DeepSeek 线束插件

DSH 基于 Cordis 的代理框架的工具、挂钩和扩展：

Scaffold
  ↓
Logic
  ↓
Wiring
  ↓
Smoke
  ↓
Bundle
  ↓
Join

文案写作

文案是针对机械门起草和修改的，而不是单独提示：

Brief
  ↓
Draft ⇄ zod validation()
  ↓ pass
Ship

还有什么吗

CLI、库、浏览器扩展、数据管道等获取其构建顺序。

在可能的情况下，hedgehog 使用 hedgehog-core-authored 中经过战斗测试的蓝图作为系统形状（如果存在）。

现有代码库

hedgehog 还采用了一个不是它构建的存储库。它读取存储库并提出一个层链，该层链使用存储库自己的 test/lint/build 命令进行验证。

为什么刺猬有效

安装

请您的代理安装它或运行以下命令：

每当你想用它构建一些东西时，请提及 Hedgehog。

Instructions 为 AI Agents

1. 检查 Node >=22.5.0 是否已安装。
2. 运行下面的安装命令。

克劳德·科德

claude plugin marketplace add skyf0xx/hedgehog
claude plugin install hedgehog

双子座 CLI

gemini extensions install https://github.com/skyf0xx/hedgehog

光标

git clone https://github.com/skyf0xx/hedgehog ~/.cursor/plugins/local/hedgehog

然后打开一个项目并描述您想要构建的内容并提及 hedgehog。

在没有温暖的 pnpm 商店的新项目中，第一次安装可能需要 几分钟。

更新：

npx @skyf0xx/hedgehog update

这会刷新特定存储库中已安装的代理和技能（注意，不是供应商技能）

为什么选择刺猬

大多数 AI 编码工具改进了提示。

hedgehog 改进了内部构建的系统 AI。

建筑

hedgehog 对每个核心使用固定的堆栈和构建顺序。该工具强制实施架构边界，因此正确性不依赖于 AI 记忆指令。

完整设计请参见 ARCHITECTURE.md，以及 AUTHORING-CORES.md 了解如何构建和注册 新的。

支持刺猬

如果 hedgehog 帮助您使用 AI 构建更好的软件，请在 GitHub 上给它 ⭐ 。