메뉴
devbooks-brownfield-bootstrap：存量项目初始化：在当前真理目录为空时生成项目画像、术语表、SSOT、基线规格与最小验证锚点，避免"边补 specs 边改行为"。用户说"存量初始化/基线 specs/项目画像/建立 glossary/初始化 SSOT/把老项目接入上下文协议"等时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
devbooks-delivery-workflow：完整闭环编排器，在支持子 Agent 的 AI 编程工具中调用，自动编排 Proposal→Design→Spec→Plan→Test→Implement→Review→Archive 全流程。用户说"跑一遍闭环/完整交付/从头到尾跑完/自动化变更流程"等时使用。
devbooks-ssot-maintainer：维护项目 SSOT 的"可寻址索引与派生进度视图"。用于"修改/同步 SSOT（上游或项目内）→ 生成可审计 delta → 同步 requirements.index.yaml →（可选）刷新 requirements.ledger.yaml"。通常由 `/devbooks:delivery` 在 `request_kind=governance` 路由下调用。注意：SSOT 初始化请使用 `brownfield-bootstrap`。
devbooks-knife：把 Epic 级需求切成可拓扑排序的 Slice 队列，并落盘机读 Knife Plan（用于高风险/史诗级变更的 G3 强制闸门）。
devbooks-archiver：归档阶段的唯一入口，负责完整的归档闭环（自动回写→规格合并→文档同步检查→变更包归档移动）。用户说"归档/archive/收尾/闭环/合并到真理"等时使用。
devbooks-coder：以 Coder 角色严格按 tasks.md 实现功能并跑闸门，禁止修改 tests/，以测试/静态检查为唯一完成判据。用户说"按计划实现/修复测试失败/让闸门全绿/实现任务项/不改测试"，或在 DevBooks apply 阶段以 coder 执行时使用。
devbooks-docs-consistency：检查并维护项目文档与代码的一致性，支持增量扫描、自定义规则与完备性检查。可在变更包内按需运行或全局检查。旧名称 devbooks-docs-sync 保留为别名并输出弃用提示。
| name | devbooks-brownfield-bootstrap |
| description | devbooks-brownfield-bootstrap：存量项目初始化：在当前真理目录为空时生成项目画像、术语表、SSOT、基线规格与最小验证锚点，避免"边补 specs 边改行为"。用户说"存量初始化/基线 specs/项目画像/建立 glossary/初始化 SSOT/把老项目接入上下文协议"等时使用。 |
| recommended_experts | ["System Architect","Technical Writer"] |
| allowed-tools | ["Glob","Grep","Read","Write","Edit","Bash"] |
目标：明确本 Skill 的核心产出与使用范围。 输入：用户目标、现有文档、变更包上下文或项目路径。 输出：可执行产物、下一步指引或记录路径。 边界：不替代其他角色职责，不触碰 tests/。 证据：引用产出物路径或执行记录。
适用：需要细化策略、边界或风险提示时补充。
适用：需要与外部系统或可选工具协同时补充。
| Skill | 职责 | 类比 |
|---|---|---|
| brownfield-bootstrap | 创建 SSOT/Spec 骨架（从无到有） | git init |
| ssot-maintainer | 维护 SSOT（增删改已有条目） | git commit |
关键区分：
ssot/ 目录不存在或为空时，生成骨架ssot-maintainer 负责维护：当 SSOT 已存在后，处理 delta、同步索引、刷新 ledgerssot-maintainer| 维度 | SSOT | Spec |
|---|---|---|
| 抽象层次 | 需求层（What） | 设计层（How） |
| 粒度 | 项目级 | 模块级 |
| 位置 | <devbooks-root>/ssot/ | <truth-root>/ |
| 内容 | 系统必须做什么 | 模块如何工作 |
详见 docs/SSOT与Spec边界说明.md
<truth-root>：当前真理目录根（通常是 dev-playbooks/specs/）<change-root>：变更包目录根（通常是 dev-playbooks/changes/）<devbooks-root>：DevBooks 管理目录（通常是 dev-playbooks/）执行前必须按以下顺序查找配置（找到后停止）：
.devbooks/config.yaml（如存在）→ 解析并使用其中的映射dev-playbooks/project.md（如存在）→ Dev-Playbooks 协议，使用默认映射project.md（如存在）→ template 协议，使用默认映射关键约束：
agents_doc（规则文档），必须先阅读该文档再执行任何操作存量项目初始化包含以下职责：
在 <devbooks-root>/（通常是 dev-playbooks/）下检查并创建：
| 文件 | 用途 | 创建条件 |
|---|---|---|
constitution.md | 项目宪法（GIP 原则） | 文件不存在时 |
project.md | 项目上下文（技术栈/约定） | 文件不存在时 |
创建方式：
constitution.md：基于默认 GIP 原则，可根据项目特性调整project.md：根据代码分析结果填充：
在 <truth-root>/_meta/ 下生成：
| 产物 | 路径 | 说明 |
|---|---|---|
| 项目画像 | _meta/project-profile.md | 三层架构的详细技术画像 |
| 术语表 | _meta/glossary.md | 统一语言表（可选但推荐） |
| 文档维护元数据 | _meta/docs-maintenance.md | 文档风格与维护配置 |
| 领域概念 | _meta/key-concepts.md | 基于代码语义的概念提取（可选） |
在 <devbooks-root>/ssot/ 下生成 SSOT 骨架：
| 产物 | 路径 | 说明 |
|---|---|---|
| SSOT 文档 | ssot/SSOT.md | 人类可读的需求/约束文档 |
| 需求索引 | ssot/requirements.index.yaml | 机读索引（稳定 ID → 锚点 → statement） |
生成策略：骨架优先 + 渐进补全
核心契约提取（AI 主导）
置信度标记
confidence: low|medium|highmediumhigh最小可行 SSOT
ssot-maintainer 渐进补全上游 SSOT 处理：
SSOT docs/）ssot/SSOT.md 中写入指针/链接requirements.index.yaml 建立稳定 ID 与锚点索引在 <truth-root>/architecture/ 下生成：
| 产物 | 路径 | 数据来源 |
|---|---|---|
| C4 架构地图 | architecture/c4.md | 综合分析（可选结合结构化能力） |
| 模块依赖图 | architecture/module-graph.md | 结构化依赖分析（可选） |
| 技术债热点 | architecture/hotspots.md | 变更历史 + 复杂度分析（可选） |
| 分层约束 | architecture/layering-constraints.md | 代码分析（可选） |
设计决策：C4 架构地图现在由 brownfield-bootstrap 在初始化时生成，后续架构变更通过 design.md 的 Architecture Impact 章节记录，由 archiver 在归档时合并。
在 <change-root>/<baseline-id>/ 下生成：
| 产物 | 说明 |
|---|---|
proposal.md | 基线范围、In/Out、风险 |
design.md | 现状盘点（capability inventory） |
specs/<cap>/spec.md | 基线 spec deltas（ADDED 为主） |
verification.md | 最小验证锚点计划 |
在初始化时可选生成项目的“代码地图”（取决于可用的结构化代码分析能力）：
| 产物 | 路径 | 数据来源 |
|---|---|---|
| C4 架构地图 | <truth-root>/architecture/c4.md | 综合分析 |
| 模块依赖图 | <truth-root>/architecture/module-graph.md | 结构化依赖分析（可选） |
| 技术债热点 | <truth-root>/architecture/hotspots.md | 变更历史 + 复杂度分析（可选） |
| 领域概念 | <truth-root>/_meta/key-concepts.md | 代码语义概念提取（可选） |
| 项目画像 | <truth-root>/_meta/project-profile.md | 综合分析 |
初始化时生成的 C4 地图应包含：
输出格式：
# C4 Architecture Map
## System Context
[描述系统边界与外部交互]
## Container Diagram
| Container | 技术栈 | 职责 |
|-----------|--------|------|
| <name> | <tech> | <responsibility> |
## Component Diagram
### <Container Name>
| Component | 职责 | 依赖 |
|-----------|------|------|
| <name> | <responsibility> | <dependencies> |
## Architecture Guardrails
### Layering Constraints
| 层级 | 可依赖 | 禁止依赖 |
|------|--------|----------|
| <layer> | <allowed> | <forbidden> |
热点分数 = 变更频率 × 圈复杂度
自动区分：
src/、lib/、app/ 等（可修改）node_modules/、vendor/、.venv/ 等（不可变接口）dist/、build/、*.generated.* 等（禁止手动修改）references/存量项目初始化.mdreferences/代码导航策略.mdtemplates/项目画像模板.mdreferences/存量项目初始化提示词.mdreferences/术语表模板.md本 Skill 在执行前自动检测上下文，选择合适的初始化范围。
检测规则参考：skills/_shared/上下文检测模板.md
<devbooks-root>/constitution.md 是否存在<devbooks-root>/project.md 是否存在<truth-root>/ 是否为空或基本为空| 模式 | 触发条件 | 行为 |
|---|---|---|
| 全新初始化 | devbooks-root 不存在或为空 | 创建完整目录结构 + constitution + project + 画像 |
| 补充配置 | constitution/project 缺失 | 只补充缺失的配置文件 |
| 完整初始化 | truth-root 为空 | 生成所有基础产物（画像/基线/验证） |
| 增量初始化 | truth-root 部分存在 | 只补充缺失产物 |
| 结构化分析 | 结构化能力可用 | 使用依赖关系与引用追踪增强画像 |
| 文本分析 | 仅文本检索可用 | 使用传统分析方法 |
检测结果：
- devbooks-root：存在
- constitution.md：不存在 → 将创建
- project.md：不存在 → 将创建
- truth-root：为空
- 结构化能力：可用
- 项目规模：中型（~50K LOC）
- 运行模式：补充配置 + 完整初始化 + 结构化分析