规格驱动开发的控制流程：获批 spec → 隔离分支 → 长任务 plan → TDD 实现 → 两轴各自审查与修复 → 主会话 runtime 验证 → 用户选择交付。init 独立负责项目约束、文档、guardrail 与 e2e harness。
dev-kit 还没合并进
main。 下面凡是指向main的地方，合并之前都要换成带 dev-kit 的分支。
pi install /path/to/skills/dev-kit执行 /reload 后，Pi 加载共享 skills。基础包不包含进程派发工具。
需要 subagent 时再单独安装可选包：
pi install /path/to/skills/dev-kit/.pi/extensions/subagent当前会话的工具集合要到 /reload 后才更新；工具列表出现 subagent 后，mode: subagent 的计划才能派发。移除时用 pi remove <pi list 中显示的本地 source>，再执行 /reload。
该包不创建或读取用户/项目 agent profile，也不保存 cheap / mid / strong 模型映射。主会话在每次派发时从当前可用模型中选择真实 provider/model。参数、权限 profile 与安全边界见包内 README。
插件清单在仓库根 .claude-plugin/marketplace.json，source 为 ./dev-kit：
/plugin marketplace add CodFrm/skills # 合并前改用本地路径：/path/to/skills
/plugin install dev-kit@codfrm-skills
插件安装是拷贝目录到 ~/.claude/plugins/cache/，工作区里未提交的改动它一律看不见。软链接过去，加载的就是工作区本身：
ln -s /path/to/skills/dev-kit ~/.claude/skills/dev-kit # skill 正文 + SessionStart hook
ln -s /path/to/skills/dev-kit/bin/devkit ~/.local/bin/devkit # 可选 CLI；换成你 PATH 上的目录- 两种装法不能并存，冲突时不报错。 插件按名字抢先，软链接那份会在
claude plugin list里变成✘ Not loaded，症状只是「改动突然不生效了」。先claude plugin uninstall dev-kit@codfrm-skills。 - 生效时机分三档：skill 正文下次 invoke 即生效；hook 注入的引导是会话开始时的快照，要新会话或
/clear；改hooks.json本身要重启 Claude Code。
按仓库根 README 的方式把链接交给智能体（main 换成带 dev-kit 的分支）：
帮我安装这个 skill：https://github.com/CodFrm/skills/tree/main/dev-kit/skills/brainstorming
这样只拿到 skill 正文，没有下面的 SessionStart hook 和 devkit 命令。
| Skill | 什么时候用 |
|---|---|
| using-dev-kit | 每个开发会话的开头，以及写代码、跑命令、向用户提问之前——这套 kit 的引导页 |
| init | 项目要立规矩，或老项目文档过期、没有护栏、同一类问题反复出现 |
| brainstorming | 行为、UI、合约、范围或其他需求边界尚未定案时形成获批 spec |
| writing-plans | 获批 spec 形成 plan；小改动写一个 compact task，较长改动拆 vertical slices |
| using-git-worktrees | 用户确认 spec 草稿没有问题、要把它和实现放进独立分支时，以及分支收尾交付时 |
| executing-plans | 已有定稿的 .dev-kit/plans/*.yaml 要推进或收尾 |
| test-driven-development | 实现新行为、修可复现的 bug、改公开契约——在写生产代码之前 |
| systematic-debugging | bug、测试失败、构建报错、性能回退、偶发故障、行为与 spec 不符——在提出修复方案之前 |
Unsettled work follows brainstorming → using-git-worktrees → writing-plans → test-driven-development inside executing-plans → two-axis review-and-fix wrap-up → main-session runtime verification → using-git-worktrees for delivery. 已定案的小改动直接走 TDD 或项目检查——brainstorming 谈完发现是小改动，也可以由用户选这条路，不写 spec 和 plan；只要还有会改变结果的需求或边界未决，就进 brainstorming。
Each skill owns its entry gate, state transitions and hand-off. using-dev-kit routes the initial request; executing-plans exclusively owns subagent review boundaries. init triggers independently.
devkit dashboard [--port <n>]——从用户注册表（devkit project add）起一个只读 dashboard，跨项目浏览 plan 与任务、预览 docs/specs/ 和 .dev-kit/artifacts/ 下的 mockup。装成 plugin 后会话内直接可用，否则按路径 node <plugin 根目录>/bin/devkit dashboard。
devkit plan <子命令> [--plan <slug>]——读写 .dev-kit/plans/ 下的 plan：next 列 ready 任务，show 出状态摘要或单个任务，check 把坏状态值与悬空 deps 报为错误、schema 外的键报为提示；set、task、review、context、verification 写回执行期可变字段——替换只改被寻址那个值所占的行（折叠标量会收成一行），追加插入新行、并把模板出厂的空列表 [] 那一行改写成键行，其余字节不变。逐条 flag 见 devkit help。
插件通过 hooks/hooks.json 注册，在会话 startup / resume / clear / compact 时把 using-dev-kit 正文注入上下文，省掉每次手动唤起。hooks/session-start 按当前 harness 选输出字段：Claude Code 要嵌套的 hookSpecificOutput，Codex（PLUGIN_ROOT）和 Copilot CLI 要顶层 additionalContext。读不到正文就静默退出，不注入任何东西。
node --test dev-kit/tests/*.test.js必须带上 *.test.js，写成 node --test dev-kit/tests/ 会以 MODULE_NOT_FOUND 失败。