ssci-subagent-skills 1.0.0

package/skills/grounded-theory-expert-enhanced/docs/02_task_flow.md

@@ -0,0 +1,464 @@
+# 任务流程与上下文返回
+
+**适用场景**: 执行具体任务时确定加载文档和返回位置
+
+---
+
+## 任务流程状态机（强制四专家并行）
+
+```
+                          ┌─────────────────┐
+                          │   用户请求      │
+                          └────────┬────────┘
+                                   ↓
+                          ┌─────────────────┐
+                          │  任务类型判断   │
+                          └────────┬────────┘
+                                   ↓
+              ┌────────────────────┼────────────────────┐
+              ↓                    ↓                    ↓
+        ┌───────────┐       ┌───────────┐       ┌───────────┐
+        │ 完整分析  │       │ 饱和度检验│       │  信度计算  │
+        └─────┬─────┘       └─────┬─────┘       └─────┬─────┘
+              │                   │                   │
+              ↓                   ↓                   ↓
+        ┌───────────┐       ┌───────────┐       ┌───────────┐
+        │四专家并行 │       │四专家交叉 │       │信度效度   │
+        │编码流程   │       │验证       │       │检验       │
+        └─────┬─────┘       └─────┬─────┘       └─────┬─────┘
+              │                   │                   │
+              ↓                   ↓                   ↓
+        ┌──────────────────────────────────────────────────────┐
+        │         阶段3/5/7: 一/二/三级编码流程                │
+        ├──────────────────────────────────────────────────────┤
+        │  现象学专家→实证主义专家→建构主义专家→本土化专家    │
+        │       ↓           ↓           ↓           ↓          │
+        │   CLI调用1     CLI调用2     CLI调用3     CLI调用4     │
+        │       ↓           ↓           ↓           ↓          │
+        │   概念/范畴    概念/范畴    概念/范畴    概念/范畴    │
+        │                       ↓                                      │
+        │               Kappa信度计算                                │
+        │                       ↓                                      │
+        │               分歧解决/保留                                │
+        │                       ↓                                      │
+        │               最终概念/范畴列表                            │
+        └──────────────────────────────────────────────────────┘
+                          │
+                          ↓
+                   ┌─────────────────┐
+                   │  返回主流程     │
+                   │  或报告生成     │
+                   └─────────────────┘
+```
+
+**⚠️ 铁律**：
+1. **必须四专家并行**，即使只有一个CLI工具
+2. **每个专家必须单独调用**，不准合并调用
+3. **必须计算信度**，Kappa ≥ 0.65 才能继续
+4. **分歧必须解决或保留记录**
+
+---
+
+## 任务与返回位置对照表
+
+| 任务 | 加载文档 | 执行后返回 |
+|------|----------|-----------|
+| 完整分析 | `00_master_guide.md` + `02_task_flow.md` | 任务9/10 |
+| 预处理 | `prompts/preprocessing_prompts.md` | 任务2 |
+| 分段 | `02_task_flow.md` (分段规则) | 任务3 |
+| 一级编码 | `prompts/level1_prompts.md` + 专家文档 | 任务4 |
+| 一级共识 | `references/reliability_methods.md` | 任务5 |
+| 二级编码 | `prompts/level2_prompts.md` + 专家文档 | 任务6 |
+| 二级共识 | `references/reliability_methods.md` | 任务7 |
+| 三级编码 | `prompts/level3_prompts.md` + 专家文档 | 任务8 |
+| 理论构建 | `references/theory_construction.md` | 任务9 |
+| 饱和度检验 | `references/saturation_methods.md` | 任务10 |
+| 报告生成 | `02_task_flow.md` (报告模板) | 任务结束 |
+
+---
+
+## 上下文加载模板
+
+### 完整分析上下文
+
+```python
+CONTEXT_FOR_FULL_ANALYSIS = """
+当前任务: 完整扎根理论分析
+
+已加载文档:
+1. SKILL.md (主控文档)
+2. docs/00_master_guide.md (主控指南)
+3. docs/02_task_flow.md (任务流程)
+
+即将执行: 阶段1-10 完整分析
+
+当前阶段: 待定
+下一阶段: 需要用户指定或从阶段1开始
+
+请确认:
+- 项目路径
+- 源文档路径
+- 或直接开始分析
+"""
+```
+
+### 一级编码上下文（强制四专家并行）
+
+```python
+CONTEXT_FOR_LEVEL1_CODING = """
+当前任务: 一级编码（开放编码）- 强制四专家并行
+
+已加载文档:
+1. SKILL.md
+2. docs/prompts/level1_prompts.md
+3. docs/experts/phenomenological_expert.md
+4. docs/experts/positivist_expert.md
+5. docs/experts/constructivist_expert.md
+6. docs/experts/localization_expert.md
+
+⚠️ 铁律：必须四专家并行分析！
+
+执行流程:
+┌─────────────────────────────────────────────────────────────┐
+│  阶段3: 一级编码（开放编码）                                 │
+├─────────────────────────────────────────────────────────────┤
+│  步骤1: 现象学专家编码 → CLI调用1 → 输出: 体验性概念        │
+│  步骤2: 实证主义专家编码 → CLI调用2 → 输出: 操作性概念      │
+│  步骤3: 建构主义专家编码 → CLI调用3 → 输出: 建构性概念      │
+│  步骤4: 本土化专家编码 → CLI调用4 → 输出: 本土化概念        │
+│  步骤5: 计算编码者间信度（Cohen's Kappa ≥ 0.65）           │
+│  步骤6: 分歧解决 → 最终概念列表                             │
+└─────────────────────────────────────────────────────────────┘
+
+输入: 02_segmentation/segment_70%/segment_text.txt
+输出: 03_level1_coding/expert_*/open_coding_results.json
+
+即使只有一个CLI工具可用，也必须调用4次（每个专家一次）！
+
+可用的CLI工具:
+- codebuddy（主用）
+- claude（备选）
+- gemini（备选）
+- qwen（备选）
+
+专家分配（理想状态）:
+- 现象学专家 → codebuddy
+- 实证主义专家 → claude
+- 建构主义专家 → gemini
+- 本土化专家 → qwen
+
+单一CLI时的处理:
+codebuddy -y "以现象学专家身份..."
+codebuddy -y "以实证主义专家身份..."
+codebuddy -y "以建构主义专家身份..."
+codebuddy -y "以本土化专家身份..."
+
+输出示例:
+{
+  "expert": "phenomenological",
+  "concepts": [
+    {"id": 1, "name": "体验概念", "full_name": "体验_概念名", "raw_quote": "..."}
+  ]
+}
+"""
+```
+
+### 饱和度检验上下文
+
+```python
+CONTEXT_FOR_SATURATION_TEST = """
+当前任务: 理论饱和度检验
+
+已加载文档:
+1. SKILL.md
+2. docs/references/saturation_methods.md
+
+检验方法: 单文档分段法（70%+10%+10%+10%）
+
+判定标准:
+- 最后两批新概念比例 < 5% → 饱和
+- 最后两批新概念比例 5-10% → 基本饱和
+- 最后两批新概念比例 > 10% → 未饱和
+
+迭代结果:
+- 迭代1 (70%): 累积 N1 概念
+- 迭代2 (80%): 累积 N2 概念，新增 X1
+- 迭代3 (90%): 累积 N3 概念，新增 X2
+- 迭代4 (100%): 累积 N4 概念，新增 X3
+
+判定: {saturation_verdict}
+置信度: {confidence}
+
+返回位置: 任务10（报告生成）
+"""
+```
+
+---
+
+---
+
+## 一级共识与分歧解决流程
+
+```python
+LEVEL1_CONSENSUS_WORKFLOW = """
+当前任务: 一级编码共识计算
+
+已加载文档:
+1. docs/references/reliability_methods.md
+
+执行步骤:
+┌─────────────────────────────────────────────────────────────┐
+│  一级共识计算流程                                           │
+├─────────────────────────────────────────────────────────────┤
+│  步骤1: 收集四位专家的概念列表                              │
+│  步骤2: 计算Cohen's Kappa (编码者间信度)                   │
+│  步骤3: 分析分歧点                                          │
+│  步骤4: 专家讨论（调用LLM进行分歧分析）                    │
+│  步骤5: 解决分歧或保留分歧记录                              │
+│  步骤6: 生成最终概念列表                                    │
+└─────────────────────────────────────────────────────────────┘
+
+Cohen's Kappa 判断标准:
+- < 0: 无一致
+- 0.00-0.20: 轻微一致
+- 0.21-0.40: 尚可一致
+- 0.41-0.60: 中度一致
+- 0.61-0.80: 高度一致（达标）
+- 0.81-1.00: 几乎完全一致
+
+信度不足处理（Kappa < 0.65）:
+1. 重新编码：检查编码规则
+2. 专家讨论：分析分歧原因
+3. 保留分歧：在报告中标注
+
+分歧解决策略:
+- 策略1: 重新编码 → 分歧源于编码规则不清晰
+- 策略2: 专家讨论 → 分歧源于理论视角不同
+- 策略3: 保留分歧 → 分歧反映真实概念差异
+"""
+```
+
+---
+
+## 二级编码专家流程
+
+```python
+CONTEXT_FOR_LEVEL2_CODING = """
+当前任务: 二级编码（轴心编码）- 强制四专家并行
+
+已加载文档:
+1. docs/prompts/level2_prompts.md
+2. docs/experts/*.md (四位专家)
+
+执行流程:
+┌─────────────────────────────────────────────────────────────┐
+│  阶段5: 二级编码（轴心编码）                                │
+├─────────────────────────────────────────────────────────────┤
+│  步骤1: 现象学专家 → 构建意义关联网络                       │
+│  步骤2: 实证主义专家 → 量化范畴关系                         │
+│  步骤3: 建构主义专家 → 社会建构分析                         │
+│  步骤4: 本土化专家 → 文化特殊性范畴                         │
+│  步骤5: Kappa信度计算（≥0.65）                             │
+│  步骤6: 分歧解决 → 最终范畴列表                             │
+└─────────────────────────────────────────────────────────────┘
+
+输出示例:
+{
+  "expert": "phenomenological",
+  "categories": [
+    {"id": 1, "name": "范畴名", "properties": [...], "dimensions": [...]}
+  ],
+  "paradigm": {
+    "causal": "...",
+    "context": "...",
+    "action": "...",
+    "consequence": "..."
+  }
+}
+"""
+```
+
+---
+
+## 三级编码专家流程
+
+```python
+CONTEXT_FOR_LEVEL3_CODING = """
+当前任务: 三级编码（选择编码）- 强制四专家并行
+
+已加载文档:
+1. docs/prompts/level3_prompts.md
+2. docs/experts/*.md (四位专家)
+
+执行流程:
+┌─────────────────────────────────────────────────────────────┐
+│  阶段7: 三级编码（选择编码）                                │
+├─────────────────────────────────────────────────────────────┤
+│  步骤1: 四专家分别识别核心范畴                              │
+│  步骤2: 比较核心范畴选择                                    │
+│  步骤3: 构建故事线                                          │
+│  步骤4: 提炼理论命题                                        │
+│  步骤5: 计算范畴间一致性                                    │
+│  步骤6: 分歧解决 → 核心范畴与理论框架                       │
+└─────────────────────────────────────────────────────────────┘
+
+核心范畴判断标准:
+1. 与其他范畴关联最频繁
+2. 能解释大部分变异
+3. 能在理论层面抽象
+4. 具有足够的普遍性
+"""
+```
+
+---
+
+## 饱和度检验（四专家交叉验证）
+
+```python
+SATURATION_TEST_WORKFLOW = """
+当前任务: 理论饱和度检验 - 四专家交叉验证
+
+已加载文档:
+1. docs/references/saturation_methods.md
+
+执行流程:
+┌─────────────────────────────────────────────────────────────┐
+│  阶段9: 饱和度检验                                          │
+├─────────────────────────────────────────────────────────────┤
+│  步骤1: 现象学专家评估 → 体验性概念饱和度                   │
+│  步骤2: 实证主义专家评估 → 操作性概念饱和度                 │
+│  步骤3: 建构主义专家评估 → 建构性概念饱和度                 │
+│  步骤4: 本土化专家评估 → 本土化概念饱和度                   │
+│  步骤5: 交叉验证 → 综合饱和度结论                           │
+└─────────────────────────────────────────────────────────────┘
+
+单文档分段法（70%+10%+10%+10%）:
+- 迭代1 (70%): 累积 N1 概念
+- 迭代2 (80%): 新增 X1 概念, 比例 {X1/N1}%
+- 迭代3 (90%): 新增 X2 概念, 比例 {X2/N1}%
+- 迭代4 (100%): 新增 X3 概念, 比例 {X3/N1}%
+
+饱和度判定:
+- 最后两批新概念比例 < 5% → 饱和
+- 最后两批新概念比例 5-10% → 基本饱和
+- 最后两批新概念比例 > 10% → 未饱和
+
+四专家交叉验证:
+- 现象学: {saturation_p}%
+- 实证主义: {saturation_s}%
+- 建构主义: {saturation_c}%
+- 本土化: {saturation_l}%
+- 综合: {saturation_avg}%
+"""
+```
+
+---
+
+## 信度效度检验
+
+```python
+RELIABILITY_VALIDITY_WORKFLOW = """
+当前任务: 信度效度检验
+
+已加载文档:
+1. docs/references/reliability_methods.md
+
+┌─────────────────────────────────────────────────────────────┐
+│  信度检验                                                   │
+├─────────────────────────────────────────────────────────────┤
+│  编码者间信度: Cohen's Kappa ≥ 0.65                         │
+│  多专家信度: Fleiss' Kappa ≥ 0.65                           │
+│  缺失数据: Krippendorff's Alpha ≥ 0.67                      │
+└─────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────┐
+│  效度检验                                                   │
+├─────────────────────────────────────────────────────────────┤
+│  内容效度: I-CVI ≥ 0.78 (3-5位专家)                         │
+│  构念效度: AVE > 0.50                                       │
+│  区分效度: 相关系数 < AVE平方根                             │
+│  表面效度: 原始引文支持                                     │
+└─────────────────────────────────────────────────────────────┘
+
+输出示例:
+{
+  "reliability": {
+    "cohens_kappa": 0.72,
+    "interpretation": "高度一致（达标）"
+  },
+  "validity": {
+    "content_validity": "通过",
+    "construct_validity": "通过"
+  }
+}
+"""
+```
+
+---
+
+### 返回到主流程
+
+```python
+def return_to_main_flow(current_task: str, result: Dict) -> str:
+    """
+    返回到主分析流程
+    
+    Args:
+        current_task: 当前执行的任务
+        result: 任务执行结果
+    
+    Returns:
+        返回指令（指向下一个任务或等待用户确认）
+    """
+    task_return_points = {
+        "preprocessing": "继续到任务2（分段）",
+        "segmentation": "继续到任务3（一级编码）",
+        "level1_coding": "继续到任务4（一级共识）",
+        "level1_consensus": "继续到任务5（二级编码）",
+        "level2_coding": "继续到任务6（二级共识）",
+        "level2_consensus": "继续到任务7（三级编码）",
+        "level3_coding": "继续到任务8（理论构建）",
+        "theory_construction": "继续到任务9（饱和度检验）",
+        "saturation_test": "继续到任务10（报告生成）",
+        "report_generation": "分析完成，等待用户反馈"
+    }
+    
+    return task_return_points.get(current_task, "返回主流程")
+```
+
+### 等待用户确认
+
+```python
+WAIT_FOR_USER_TEMPLATE = """
+任务: {current_task}
+状态: {status}
+结果: {result_summary}
+
+下一步: {next_action}
+
+请确认是否继续，或提供下一步指令。
+"""
+```
+
+---
+
+## 错误处理与返回
+
+| 错误类型 | 处理方式 | 返回位置 |
+|---------|---------|---------|
+| 文件不存在 | 提示用户提供路径 | 等待输入 |
+| 目录已存在 | 询问是否覆盖或增量 | 等待确认 |
+| 信度不足 | 提示重新编码或讨论 | 任务3-7 |
+| 数据不足 | 提示补充数据 | 任务9 |
+| 格式错误 | 提示检查输入格式 | 等待修正 |
+
+---
+
+## 相关文档
+
+- **快速开始**: `01_quick_start.md`
+- **主控指南**: `00_master_guide.md`
+- **路径规范**: `03_path规范.md`
+- **专家角色**: `docs/experts/*.md`
+- **提示词**: `docs/prompts/*.md`
+- **方法论**: `docs/references/*.md`

