snapshot before v0.5 refactor

.opencode/skills/length-budget/SKILL.md

@@ -0,0 +1,205 @@
+---
+name: length-budget
+description: 报告字数预算分配与执行校验。规定综述/研究/投资/管理各类型的最低字数、章节配额算法、字数自检逻辑、不足时的补写策略。dr-plan 用于 Phase 1 分配配额，dr-pm 和 dr-analyst 用于 Phase 2 执行校验。
+---
+
+# 字数预算系统（硬性 KPI）
+
+## 一、报告类型与字数下限
+
+| 报告类型 | 最小字数 | 建议章节数 | 典型单章字数 |
+|---|---|---|---|
+| 综述类（领域全景、技术综述） | **10,000** | 8-10 章 | 1,000-1,250 |
+| 研究类（深度专题、竞品研究） | **30,000** | 10-12 章 | 2,500-3,000 |
+| 投资报告（赛道/公司分析） | **20,000** | 10-12 章 | 1,700-2,000 |
+| 管理/工艺类（运营分析、SOP） | **15,000-25,000** | 9-11 章 | 1,700-2,200 |
+
+**总字数 = 正文字数**，不含：摘要、目录、参考文献、附录。
+
+---
+
+## 二、章节配额分配算法（dr-plan 用）
+
+### Step 1：确定总字数目标
+- 综述类 → 12,000 字（下限 10,000，留 20% 缓冲）
+- 研究类 → 35,000 字（下限 30,000）
+- 投资类 → 22,000 字
+- 管理类 → 18,000 字（按选定）
+
+### Step 2：按章节重要性分层
+
+```
+P0 章（2-3 章）：核心论点章，字数配额 = 总字数 × 15-18% 每章
+P1 章（3-5 章）：主干证据章，字数配额 = 总字数 × 8-12% 每章
+P2 章（2-3 章）：辅助分析章，字数配额 = 总字数 × 5-8% 每章
+引言+结论：每章 总字数 × 6-10%
+```
+
+### Step 3：验证总和
+
+- 所有章节配额之和应等于总字数目标（±5%）
+- 任意两章字数差距 **不超过 ±30%**（避免头重脚轻）
+- 结论章必须 ≥ 总字数 10%
+
+### Step 4：Section 分配
+
+每章内：
+- 每 section 最少 **800 字**（不够则合并 section）
+- 章内 section 数量控制在 2-5 个
+- 每个 section 下可分 sub-section（300-500 字）
+
+### 示例（研究类 35,000 字 / 11 章）
+
+| 章 | 定位 | 字数配额 | 占比 |
+|---|---|---|---|
+| 第 1 章 引言与边界 | intro | 2,100 | 6% |
+| 第 2 章 核心观点（P0） | P0 | 5,250 | 15% |
+| 第 3 章 机制剖析（P0） | P0 | 5,250 | 15% |
+| 第 4 章 临床证据（P1） | P1 | 3,850 | 11% |
+| 第 5 章 竞争格局（P1） | P1 | 3,500 | 10% |
+| 第 6 章 产业链（P1） | P1 | 3,150 | 9% |
+| 第 7 章 政策监管（P1） | P1 | 2,800 | 8% |
+| 第 8 章 风险（P2） | P2 | 2,100 | 6% |
+| 第 9 章 国际对比（P2） | P2 | 1,750 | 5% |
+| 第 10 章 趋势判断 | P1 | 2,450 | 7% |
+| 第 11 章 结论与建议 | conclusion | 2,800 | 8% |
+| **合计** | | **35,000** | **100%** |
+
+验证：
+- ✅ 总和 = 35,000
+- ✅ 最大（5,250）/ 最小（1,750）= 3 倍 → ❌ 超过 ±30% 了，需调整
+- 调整：第 9 章升到 2,450（7%），从 P0 各降 400 → 验证通过
+
+---
+
+## 三、Phase 2 执行校验（dr-analyst/dr-pm 用）
+
+### dr-analyst 交稿前自检
+
+```
+章节完成后，执行：
+1. wc -w projects/<slug>/phase2/drafts/chXX.md
+   （中文字数用 Python：sum(1 for c in text if '\u4e00' <= c <= '\u9fff')）
+2. 对照 framework.md 的 "字数配额"：
+   - 实际 / 配额 < 0.7 → 不合格，继续挖掘
+   - 0.7 ≤ 实际 / 配额 < 0.85 → 警告，最好补足
+   - 0.85 ≤ 实际 / 配额 ≤ 1.3 → 合格
+   - 实际 / 配额 > 1.3 → 超纲，考虑拆分或精简
+```
+
+### dr-pm 汇总校验
+
+Phase 2 结束时：
+```
+1. 统计全文字数：Σ(chXX.md 字数)
+2. 对照 manifest.json 的 target_words：
+   - 如果 < 下限（10000/30000/20000/15000）→ ❌ 强制返工
+   - 在下限 ±5% → ⚠️ 需用户确认是否放行
+   - 超出下限 ≥ 10% → ✅ 合格
+3. 写入 manifest.json 的 phase2.word_stats
+```
+
+### 不足时的补写策略（重要）
+
+**不要让 analyst 为凑字数注水！** 字数不足的应对顺序：
+
+1. **检查证据覆盖**：该章观点是否有 ≥2 独立 Tier 1-2 信源？若无 → 检索补证据
+2. **展开数据细节**：把表格里的数字展开成文字分析（趋势、拐点、对比）
+3. **增加案例**：用 1-2 个具体公司/产品案例佐证抽象观点
+4. **补反方证据**：把反方证据段落写详细（500-800 字）
+5. **延伸推论**：对核心判断做 "若成立则..." 和 "若不成立则..." 分支讨论
+6. **国际对比**：若原文只讲中国，加一段国际对比
+7. **实在不行**：和 dr-pm 商量是否拆/并章节
+
+---
+
+## 四、字数计算工具（中英混排）
+
+```python
+def count_chinese_words(text: str) -> int:
+    """中英混排字数统计。中文字符 1 字，英文单词 1 字。"""
+    import re
+    chinese_count = sum(1 for c in text if '\u4e00' <= c <= '\u9fff')
+    # 去掉所有中文字符后，按空格切英文
+    text_no_cn = re.sub(r'[\u4e00-\u9fff]', ' ', text)
+    english_words = len(re.findall(r'[A-Za-z]+(?:[-\'][A-Za-z]+)*', text_no_cn))
+    return chinese_count + english_words
+```
+
+使用：
+```bash
+python3 -c "
+import sys, re
+with open(sys.argv[1]) as f:
+    text = f.read()
+cn = sum(1 for c in text if '\u4e00' <= c <= '\u9fff')
+en = len(re.findall(r'[A-Za-z]+(?:[-\'][A-Za-z]+)*', re.sub(r'[\u4e00-\u9fff]', ' ', text)))
+print(f'中文字数: {cn}, 英文词数: {en}, 总计: {cn+en}')
+" projects/<slug>/phase2/drafts/ch01.md
+```
+
+### 不计入字数的部分
+- 代码块 ```...```
+- Markdown 表格线框（|---|）
+- 引用块 `> `
+- 标题的 `#` 符号
+- 链接的 URL（`[文字](url)` 只计文字部分）
+
+---
+
+## 五、manifest.json 字段规范
+
+```json
+{
+  "slug": "glp1-obesity-2026",
+  "topic": "GLP-1 减重药物竞争格局与投资机会",
+  "type": "研究类",
+  "target_words": 35000,
+  "min_words": 30000,
+  "chapters_planned": 11,
+  "phase1": {
+    "approved": true,
+    "approved_at": "2026-04-20T10:00:00Z",
+    "framework_path": "projects/glp1-obesity-2026/phase1/framework.md",
+    "chapter_quotas": [
+      {"index": 1, "title": "...", "quota": 2100, "priority": "intro"},
+      {"index": 2, "title": "...", "quota": 5250, "priority": "P0"},
+      ...
+    ]
+  },
+  "phase2": {
+    "started_at": "...",
+    "progress": "7/11",
+    "chapters": [
+      {
+        "index": 1,
+        "draft_path": "projects/.../drafts/ch01.md",
+        "actual_words": 2180,
+        "quota": 2100,
+        "status": "completed",
+        "sources_count": 12,
+        "tbd_claims": 0
+      }
+    ],
+    "word_stats": {
+      "total": 34820,
+      "target": 35000,
+      "gap_pct": -0.5,
+      "verdict": "合格"
+    }
+  }
+}
+```
+
+---
+
+## 六、硬规则总结
+
+1. ✅ 综述 ≥10,000 字；研究 ≥30,000 字；投资 ≥20,000 字；管理 ≥15,000 字
+2. ✅ 章节字数差距 ≤ ±30%
+3. ✅ 每 section ≥800 字
+4. ✅ 结论章 ≥ 全文 10%
+5. ✅ Phase 2 每章完成自检字数
+6. ✅ 不足下限强制返工
+7. ❌ 禁止为凑字数注水（空洞形容词、套话、重复表述）
+8. ❌ 禁止"打折"交稿