Community编程与开发github.com

juliusbrussee/spec

创建、修改或回传(backprop)Bug 到仓库根目录的 SPEC.md 文件。该技能是项目规格文档的唯一修改器,在用户要求编写规格、启动新规格、从现有代码中提取规格、添加不变量、修改章节(§G、§C、§I、§V、§T、§B)或通过回传记录 Bug 时触发。

spec 是什么?

这个名为「juliusbrussee/spec」的 AI 技能专门用于管理项目根目录下的 SPEC.md 规格文档。它充当该文件的唯一编辑器,确保规格修改的集中与可追溯性。该技能响应多种自然语言触发短语,例如“编写 [项目] 的规格”、“新规格”、“Bug:……”、“修改 §V.3”、“从代码中提取规格”或“将这个想法写成规格”。它还支持通过“回传”(backprop)机制记录 Bug,这有助于将已知问题固化为规格的一部分。该技能严格遵循项目根目录下 FORMAT.md 文件中定义的编码规则(caveman encoding)以及章节 §T(测试)和 §B(Bug)的管道表格格式。它支持在所有流行的 AI 代理平台(如 Claude Code、Cursor、Codex 等)上使用,为开发者提供了一种结构化的方式来创建和维护项目规格文档,并将错误处理集成到规格生命周期中。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/juliusbrussee/cavekit/tree/main/skills/spec

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

spec 是做什么的?

创建、修改或回传(backprop)Bug 到仓库根目录的 SPEC.md 文件。该技能是项目规格文档的唯一修改器,在用户要求编写规格、启动新规格、从现有代码中提取规格、添加不变量、修改章节(§G、§C、§I、§V、§T、§B)或通过回传记录 Bug 时触发。常见触发短语包括:“编写 [项目] 的规格”、“新规格”、“Bug:……”、“修改 §V.3”、“从代码中提取规格”、“将这个想法写成规格”。该技能会读取并遵循 FORMAT.md 中定义的原始人编码规则以及 §T 和 §B 章节的管道表格形状。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

juliusbrussee/backprop

Bug → spec protocol. When a bug is found or a test fails, trace the cause, decide whether a new §V invariant would catch recurrence, append to §B. This is the one non-obvious thing SDD does that plan-then-execute doesn't. Triggers on test failure, bug report, post-mortem, or explicit user ask.

juliusbrussee/build

Plan-then-execute implementation against SPEC.md. Native single-thread loop, no sub-agents. On test or build failure, auto-invokes the backprop skill before retrying — a failed verification always considers whether a new §V invariant would prevent recurrence. Triggers when the user asks to build, implement, execute the spec, or tackle a specific §T task (`build §T.3`, `build --next`, `implement next task`, `run the build`). Expects SPEC.md to exist; if not, defers to the spec skill.

juliusbrussee/caveman

Caveman encoding for SPEC.md and spec-adjacent writes. Loaded by /spec, /build, /check. Cuts tokens ~75% vs prose while staying precise. Triggers on any write to SPEC.md or when user says "caveman", "compress this", "be brief".

juliusbrussee/check

Read-only drift detector. Diffs SPEC.md against current code and reports violations grouped by severity. Writes nothing — suggests remedies via the spec or build skills but never invokes them. Triggers when the user asks to check drift, audit the spec, verify invariants, or ask whether code still matches the spec. Phrasings: "check drift", "audit the spec", "does the code still match §V", "check invariants", "spec vs code".

相关技能