pdd-skills 3.0.0

package/skills/entropy/expert-entropy-auditor/SKILL.md

@@ -0,0 +1,276 @@
+---
+name: expert-entropy-auditor
+description: 熵增审计技能，发现设计意图与代码实现之间的裂痕。当用户需要技术债务审计或AI残渣检测时自动触发。支持中文触发：审计技术债务、PRD一致性、AI残渣检测。
+  
+  核心职责：识别分散在代码库中的"AI残渣"，建议归集到共享的实用程序包中。
+license: MIT
+compatibility: 需要 PRD 文档和代码库
+metadata:
+  author: "neuqik@hotmail.com"
+  version: "1.0"
+---
+
+# 熵增审计 (expert-entropy-auditor)
+
+## 核心理念
+
+> "像垃圾回收器一样，将分散在代码库中的'AI残渣'识别出来，并建议将其归集到共享的实用程序包中。" —— Harness Engineering
+
+熵增审计技能专门用于发现"设计意图"与"代码实现"之间的裂痕，识别代码库中的熵增点。
+
+## 审计维度
+
+### 1. PRD 与代码一致性
+
+**审计方法**：
+- 解析 PRD 文档中的功能点
+- 扫描代码实现
+- 对比功能点与实现
+
+**示例**：
+```
+PRD 功能点：用户登录后显示欢迎消息
+代码实现：用户登录后直接跳转到首页
+→ 审计结果：实现与 PRD 不一致
+```
+
+### 2. Spec 文档与代码一致性
+
+**审计方法**：
+- 解析 Spec 文档中的技术规格
+- 检查代码是否符合规格
+- 标记偏差
+
+**示例**：
+```
+Spec 规格：API 返回 { code, data, message }
+代码实现：API 返回 { status, result }
+→ 审计结果：返回格式不符合规格
+```
+
+### 3. AI 残渣检测
+
+**什么是 AI 残渣**：
+- 重复生成的相似代码
+- 猜测的数据结构
+- 不一致的命名模式
+- 分散的辅助工具
+
+**检测方法**：
+- 代码相似度分析
+- 命名模式分析
+- 重复代码检测
+
+**示例**：
+```
+文件 A：function formatDate(date) { ... }
+文件 B：function formatDateString(d) { ... }
+文件 C：function dateFormat(dateVal) { ... }
+→ 审计结果：AI 残渣，建议提取到共享工具包
+```
+
+### 4. 技术债务累积
+
+**检测方法**：
+- 扫描 TODO/FIXME/HACK 注释
+- 检查临时方案标记
+- 统计技术债务数量
+
+**示例**：
+```
+技术债务统计：
+- TODO: 15 个
+- FIXME: 3 个
+- HACK: 2 个
+→ 审计结果：技术债务累积，建议处理
+```
+
+---
+
+## 审计流程
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   收集      │ ──→ │   分析      │ ──→ │   评分      │ ──→ │   报告      │
+│             │     │             │     │             │     │             │
+│ • PRD 文档  │     │ • 一致性    │     │ • 熵值计算  │     │ • 问题清单  │
+│ • Spec 文档 │     │ • 重复检测  │     │ • 债务评估  │     │ • 改进建议  │
+│ • 代码实现  │     │ • 模式分析  │     │ • 风险评级  │     │ • 优先排序  │
+└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘
+```
+
+---
+
+## 熵值评分系统
+
+### 评分维度
+
+| 维度 | 权重 | 评分标准 |
+|------|------|---------|
+| PRD 一致性 | 25% | 功能点与实现匹配度 |
+| Spec 一致性 | 25% | 技术规格符合度 |
+| AI 残渣 | 25% | 重复代码比例 |
+| 技术债务 | 25% | 债务数量与严重度 |
+
+### 评分计算
+
+```
+熵值 = 100 - (不一致数 × 5 + AI残渣数 × 3 + 技术债务数 × 2)
+
+示例：
+- PRD 不一致：2 项 → 扣 10 分
+- Spec 不一致：1 项 → 扣 5 分
+- AI 残渣：5 项 → 扣 15 分
+- 技术债务：10 项 → 扣 20 分
+
+熵值 = 100 - (10 + 5 + 15 + 20) = 50
+```
+
+### 状态判定
+
+| 分数范围 | 状态 | 建议动作 |
+|---------|------|---------|
+| 90-100 | 优秀 | 维持现状 |
+| 70-89 | 良好 | 小额改进 |
+| 50-69 | 一般 | 计划性清理 |
+| 30-49 | 警告 | 优先处理 |
+| 0-29 | 危险 | 紧急重构 |
+
+---
+
+## 输出格式
+
+### 熵增审计报告
+
+```markdown
+# 熵增审计报告 - YYYY-MM-DD
+
+## 熵值评分：XX/100
+
+## 审计范围
+- PRD 文档：X 份
+- Spec 文档：X 份
+- 代码文件：X 个
+
+## 一致性审计
+
+### PRD 与代码不一致
+| PRD 功能点 | 代码实现 | 偏差描述 |
+|-----------|---------|---------|
+| FP-001 用户登录欢迎消息 | 未实现 | 缺少欢迎消息显示 |
+
+### Spec 与代码不一致
+| Spec 规格 | 代码实现 | 偏差描述 |
+|----------|---------|---------|
+| API 返回格式 | 不符合 | 缺少 message 字段 |
+
+## AI 残渣检测
+
+### 重复代码
+| 文件 A | 文件 B | 相似度 | 建议 |
+|-------|-------|-------|------|
+| utils/formatDate.js | utils/dateFormat.js | 85% | 提取到共享工具包 |
+
+### 猜测的数据结构
+| 文件 | 问题 | 建议 |
+|------|------|------|
+| service/UserService.ts | 硬编码字段名 | 定义类型接口 |
+
+## 技术债务统计
+
+| 类型 | 数量 | 平均存在时间 |
+|------|------|-------------|
+| TODO | 15 | 14 天 |
+| FIXME | 3 | 7 天 |
+| HACK | 2 | 30 天 |
+
+## 改进建议
+
+### 高优先级
+1. 修复 PRD 不一致项（2 项）
+2. 提取重复代码到共享工具包（5 项）
+
+### 中优先级
+1. 处理 FIXME 注释（3 项）
+2. 定义缺失的类型接口（3 项）
+
+### 低优先级
+1. 清理过时 TODO（12 项）
+```
+
+---
+
+## 配置选项
+
+```yaml
+# entropy-auditor-config.yaml
+entropy_auditor:
+  # 审计范围
+  scope:
+    prd_paths: ["docs/prd/", "docs/业务分析/"]
+    spec_paths: ["docs/specs/", "docs/dev-specs/"]
+    code_paths: ["src/"]
+  
+  # 检测阈值
+  thresholds:
+    code_similarity: 0.8      # 代码相似度阈值
+    max_todo_age_days: 30     # TODO 最大存在时间
+    max_fixme_age_days: 14    # FIXME 最大存在时间
+  
+  # 评分权重
+  weights:
+    prd_consistency: 0.25
+    spec_consistency: 0.25
+    ai_residue: 0.25
+    tech_debt: 0.25
+```
+
+---
+
+## 使用示例
+
+### 示例 1：全面熵增审计
+
+```
+用户：执行技术债务审计
+
+AI：
+1. 收集 PRD、Spec、代码
+2. 分析一致性
+3. 检测 AI 残渣
+4. 计算熵值评分
+5. 生成审计报告
+```
+
+### 示例 2：PRD 一致性检查
+
+```
+用户：检查 PRD 与代码是否一致
+
+AI：
+1. 解析 PRD 功能点
+2. 扫描代码实现
+3. 对比功能点与实现
+4. 生成偏差报告
+```
+
+### 示例 3：AI 残渣检测
+
+```
+用户：检测代码中的 AI 残渣
+
+AI：
+1. 代码相似度分析
+2. 命名模式分析
+3. 识别重复代码
+4. 建议提取到共享工具包
+```
+
+---
+
+## 与其他技能的协作
+
+- **pdd-entropy-reduction**：作为子技能被协调调用
+- **pdd-doc-gardener**：传递文档不一致问题
+- **expert-auto-refactor**：传递重构建议
+- **pdd-code-reviewer**：集成熵增检查到代码审查

package/skills/entropy/expert-entropy-auditor/_meta.json

@@ -0,0 +1 @@
+{"name": "expert-entropy-auditor", "version": "1.0.0", "category": "entropy", "description": "Entropy audit skill discovering gaps between design intent and code implementation. Trigger when auditing technical debt, checking PRD consistency, or detecting AI residue in codebase.", "triggers": ["审计技术债务", "PRD一致性", "AI残渣检测"]}

package/skills/entropy/expert-entropy-auditor/evals/default-evals.json

@@ -0,0 +1 @@
+[{"name": "SKILL.md-exists", "description": "技能文件存在且格式正确", "type": "structure", "expect": {"exists": true, "hasDescription": true}, "checks": {"file_exists": "SKILL.md"}}, {"name": "_meta.json-valid", "description": "元数据文件格式正确", "type": "structure", "expect": {"exists": true, "hasName": true, "hasVersion": true, "hasTriggers": true}, "checks": {"file_exists": "_meta.json"}}, {"name": "audit-dimensions-defined", "description": "定义了熵增审计维度(PRD一致性/AI残渣/架构漂移)", "type": "content", "contains": ["审计", "PRD", "AI残渣", "架构漂移", "设计意图"]}, {"name": "residue-patterns-defined", "description": "定义了AI残渣检测模式", "type": "content", "contains": ["残渣", "模式", "检测", "分散", "归集"]}, {"name": "report-output-defined", "description": "明确了审计报告输出格式", "type": "content", "contains": ["报告", "输出", "问题清单", "建议"]}]