القائمة
devbooks-entropy-monitor：定期采集系统熵度量（结构熵/变更熵/测试熵/依赖熵），生成量化报告，当指标超阈值时建议重构。用户说"熵度量/复杂度趋势/重构预警/代码健康/技术债务度量"等时使用。
التثبيت باستخدام 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-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、热点文件占比）
- 运行模式：增量采集 + 预警模式