ssci-subagent-skills 1.0.0

package/skills/performing-open-coding/references/examples.md

@@ -0,0 +1,338 @@
+# 开放编码实践案例
+
+> **渐进式披露**：本文档提供完整的编码案例。理论背景见 `theory.md`，问题解决见 `troubleshooting.md`。
+
+## 完整案例：大学生适应研究
+
+### 原始访谈数据
+
+```
+访谈对象：大一学生小李
+访谈时间：2024年3月
+
+"我刚进大学的时候，感觉特别不适应。课程比高中难很多，
+我经常听不懂老师讲的内容。有一次微积分考试，我只考了
+60分，感觉很沮丧。
+
+后来我主动去找老师，向他请教学习方法。老师很耐心地给
+我讲解，还推荐了一些参考书。我按照老师的建议，制定了
+详细的学习计划，每天坚持复习。
+
+我也和同学建立了学习小组，大家互相帮助。通过小组讨论，
+我对课程内容的理解更深入了。期末考试我考了85分，进步
+很大。
+
+除了学习，我还参加了学生会，认识了很多朋友。这让我更
+快地融入了大学生活。"
+```
+
+### 逐行编码过程
+
+#### 第1段分析
+
+**原文**：
+> "我刚进大学的时候，感觉特别不适应。"
+
+**编码**：
+- 概念：`体验不适应`
+- 定义：初次进入新环境时感到不适应的体验
+- 类型：情感概念
+- 示例："感觉特别不适应"
+
+---
+
+**原文**：
+> "课程比高中难很多，我经常听不懂老师讲的内容。"
+
+**编码**：
+- 概念：`遇到学习困难`
+- 定义：在学习过程中遇到理解障碍
+- 类型：一般概念
+- 示例："听不懂老师讲的内容"
+
+---
+
+**原文**：
+> "有一次微积分考试，我只考了60分，感觉很沮丧。"
+
+**编码**：
+- 概念：`经历学业挫折`
+- 定义：因学业表现不佳而产生的挫败感
+- 类型：情感概念
+- 示例："只考了60分，感觉很沮丧"
+
+#### 第2段分析
+
+**原文**：
+> "后来我主动去找老师，向他请教学习方法。"
+
+**编码**：
+- 概念：`寻求教师指导`
+- 定义：主动向教师寻求学习方法的指导
+- 类型：行动概念
+- 示例："主动去找老师，向他请教学习方法"
+
+---
+
+**原文**：
+> "老师很耐心地给我讲解，还推荐了一些参考书。"
+
+**编码**：
+- 概念：`获得教师支持`
+- 定义：从教师处获得学习上的帮助和资源
+- 类型：一般概念
+- 示例："老师很耐心地给我讲解，还推荐了一些参考书"
+
+---
+
+**原文**：
+> "我按照老师的建议，制定了详细的学习计划，每天坚持复习。"
+
+**编码**：
+- 概念：`制定学习计划`
+- 定义：根据建议制定系统的学习安排
+- 类型：行动概念
+- 示例："制定了详细的学习计划，每天坚持复习"
+
+#### 第3段分析
+
+**原文**：
+> "我也和同学建立了学习小组，大家互相帮助。"
+
+**编码**：
+- 概念：`建立同伴支持`
+- 定义：与同学建立互助学习关系
+- 类型：行动概念
+- 示例："和同学建立了学习小组，大家互相帮助"
+
+---
+
+**原文**：
+> "通过小组讨论，我对课程内容的理解更深入了。"
+
+**编码**：
+- 概念：`深化知识理解`
+- 定义：通过协作学习提升对知识的理解
+- 类型：一般概念
+- 示例："通过小组讨论，我对课程内容的理解更深入了"
+
+---
+
+**原文**：
+> "期末考试我考了85分，进步很大。"
+
+**编码**：
+- 概念：`实现学业进步`
+- 定义：通过努力取得学业成绩的提升
+- 类型：一般概念
+- 示例："期末考试我考了85分，进步很大"
+
+#### 第4段分析
+
+**原文**：
+> "除了学习，我还参加了学生会，认识了很多朋友。"
+
+**编码**：
+- 概念：`拓展社交网络`
+- 定义：通过参与活动扩大社交圈
+- 类型：行动概念
+- 示例："参加了学生会，认识了很多朋友"
+
+---
+
+**原文**：
+> "这让我更快地融入了大学生活。"
+
+**编码**：
+- 概念：`融入校园环境`
+- 定义：逐渐适应并融入大学生活环境
+- 类型：一般概念
+- 示例："更快地融入了大学生活"
+
+### 编码结果汇总
+
+**总计**：11个概念
+
+**按类型分类**：
+- 行动概念（4个）：寻求教师指导、制定学习计划、建立同伴支持、拓展社交网络
+- 情感概念（2个）：体验不适应、经历学业挫折
+- 一般概念（5个）：遇到学习困难、获得教师支持、深化知识理解、实现学业进步、融入校园环境
+
+### 持续比较示例
+
+#### 比较1：识别相似概念
+
+**概念A**：`寻求教师指导`
+**概念B**：`获得教师支持`
+
+**相似度分析**：
+- 都涉及教师
+- 但A强调主动行动，B强调获得结果
+- **决策**：保留两个概念，建立因果关系
+
+#### 比较2：合并重复概念
+
+假设后续访谈中出现：
+
+**概念C**：`向老师请教`
+**概念A**：`寻求教师指导`
+
+**相似度分析**：
+- 语义高度相似（相似度>0.9）
+- 都是主动向教师寻求帮助
+- **决策**：合并为`寻求教师指导`
+
+### 工具辅助编码
+
+#### 使用auto_loader.py
+
+```bash
+python scripts/auto_loader.py --input interview.txt --output concepts.json
+```
+
+**输出结果**：
+```json
+{
+  "summary": {
+    "total_concepts": 11,
+    "top_concepts": ["学习", "老师", "同学", "大学", "帮助"]
+  },
+  "details": {
+    "concepts": [
+      {"concept": "学习", "frequency": 7, "type": "一般概念"},
+      {"concept": "老师", "frequency": 3, "type": "一般概念"},
+      {"concept": "帮助", "frequency": 2, "type": "一般概念"}
+    ]
+  }
+}
+```
+
+**人工精炼**：
+- 将"学习"精炼为"制定学习计划"、"深化知识理解"
+- 将"老师"精炼为"寻求教师指导"、"获得教师支持"
+- 将"帮助"精炼为"建立同伴支持"
+
+#### 使用compare_codes.py
+
+```bash
+python scripts/compare_codes.py --input concepts.json --output comparison.json
+```
+
+**识别重复**：
+- "寻求教师指导" vs "向老师请教" → 相似度0.92 → 建议合并
+- "建立同伴支持" vs "建立学习小组" → 相似度0.85 → 建议合并
+
+## 简化案例：快速编码
+
+### 短文本编码
+
+**原文**：
+> "我通过参加社团活动，认识了很多志同道合的朋友。"
+
+**快速编码**：
+- 概念：`拓展社交网络`
+- 定义：通过参与活动扩大社交圈
+- 示例：原文
+
+### 多个访谈对象比较
+
+**访谈对象1（小李）**：
+> "我主动去找老师请教问题。"
+→ 概念：`寻求教师指导`
+
+**访谈对象2（小王）**：
+> "我不好意思问老师，怕老师觉得我笨。"
+→ 概念：`避免寻求帮助`
+
+**持续比较**：
+- 识别出对立概念
+- 分析背后的原因（如面子文化）
+- 建立概念关系
+
+## 编码质量检查
+
+### 使用validate_codes.py
+
+```bash
+python scripts/validate_codes.py --input concepts.json --output validation.json
+```
+
+**质量报告**：
+```json
+{
+  "summary": {
+    "total_score": 85.0,
+    "grade": "B (良好)",
+    "total_issues": 3
+  },
+  "details": {
+    "issues": {
+      "naming": ["概念5: 建议使用行动导向的命名"],
+      "definition": [],
+      "example": ["概念8: 示例数量不足"]
+    },
+    "recommendations": [
+      "命名规范：使用行动导向的动词开头",
+      "示例充分性：为每个概念提供至少2个具体示例"
+    ]
+  }
+}
+```
+
+## 常见错误示例
+
+### 错误1：过于具体
+
+❌ **错误编码**：
+- 概念：`向张老师请教微积分第三章第二节的问题`
+- 问题：过于具体，无法推广
+
+✅ **正确编码**：
+- 概念：`寻求学科指导`
+- 改进：提升抽象层次
+
+### 错误2：缺少行动导向
+
+❌ **错误编码**：
+- 概念：`老师`
+- 问题：名词，非行动
+
+✅ **正确编码**：
+- 概念：`寻求教师指导`
+- 改进：使用动词开头
+
+### 错误3：定义不清
+
+❌ **错误编码**：
+- 概念：`学习`
+- 定义：学习
+- 问题：循环定义
+
+✅ **正确编码**：
+- 概念：`制定学习计划`
+- 定义：根据学习需求制定系统的学习安排
+- 改进：清晰完整的定义
+
+## 进阶技巧
+
+### 技巧1：使用聚类发现模式
+
+```bash
+python scripts/cluster_concepts.py --input concepts.json --n-clusters 3
+```
+
+**发现模式**：
+- 聚类1：学习策略（制定计划、深化理解）
+- 聚类2：社会支持（寻求指导、建立关系）
+- 聚类3：情感体验（体验不适应、经历挫折）
+
+### 技巧2：迭代精炼
+
+1. **第一轮**：快速编码，识别初步概念
+2. **第二轮**：持续比较，合并重复概念
+3. **第三轮**：概念聚类，发现模式
+4. **第四轮**：质量验证，精炼命名和定义
+
+---
+
+*本文档提供完整的编码案例。理论基础见 `theory.md`，问题解决见 `troubleshooting.md`。*

