메뉴
devbooks-impact-analysis：跨模块/跨文件/对外契约变更前做影响分析，产出可直接写入 proposal.md 的 Impact 部分（Scope/Impacts/Risks/Minimal Diff/Open Questions）。用户说"做影响分析/改动面控制/引用查找/受影响模块/兼容性风险"等时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
devbooks-brownfield-bootstrap：存量项目初始化：在当前真理目录为空时生成项目画像、术语表、SSOT、基线规格与最小验证锚点，避免"边补 specs 边改行为"。用户说"存量初始化/基线 specs/项目画像/建立 glossary/初始化 SSOT/把老项目接入上下文协议"等时使用。
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 执行时使用。
| name | devbooks-impact-analysis |
| description | devbooks-impact-analysis：跨模块/跨文件/对外契约变更前做影响分析，产出可直接写入 proposal.md 的 Impact 部分（Scope/Impacts/Risks/Minimal Diff/Open Questions）。用户说"做影响分析/改动面控制/引用查找/受影响模块/兼容性风险"等时使用。 |
| recommended_experts | ["System Architect"] |
| allowed-tools | ["Glob","Grep","Read","Bash"] |
目标：明确本 Skill 的核心产出与使用范围。 输入：用户目标、现有文档、变更包上下文或项目路径。 输出：可执行产物、下一步指引或记录路径。 边界：不替代其他角色职责，不触碰 tests/。 证据：引用产出物路径或执行记录。
适用：需要细化策略、边界或风险提示时补充。
适用：需要与外部系统或可选工具协同时补充。
<truth-root>：当前真理目录根<change-root>：变更包目录根执行前必须按以下顺序查找配置（找到后停止）：
.devbooks/config.yaml（如存在）→ 解析并使用其中的映射dev-playbooks/project.md（如存在）→ Dev-Playbooks 协议，使用默认映射project.md（如存在）→ template 协议，使用默认映射关键约束：
agents_doc（规则文档），必须先阅读该文档再执行任何操作<change-root>/<change-id>/proposal.md 的 Impact 部分impact-analysis.md 文件（后续回填到 proposal.md）黄金法则：直接写入文档，禁止输出到对话窗口
Edit 或 Write 工具将分析结果直接写入目标文档<文件路径>"| 场景 | ❌ 错误行为 | ✅ 正确行为 |
|---|---|---|
| 分析完成 | 在对话中输出完整 Impact 表格 | 使用 Edit 工具写入 proposal.md |
| 通知用户 | 复述分析内容 | "影响分析已写入 changes/xxx/proposal.md" |
| 大量结果 | 分页输出到对话 | 全部写入文件，告知文件位置 |
用户：分析一下修改 UserService 的影响
AI：[使用代码检索/引用追踪分析]
[使用 Edit 工具写入 proposal.md]
影响分析已写入 `changes/refactor-user/proposal.md` 的 Impact 部分。
- 直接影响：8 个文件
- 间接影响：12 个文件
- 风险等级：中等
如需查看详情，请打开该文件。
~/.claude/skills/_shared/references/AI行为规范.md（可验证性 + 结构质量守门）。Grep 搜索符号引用，Glob 查找相关文件。references/影响分析提示词.md。## Impact Analysis
### Scope
- 直接影响：X 个文件
- 间接影响：Y 个文件
### Impacts
| 文件 | 影响类型 | 风险等级 |
|------|----------|----------|
| ... | 直接调用 | 高 |
### Risks
- ...
### Minimal Diff
- ...
### Open Questions
- ...
本 Skill 在执行前自动检测上下文，选择合适的分析范围。
检测规则参考：skills/_shared/上下文检测模板.md
proposal.md 中是否已有 Impact 章节| 模式 | 触发条件 | 行为 |
|---|---|---|
| 新建分析 | Impact 章节不存在 | 执行完整影响分析 |
| 增量分析 | Impact 已存在，有新变更 | 更新受影响文件列表 |
| 结构化分析 | 结构化引用追踪可用 | 使用调用关系进行精确分析 |
| 文本分析 | 仅文本检索可用 | 使用 Grep 文本搜索分析 |
检测结果：
- proposal.md：存在，Impact 章节缺失
- 引用追踪能力：可用
- 运行模式：新建分析 + 结构化分析