package/skills/grounded-theory-expert-enhanced/docs/03_path/350/247/204/350/214/203.md

@@ -0,0 +1,161 @@
+# 路径规范
+
+**适用场景**: 使用 analysis_controller.py 时确定输入输出路径
+
+---
+
+## 完整目录结构
+
+```
+项目根目录/
+├── 📁 00_raw_data/
+│   └── source_document.txt              # 源文档（用户提供）
+├── 📁 01_preprocessing/
+│   ├── text_cleaned/cleaned_text.txt    # 清洗后文本
+│   └── text_tokenized/tokenized_text.json # 分词结果
+├── 📁 02_segmentation/
+│   ├── segment_70%/segment_text.txt     # 70%数据
+│   ├── segment_10_1%/segment_text.txt   # 10%数据
+│   ├── segment_10_2%/segment_text.txt   # 10%数据
+│   └── segment_10_3%/segment_text.txt   # 10%数据
+├── 📁 03_level1_coding/
+│   ├── expert_phenomenological/open_coding_results.json
+│   ├── expert_positivist/open_coding_results.json
+│   ├── expert_constructivist/open_coding_results.json
+│   └── expert_localization/open_coding_results.json
+├── 📁 04_level1_consensus/
+│   ├── consensus_calculation/cohens_kappa.json
+│   ├── consensus_calculation/fleiss_kappa.json
+│   ├── consensus_achievement/merged_concept_library.json
+│   └── consensus_achievement/consensus_report.json
+├── 📁 05_level2_coding/
+│   ├── expert_phenomenological/axial_coding_results.json
+│   ├── expert_positivist/axial_coding_results.json
+│   ├── expert_constructivist/axial_coding_results.json
+│   └── expert_localization/axial_coding_results.json
+├── 📁 06_level2_consensus/
+│   ├── consensus_calculation/
+│   └── divergence_resolution/integrated_categories.json
+├── 📁 07_level3_coding/
+│   ├── expert_phenomenological/selective_coding_results.json
+│   ├── expert_positivist/selective_coding_results.json
+│   ├── expert_constructivist/selective_coding_results.json
+│   └── expert_localization/selective_coding_results.json
+├── 📁 08_level3_consensus/
+│   ├── consensus_calculation/
+│   ├── theoretical_integration/integrated_theoretical_model.json
+│   └── story_line_generation/core_category_narrative.json
+├── 📁 09_saturation_test/
+│   ├── iteration_70%/saturation_indicators.json
+│   ├── iteration_80%/saturation_indicators.json
+│   ├── iteration_90%/saturation_indicators.json
+│   └── iteration_100%/final_saturation_verdict.json
+├── 📁 10_final_report/
+│   ├── comprehensive_analysis_report.md
+│   ├── project_summary.json
+│   └── theoretical_framework_diagram.png
+├── config.json
+├── project_manifest.json
+└── analysis_log.md
+```
+
+---
+
+## 数据流对照表
+
+| 阶段 | 输入 | 输出 |
+|------|------|------|
+| 1 | `00_raw_data/source_document.txt` | `01_preprocessing/text_cleaned/cleaned_text.txt` |
+| 2 | `01_preprocessing/cleaned_text.txt` | `02_segmentation/segment_70%/segment_text.txt` |
+| 3 | `02_segmentation/segment_70%/segment_text.txt` | `03_level1_coding/*/open_coding_results.json` |
+| 4 | `03_level1_coding/*/open_coding_results.json` | `04_level1_consensus/merged_concept_library.json` |
+| 5 | `04_level1_consensus/merged_concept_library.json` | `05_level2_coding/*/axial_coding_results.json` |
+| 6 | `05_level2_coding/*/axial_coding_results.json` | `06_level2_consensus/integrated_categories.json` |
+| 7 | `06_level2_consensus/integrated_categories.json` | `07_level3_coding/*/selective_coding_results.json` |
+| 8 | `07_level3_coding/*/selective_coding_results.json` | `08_level3_consensus/integrated_theoretical_model.json` |
+| 9 | `02_segmentation/*/segment_text.txt` | `09_saturation_test/iteration_*/final_saturation_verdict.json` |
+| 10 | `08_level3_consensus/*.json` | `10_final_report/comprehensive_analysis_report.md` |
+
+---
+
+## 路径标识符
+
+```python
+PATH_MAPPINGS = {
+    # 入口
+    "source_document": "00_raw_data/source_document.txt",
+    
+    # 预处理
+    "text_cleaned": "01_preprocessing/text_cleaned/",
+    "text_tokenized": "01_preprocessing/text_tokenized/",
+    
+    # 分段
+    "segmentation": "02_segmentation/",
+    "segment_70": "02_segmentation/segment_70%/",
+    "segment_10_1": "02_segmentation/segment_10_1%/",
+    "segment_10_2": "02_segmentation/segment_10_2%/",
+    "segment_10_3": "02_segmentation/segment_10_3%/",
+    
+    # 一级编码
+    "level1_coding": "03_level1_coding/",
+    "l1_expert_phen": "03_level1_coding/expert_phenomenological/",
+    "l1_expert_pos": "03_level1_coding/expert_positivist/",
+    "l1_expert_con": "03_level1_coding/expert_constructivist/",
+    "l1_expert_loc": "03_level1_coding/expert_localization/",
+    
+    # 一级共识
+    "level1_consensus": "04_level1_consensus/",
+    "l1_consensus_calc": "04_level1_consensus/consensus_calculation/",
+    "l1_achievement": "04_level1_consensus/consensus_achievement/",
+    
+    # 二级编码
+    "level2_coding": "05_level2_coding/",
+    
+    # 二级共识
+    "level2_consensus": "06_level2_consensus/",
+    
+    # 三级编码
+    "level3_coding": "07_level3_coding/",
+    
+    # 三级共识
+    "level3_consensus": "08_level3_consensus/",
+    
+    # 饱和度检验
+    "saturation_test": "09_saturation_test/",
+    "sat_iter_1": "09_saturation_test/iteration_70%/",
+    "sat_iter_2": "09_saturation_test/iteration_80%/",
+    "sat_iter_3": "09_saturation_test/iteration_90%/",
+    "sat_iter_4": "09_saturation_test/iteration_100%/",
+    
+    # 最终报告
+    "final_report": "10_final_report/",
+}
+```
+
+---
+
+## 使用示例
+
+```python
+from project_structure import GroundedTheoryProject
+
+project = GroundedTheoryProject(
+    project_path="D:/research/my_project",
+    project_name="我的研究"
+)
+
+# 获取路径
+l1_output = project.get_path("l1_expert_phen")
+# 返回: D:/research/my_project/03_level1_coding/expert_phenomenological/
+
+sat_result = project.get_path("sat_iter_2")
+# 返回: D:/research/my_project/09_saturation_test/iteration_80%/
+```
+
+---
+
+## 相关文档
+
+- **快速开始**: `01_quick_start.md`
+- **主控指南**: `00_master_guide.md`
+- **任务流程**: `02_task_flow.md`