package/skills/performing-open-coding/references/theory.md

@@ -0,0 +1,215 @@
+# 开放编码理论基础
+
+> **渐进式披露**：本文档提供开放编码的理论背景。详细案例见 `examples.md`，故障排除见 `troubleshooting.md`。
+
+## 核心概念
+
+### 什么是开放编码
+
+开放编码是扎根理论的第一阶段，通过逐行分析质性数据，识别和命名概念。
+
+**关键特征**：
+- **行动导向**：概念命名使用动词（如"寻求帮助"而非"帮助"）
+- **持续比较**：不断比较新旧数据，精炼概念
+- **理论敏感性**：保持开放态度，让理论从数据中涌现
+
+### 理论流派
+
+**Glaser派（经典扎根理论）**：
+- 强调理论的自然涌现
+- 避免预设理论框架
+- 编码更加开放和灵活
+
+**Strauss派（程序化扎根理论）**：
+- 提供系统化的编码程序
+- 使用编码范式（Paradigm）
+- 本技能主要遵循此流派
+
+**Charmaz派（建构主义扎根理论）**：
+- 强调研究者的主体性
+- 重视社会建构过程
+
+## 核心原则
+
+### 1. 概念命名原则
+
+**行动导向命名**：
+```
+✅ 好的命名：
+- "寻求老师帮助"（动词+对象）
+- "建立同伴关系"（动词+结果）
+- "适应大学生活"（动词+情境）
+
+❌ 避免的命名：
+- "帮助"（名词，过于抽象）
+- "老师"（主体，非行动）
+- "大学"（情境，非概念）
+```
+
+### 2. 抽象层次
+
+**三个层次**：
+1. **描述性编码**：贴近原始数据（"向老师询问问题"）
+2. **概念性编码**：适度抽象（"寻求学术支持"）
+3. **理论性编码**：高度抽象（"资源动员策略"）
+
+**本技能关注**：概念性编码（第2层）
+
+### 3. 持续比较方法
+
+**比较类型**：
+- **事件与事件**：比较不同访谈中的相似现象
+- **概念与概念**：比较已有概念的异同
+- **概念与数据**：用新数据验证已有概念
+
+**操作要点**：
+- 每识别一个新概念，立即与已有概念比较
+- 相似度高（>0.8）→ 考虑合并
+- 相似度中（0.5-0.8）→ 建立关联
+- 相似度低（<0.5）→ 独立概念
+
+## 中文语境适配
+
+### 文化特殊性
+
+**关系导向**：
+- 中文研究中"关系"概念的重要性
+- 示例："建立师生关系"、"维护同学关系"
+
+**集体主义**：
+- 强调群体和谐
+- 示例："融入集体"、"适应群体规范"
+
+**面子文化**：
+- 重视社会评价
+- 示例："维护面子"、"避免尴尬"
+
+### 语言特点
+
+**词汇结构**：
+- 中文多为双音节词（如"学习"、"帮助"）
+- 四字结构常见（如"寻求帮助"、"建立关系"）
+
+**语义丰富性**：
+- 同一概念可能有多种表达
+- 需要识别同义词和近义词
+- 工具支持：使用jieba分词 + 语义相似度
+
+## 质量标准
+
+### 优秀编码的特征
+
+1. **命名清晰**：一目了然，无歧义
+2. **定义完整**：说明概念的内涵和外延
+3. **示例充分**：至少2个具体例子
+4. **抽象适度**：既不过于具体，也不过于抽象
+5. **理论相关**：与研究问题相关
+
+### 评分标准
+
+- **90-100分（A）**：命名、定义、示例全部优秀
+- **80-89分（B）**：大部分符合标准，少量问题
+- **70-79分（C）**：部分符合标准，需改进
+- **60-69分（D）**：勉强及格，问题较多
+- **<60分（F）**：不符合标准，需重新编码
+
+## 常见挑战
+
+### 挑战1：概念过于具体
+
+**表现**：
+- "向张老师询问微积分问题"（过于具体）
+
+**解决**：
+- 提升抽象层次："寻求学术支持"
+
+### 挑战2：概念过于抽象
+
+**表现**：
+- "社会互动"（过于抽象）
+
+**解决**：
+- 降低抽象层次："建立同学关系"
+
+### 挑战3：重复编码
+
+**表现**：
+- "寻求帮助"、"寻求支持"、"寻求援助"（重复）
+
+**解决**：
+- 使用工具识别相似度，合并为统一概念
+
+## 工具支持
+
+### 自动化工具
+
+本技能提供5个脚本工具：
+
+1. **preprocess_text.py**：文本预处理
+   - 中文分词（jieba）
+   - 停用词过滤
+   - 语义分段
+
+2. **auto_loader.py**：快速概念提取
+   - 自动识别高频词
+   - 概念类型分类
+   - 编码建议生成
+
+3. **compare_codes.py**：持续比较
+   - 相似度计算
+   - 重复识别
+   - 合并建议
+
+4. **cluster_concepts.py**：概念聚类
+   - K-means聚类
+   - 层次聚类
+   - 聚类可视化
+
+5. **validate_codes.py**：编码验证
+   - 命名规范检查
+   - 定义质量检查
+   - 示例充分性检查
+
+### 使用建议
+
+**推荐流程**：
+```bash
+# 1. 预处理文本
+python scripts/preprocess_text.py --input interview.txt --output clean.json
+
+# 2. 快速概念提取
+python scripts/auto_loader.py --input interview.txt --output concepts.json
+
+# 3. 持续比较
+python scripts/compare_codes.py --input concepts.json --output comparison.json
+
+# 4. 概念聚类（可选）
+python scripts/cluster_concepts.py --input concepts.json --output clusters.json
+
+# 5. 编码验证
+python scripts/validate_codes.py --input concepts.json --output validation.json
+```
+
+## 进一步学习
+
+### 推荐阅读
+
+**经典著作**：
+- Strauss, A., & Corbin, J. (1998). *Basics of Qualitative Research*
+- Charmaz, K. (2006). *Constructing Grounded Theory*
+- 陈向明 (2000). 《质的研究方法与社会科学研究》
+
+**中文资源**：
+- 详细案例：见 `examples.md`
+- 故障排除：见 `troubleshooting.md`
+- 中文特殊性：见 `chinese-context.md`
+
+### 相关技能
+
+- **performing-axial-coding**：轴心编码（下一阶段）
+- **performing-selective-coding**：选择式编码（最终阶段）
+- **writing-grounded-theory-memos**：备忘录写作
+
+---
+
+*本文档遵循渐进式披露原则：核心概念在此，详细内容在其他references文件中。*