WangLiquan/specforge

SpecForge

🔍 在线看产物（无需安装）：落地页 · spec.html 示例

更轻的「定义需求 → 验证实现」闭环，做成两个 skill：

• specforge-draft —— 把一个模糊 idea，经访谈 + 拷问，变成一份单文件可视化的 *.spec.html，让你用最小成本看懂「AI 要做什么」并拍板。
• specforge-verify —— 拿着这份 spec.html 逐条比对你的代码，双出口：把判定回写进 spec.html（每条 AC 标上 pass/partial/fail/na + file:line 证据 + 覆盖率条），同时在对话里给差距清单——看完顺手就修。

spec 不再是一坨 markdown，而是人一眼能读、机器也能消费的 HTML 产物；verify 后它还会变成「需求 + 验收状态」的活文档，后续打开就知道哪条做了哪条没做。

<p align="center"> <a href="https://wangliquan.github.io/specforge/showcase.html"><img src="assets/spec-showcase.png" width="72%" alt="spec.html 示例：目标 / 主流程 / 待拍板决策 / 带编号的验收点清单"></a> </p> <p align="center">_{<code>draft</code> 产出的 <code>spec.html</code>　·　点图看在线示例　·　<code>verify</code> 把判定回写进同一份 spec，并在对话里给差距清单}</p>

---

为什么是它

模型越强，多 skill 编排越显臃肿；人越依赖模型写码，markdown spec 对人的阅读成本反而越高。SpecForge 押注三件不可替代物：

1. 稳定的机器可读 JSON 契约 —— spec 内嵌一份结构化验收点清单，不只给人看，也能被工具消费/校验。
2. 不可信文本安全读取 —— verify 把 spec.html 当纯文本抽取、绝不执行，验得安全、可随手跑。
3. 严格判定纪律 —— 逐条比对落地产物，定位不到内容绝不判 pass，差距直接落到 file:line、给到你去修。

先打开 在线 spec 示例 看一份真实生成出的 spec 长什么样。

---

安装

两条通道任选其一，命名空间隔离、可共存：npx skills 装出 /specforge-draft，plugin 装出 /specforge:specforge-draft。

方式 A：npx skills（skill 通道）

npx skills add WangLiquan/specforge                  # 一次装上 draft + verify
npx skills add WangLiquan/specforge --skill specforge-draft   # 只装其一
npx skills add WangLiquan/specforge -g               # 装到全局(所有项目可用)

装完用 npx skills list 自检。

安装落点随 agent / scope 变化（symlink 或 copy）。Claude Code 的 global 链接当前在上游仍有已知 issue（vercel-labs/skills #851 / #744），如遇 `~/.cl