Menu
devbooks-entropy-monitor：定期采集系统熵度量（结构熵/变更熵/测试熵/依赖熵），生成量化报告，当指标超阈值时建议重构。用户说"熵度量/复杂度趋势/重构预警/代码健康/技术债务度量"等时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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-entropy-monitor |
| description | devbooks-entropy-monitor：定期采集系统熵度量（结构熵/变更熵/测试熵/依赖熵），生成量化报告，当指标超阈值时建议重构。用户说"熵度量/复杂度趋势/重构预警/代码健康/技术债务度量"等时使用。 |
| recommended_experts | ["Performance Engineer","System Architect"] |
| allowed-tools | ["Glob","Grep","Read","Bash"] |
目标：明确本 Skill 的核心产出与使用范围。 输入：用户目标、现有文档、变更包上下文或项目路径。 输出：可执行产物、下一步指引或记录路径。 边界：不替代其他角色职责，不触碰 tests/。 证据：引用产出物路径或执行记录。
适用：需要细化策略、边界或风险提示时补充。
适用：需要与外部系统或可选工具协同时补充。
来源：《人月神话》第16章"没有银弹" — "软件实体的复杂性是根本属性...控制复杂性是软件开发的关键"
<truth-root>：当前真理目录根<change-root>：变更包目录根执行前必须按以下顺序查找配置（找到后停止）：
.devbooks/config.yaml（如存在）→ 解析并使用其中的映射dev-playbooks/project.md（如存在）→ Dev-Playbooks 协议，使用默认映射project.md（如存在）→ template 协议，使用默认映射关键约束：
agents_doc（规则文档），必须先阅读该文档再执行任何操作系统熵 = 代码复杂度随时间的增长趋势
熵度量的目标：
~/.claude/skills/_shared/references/AI行为规范.md（可验证性 + 结构质量守门）。references/熵度量方法论.md。| 脚本 | 用途 | 示例 |
|---|---|---|
entropy-measure.sh | 采集熵指标 | entropy-measure.sh --project-root /path/to/repo |
entropy-report.sh | 生成报告 | entropy-report.sh --output report.md |
| 指标 | 采集方式 | 健康阈值 | 说明 |
|---|---|---|---|
| 圈复杂度均值 | 静态分析 | < 10 | 函数级平均 |
| 圈复杂度 P95 | 静态分析 | < 20 | 95 分位数 |
| 文件行数 P95 | 行数统计 | < 500 | 过大文件预警 |
| 函数行数 P95 | 静态分析 | < 50 | 过长函数预警 |
| 指标 | 采集方式 | 健康阈值 | 说明 |
|---|---|---|---|
| 热点文件占比 | git log | < 0.1 | 频繁修改的文件占比 |
| 耦合变更率 | git log | < 0.3 | 经常一起修改的文件对比例 |
| 代码流失率 | git diff | < 0.5 | 新增代码在30天内被删除的比例 |
| 指标 | 采集方式 | 健康阈值 | 说明 |
|---|---|---|---|
| Flaky 测试占比 | CI 日志 | < 0.01 | 不稳定测试占比 |
| 测试覆盖率 | 覆盖工具 | > 0.7 | 代码覆盖率 |
| 测试/代码比 | 行数统计 | > 0.5 | 测试代码与生产代码比例 |
| 指标 | 采集方式 | 健康阈值 | 说明 |
|---|---|---|---|
| 过期依赖占比 | npm/pip audit | < 0.2 | 超过2个大版本的依赖 |
| 安全漏洞数 | 安全扫描 | = 0 | 高危漏洞数量 |
| 依赖深度 P95 | 依赖树分析 | < 10 | 传递依赖层数 |
| 产物 | 路径 | 说明 |
|---|---|---|
| 熵报告 | <truth-root>/_meta/entropy/entropy-report-YYYY-MM-DD.md | 当次采集报告 |
| 历史数据 | <truth-root>/_meta/entropy/history.json | 所有历史指标 |
| 阈值配置 | <truth-root>/_meta/entropy/thresholds.json | 可配置阈值 |
| 项目规模 | 建议频率 | 触发方式 |
|---|---|---|
| 小型（< 10K LOC） | 每周 | 手动 / CI 定时 |
| 中型（10K-100K LOC） | 每日 | CI 定时 |
| 大型（> 100K LOC） | 每次合并 | PR 合并触发 |
| Skill | 关系 |
|---|---|
| devbooks-reviewer | 熵度量不嵌入每次 review，作为独立任务 |
| devbooks-proposal-author | 熵报告可作为重构提案的数据支撑 |
| devbooks-impact-analysis | 高熵区域变更需更谨慎的影响分析 |
thresholds.json 管理，不硬编码history.json本 Skill 在执行前自动检测上下文，选择合适的采集范围。
检测规则参考：skills/_shared/上下文检测模板.md
| 模式 | 触发条件 | 行为 |
|---|---|---|
| 首次采集 | 历史数据不存在 | 执行完整采集并建立基线 |
| 增量采集 | 距上次采集超过间隔 | 采集新数据并对比趋势 |
| 预警模式 | 检测到指标超阈值 | 生成预警报告并建议重构 |
检测结果：
- 历史数据：存在（15 条记录）
- 上次采集：2026-01-10
- 超阈值指标：2 个（圈复杂度 P95、热点文件占比）
- 运行模式：增量采集 + 预警模式