# Devbooks Void

> devbooks-void：Void 协议执行器：处理高熵/不确定/多方案争议问题，只产出 research_report + ADR + Freeze/Thaw 工件，不产出生产代码。用户说"进入 void/卡住了/不确定/需要调研/冻结解冻"等时使用。

- Skill: `majiayu000/devbooks-void` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/devbooks-void`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/devbooks-void/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/devbooks-void

---


# DevBooks：Void（高熵问题协议）

## 渐进披露
### 基础层（必读）
目标：把“输入不足/不确定/多方案争议”转换为可审计的知识与决策工件，并通过 Freeze/Thaw 控制后续执行。
输入：用户请求、变更包元数据（proposal front matter）、已存在的证据与 Gate Report（若有）。
输出（MUST）：
- `void/research_report.md`：结论、约束、证据来源、影响面、风险与下一步建议
- `void/ADR.md`：Context / Options / Decision / Consequences
- `void/void.yaml`：Freeze/Thaw 状态、阻塞问题清单、已解决问题与引用

边界（MUST）：
- Void 阶段不得产出生产代码变更；不得修改 tests/ 或 src/。
- Void 的产物必须可被脚本校验（见 `void-protocol-check.sh`）。

证据：Void 工件存在且非空；Freeze/Thaw 状态与变更包 state/next_action 一致。

### 进阶层（可选）
适用：需要把 research_report 的结论回写为 Truth（Decision/Constraints）或生成后续 Knife/Bootstrap 的输入索引时。

## 核心要点
- 先做配置发现（`.devbooks/config.yaml`）与规则文档读取，再进入 Void 输出。
- 结论必须可操作：包含明确的 next_action（Bootstrap/Knife/DevBooks）与阻塞解除条件。
- Freeze 时必须阻断后续执行；Thaw 必须链接 ADR 与证据，并记录吸收路径。

## 参考资料
- `dev-playbooks/specs/void/spec.md`