ssci-subagent-skills 1.0.0

package/skills/performing-open-coding/scripts/test_output.json

@@ -0,0 +1,134 @@
+{
+  "summary": {
+    "total_segments": 1,
+    "total_words": 62,
+    "unique_words": 45,
+    "processing_time": 1.65
+  },
+  "details": {
+    "segments": [
+      {
+        "text": "我在大学学习过程中遇到了很多困难。当我遇到学习上的问题时，我会主动寻求老师的帮助。老师给了我很多学习上的指导和支持。我也会和同学建立良好的关系，互相帮助学习。通过小组讨论，我们能够更好地理解课程内容。我感到这种学习方式很有效果。在适应大学生活的过程中，我学会了如何管理自己的时间。我制定了详细的学习计划，并努力执行。这帮助我更好地平衡学习和生活。我也学会了如何应对压力和挫折。当遇到困难时，我会调整自己的心态，保持积极乐观的态度。我相信通过努力，我能够克服这些困难。",
+        "words": [
+          "大学",
+          "学习",
+          "过程",
+          "遇到",
+          "困难",
+          "遇到",
+          "学习",
+          "问题",
+          "我会",
+          "寻求",
+          "老师",
+          "帮助",
+          "老师",
+          "学习",
+          "指导",
+          "支持",
+          "同学",
+          "建立",
+          "良好",
+          "关系",
+          "学习",
+          "小组讨论",
+          "能够",
+          "理解",
+          "课程内容",
+          "感到",
+          "学习",
+          "方式",
+          "效果",
+          "适应",
+          "大学",
+          "生活",
+          "过程",
+          "学会",
+          "管理",
+          "时间",
+          "制定",
+          "详细",
+          "学习",
+          "计划",
+          "努力",
+          "执行",
+          "帮助",
+          "平衡",
+          "学习",
+          "生活",
+          "学会",
+          "应对",
+          "压力",
+          "挫折",
+          "我会",
+          "调整",
+          "心态",
+          "保持",
+          "积极",
+          "乐观",
+          "态度",
+          "相信",
+          "努力",
+          "能够",
+          "克服",
+          "困难"
+        ],
+        "word_count": 62
+      }
+    ],
+    "total_words": 62,
+    "unique_words": 45,
+    "word_frequency": {
+      "学习": 7,
+      "大学": 2,
+      "过程": 2,
+      "遇到": 2,
+      "困难": 2,
+      "我会": 2,
+      "老师": 2,
+      "帮助": 2,
+      "能够": 2,
+      "生活": 2,
+      "学会": 2,
+      "努力": 2,
+      "问题": 1,
+      "寻求": 1,
+      "指导": 1,
+      "支持": 1,
+      "同学": 1,
+      "建立": 1,
+      "良好": 1,
+      "关系": 1,
+      "小组讨论": 1,
+      "理解": 1,
+      "课程内容": 1,
+      "感到": 1,
+      "方式": 1,
+      "效果": 1,
+      "适应": 1,
+      "管理": 1,
+      "时间": 1,
+      "制定": 1,
+      "详细": 1,
+      "计划": 1,
+      "执行": 1,
+      "平衡": 1,
+      "应对": 1,
+      "压力": 1,
+      "挫折": 1,
+      "调整": 1,
+      "心态": 1,
+      "保持": 1,
+      "积极": 1,
+      "乐观": 1,
+      "态度": 1,
+      "相信": 1,
+      "克服": 1
+    }
+  },
+  "metadata": {
+    "input_file": "D:\\stigmergy-CLI-Multi-Agents\\sscisubagent-skills\\skills\\coding\\performing-open-coding\\scripts\\..\\..\\..\\..\\test_data\\open_coding\\sample_interview.txt",
+    "timestamp": "2025-12-19T10:00:40.539690",
+    "version": "1.0.0"
+  }
+}

package/skills/performing-open-coding/scripts/validate_codes.py

@@ -0,0 +1,302 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+编码验证脚本 - 开放编码
+
+功能：
+- 检查命名规范
+- 检查定义质量
+- 检查示例充分性
+- 生成质量报告
+
+使用方式：
+  python validate_codes.py --input codes.json --output validation.json
+"""
+
+import argparse
+import json
+import logging
+import sys
+import time
+from datetime import datetime
+from pathlib import Path
+from typing import List, Dict
+import re
+
+logging.basicConfig(level=logging.INFO, format='%(levelname)s: %(message)s')
+
+def check_naming_convention(codes: List[Dict]) -> List[str]:
+    """
+    检查命名规范
+    
+    规范：
+    - 使用动词开头（行动导向）
+    - 长度适中（2-8个字符）
+    - 避免过于抽象或具体
+    
+    Returns:
+        问题列表
+    """
+    issues = []
+    
+    # 常见行动动词
+    action_verbs = ['寻求', '建立', '适应', '应对', '处理', '解决', '获得', '提供',
+                   '学习', '制定', '执行', '调整', '保持', '克服', '管理', '理解']
+    
+    for i, code in enumerate(codes):
+        concept = code.get('concept') or code.get('code', '')
+        
+        if not concept:
+            issues.append(f"编码{i+1}: 概念名称为空")
+            continue
+        
+        # 检查长度
+        if len(concept) < 2:
+            issues.append(f"编码{i+1} '{concept}': 名称过短（少于2字符）")
+        elif len(concept) > 10:
+            issues.append(f"编码{i+1} '{concept}': 名称过长（超过10字符），建议简化")
+        
+        # 检查是否包含行动动词
+        has_action_verb = any(verb in concept for verb in action_verbs)
+        if not has_action_verb:
+            issues.append(f"编码{i+1} '{concept}': 建议使用行动导向的命名（如：寻求帮助）")
+        
+        # 检查是否过于具体
+        if any(char.isdigit() for char in concept):
+            issues.append(f"编码{i+1} '{concept}': 包含数字，可能过于具体")
+    
+    return issues
+
+def check_definition_quality(codes: List[Dict]) -> List[str]:
+    """
+    检查定义质量
+    
+    规范：
+    - 定义应该清晰完整
+    - 长度适中（10-100字符）
+    - 包含关键要素
+    
+    Returns:
+        问题列表
+    """
+    issues = []
+    
+    for i, code in enumerate(codes):
+        concept = code.get('concept') or code.get('code', '')
+        definition = code.get('definition', '')
+        
+        if not definition:
+            issues.append(f"编码{i+1} '{concept}': 缺少定义")
+            continue
+        
+        # 检查长度
+        if len(definition) < 10:
+            issues.append(f"编码{i+1} '{concept}': 定义过短（少于10字符）")
+        elif len(definition) > 200:
+            issues.append(f"编码{i+1} '{concept}': 定义过长（超过200字符），建议简化")
+        
+        # 检查是否包含关键词
+        if concept not in definition and not any(word in definition for word in concept.split()):
+            issues.append(f"编码{i+1} '{concept}': 定义中未包含概念名称或相关词汇")
+    
+    return issues
+
+def check_example_sufficiency(codes: List[Dict]) -> List[str]:
+    """
+    检查示例充分性
+    
+    规范：
+    - 至少1个示例
+    - 示例应该具体
+    - 示例长度适中
+    
+    Returns:
+        问题列表
+    """
+    issues = []
+    
+    for i, code in enumerate(codes):
+        concept = code.get('concept') or code.get('code', '')
+        examples = code.get('examples', [])
+        
+        if not examples or len(examples) == 0:
+            issues.append(f"编码{i+1} '{concept}': 缺少示例")
+            continue
+        
+        # 检查示例数量
+        if len(examples) < 2:
+            issues.append(f"编码{i+1} '{concept}': 示例数量不足（建议至少2个）")
+        
+        # 检查示例质量
+        for j, example in enumerate(examples):
+            if len(example) < 5:
+                issues.append(f"编码{i+1} '{concept}': 示例{j+1}过短（少于5字符）")
+            elif len(example) > 200:
+                issues.append(f"编码{i+1} '{concept}': 示例{j+1}过长（超过200字符）")
+    
+    return issues
+
+def calculate_quality_score(codes: List[Dict], all_issues: Dict[str, List[str]]) -> Dict:
+    """
+    计算质量评分
+    
+    Returns:
+        评分结果
+    """
+    total_codes = len(codes)
+    
+    # 统计各类问题数量
+    naming_issues = len(all_issues['naming'])
+    definition_issues = len(all_issues['definition'])
+    example_issues = len(all_issues['example'])
+    total_issues = naming_issues + definition_issues + example_issues
+    
+    # 计算评分（100分制）
+    # 命名：40分，定义：30分，示例：30分
+    naming_score = max(0, 40 - (naming_issues / total_codes) * 40)
+    definition_score = max(0, 30 - (definition_issues / total_codes) * 30)
+    example_score = max(0, 30 - (example_issues / total_codes) * 30)
+    
+    total_score = naming_score + definition_score + example_score
+    
+    # 评级
+    if total_score >= 90:
+        grade = 'A (优秀)'
+    elif total_score >= 80:
+        grade = 'B (良好)'
+    elif total_score >= 70:
+        grade = 'C (中等)'
+    elif total_score >= 60:
+        grade = 'D (及格)'
+    else:
+        grade = 'F (不及格)'
+    
+    return {
+        'total_score': round(total_score, 1),
+        'naming_score': round(naming_score, 1),
+        'definition_score': round(definition_score, 1),
+        'example_score': round(example_score, 1),
+        'grade': grade,
+        'total_issues': total_issues,
+        'issue_breakdown': {
+            'naming': naming_issues,
+            'definition': definition_issues,
+            'example': example_issues
+        }
+    }
+
+def generate_recommendations(all_issues: Dict[str, List[str]]) -> List[str]:
+    """
+    生成改进建议
+    
+    Returns:
+        建议列表
+    """
+    recommendations = []
+    
+    if all_issues['naming']:
+        recommendations.append("命名规范：使用行动导向的动词开头，如'寻求帮助'、'建立关系'")
+    
+    if all_issues['definition']:
+        recommendations.append("定义质量：确保每个概念都有清晰完整的定义（10-100字符）")
+    
+    if all_issues['example']:
+        recommendations.append("示例充分性：为每个概念提供至少2个具体示例")
+    
+    if not any(all_issues.values()):
+        recommendations.append("编码质量优秀，继续保持！")
+    
+    return recommendations
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='编码验证工具 - 开放编码',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+示例用法:
+  python validate_codes.py --input codes.json --output validation.json
+  python validate_codes.py -i codes.json -o report.json
+        """
+    )
+    parser.add_argument('--input', '-i', required=True, help='输入的编码JSON文件')
+    parser.add_argument('--output', '-o', default='validation.json', help='输出JSON文件')
+    args = parser.parse_args()
+    
+    start_time = time.time()
+    
+    try:
+        # 读取编码数据
+        input_path = Path(args.input)
+        if not input_path.exists():
+            logging.error(f"文件不存在: {args.input}")
+            sys.exit(1)
+        
+        with open(input_path, 'r', encoding='utf-8') as f:
+            data = json.load(f)
+        
+        # 提取编码列表
+        if 'details' in data and 'concepts' in data['details']:
+            codes = data['details']['concepts']
+        elif isinstance(data, list):
+            codes = data
+        else:
+            logging.error("无法识别的数据格式")
+            sys.exit(2)
+        
+        if len(codes) == 0:
+            logging.error("编码列表为空")
+            sys.exit(3)
+        
+        logging.info(f"✓ 读取编码: {len(codes)} 个")
+        
+        # 执行验证
+        all_issues = {
+            'naming': check_naming_convention(codes),
+            'definition': check_definition_quality(codes),
+            'example': check_example_sufficiency(codes)
+        }
+        
+        # 计算评分
+        quality_score = calculate_quality_score(codes, all_issues)
+        
+        # 生成建议
+        recommendations = generate_recommendations(all_issues)
+        
+        processing_time = time.time() - start_time
+        
+        # 构建输出
+        output = {
+            'summary': {
+                'total_codes': len(codes),
+                **quality_score,
+                'processing_time': round(processing_time, 2)
+            },
+            'details': {
+                'issues': all_issues,
+                'recommendations': recommendations
+            },
+            'metadata': {
+                'input_file': str(input_path.absolute()),
+                'timestamp': datetime.now().isoformat(),
+                'version': '1.0.0'
+            }
+        }
+        
+        # 保存
+        with open(args.output, 'w', encoding='utf-8') as f:
+            json.dump(output, f, ensure_ascii=False, indent=2)
+        
+        logging.info(f"✅ 验证完成")
+        logging.info(f"   编码总数: {len(codes)}")
+        logging.info(f"   质量评分: {quality_score['total_score']}/100 ({quality_score['grade']})")
+        logging.info(f"   问题总数: {quality_score['total_issues']}")
+        logging.info(f"📄 详细结果: {args.output}")
+        
+    except Exception as e:
+        logging.error(f"处理失败: {e}")
+        import traceback
+        traceback.print_exc()
+        sys.exit(99)
+
+if __name__ == "__main__":
+    main()

package/skills/performing-open-coding/scripts/validation_test.json

@@ -0,0 +1,95 @@
+{
+  "summary": {
+    "total_codes": 20,
+    "total_score": 4.0,
+    "naming_score": 4.0,
+    "definition_score": 0,
+    "example_score": 0,
+    "grade": "F (不及格)",
+    "total_issues": 58,
+    "issue_breakdown": {
+      "naming": 18,
+      "definition": 20,
+      "example": 20
+    },
+    "processing_time": 0.0
+  },
+  "details": {
+    "issues": {
+      "naming": [
+        "编码2 '大学': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码3 '过程': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码4 '遇到': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码5 '很多': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码6 '困难': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码7 '我会': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码8 '老师': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码9 '帮助': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码10 '通过': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码11 '能够': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码12 '更好': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码13 '生活': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码14 '学会': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码15 '如何': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码16 '自己': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码17 '努力': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码18 '问题': 建议使用行动导向的命名（如：寻求帮助）",
+        "编码19 '主动': 建议使用行动导向的命名（如：寻求帮助）"
+      ],
+      "definition": [
+        "编码1 '学习': 缺少定义",
+        "编码2 '大学': 缺少定义",
+        "编码3 '过程': 缺少定义",
+        "编码4 '遇到': 缺少定义",
+        "编码5 '很多': 缺少定义",
+        "编码6 '困难': 缺少定义",
+        "编码7 '我会': 缺少定义",
+        "编码8 '老师': 缺少定义",
+        "编码9 '帮助': 缺少定义",
+        "编码10 '通过': 缺少定义",
+        "编码11 '能够': 缺少定义",
+        "编码12 '更好': 缺少定义",
+        "编码13 '生活': 缺少定义",
+        "编码14 '学会': 缺少定义",
+        "编码15 '如何': 缺少定义",
+        "编码16 '自己': 缺少定义",
+        "编码17 '努力': 缺少定义",
+        "编码18 '问题': 缺少定义",
+        "编码19 '主动': 缺少定义",
+        "编码20 '寻求': 缺少定义"
+      ],
+      "example": [
+        "编码1 '学习': 缺少示例",
+        "编码2 '大学': 缺少示例",
+        "编码3 '过程': 缺少示例",
+        "编码4 '遇到': 缺少示例",
+        "编码5 '很多': 缺少示例",
+        "编码6 '困难': 缺少示例",
+        "编码7 '我会': 缺少示例",
+        "编码8 '老师': 缺少示例",
+        "编码9 '帮助': 缺少示例",
+        "编码10 '通过': 缺少示例",
+        "编码11 '能够': 缺少示例",
+        "编码12 '更好': 缺少示例",
+        "编码13 '生活': 缺少示例",
+        "编码14 '学会': 缺少示例",
+        "编码15 '如何': 缺少示例",
+        "编码16 '自己': 缺少示例",
+        "编码17 '努力': 缺少示例",
+        "编码18 '问题': 缺少示例",
+        "编码19 '主动': 缺少示例",
+        "编码20 '寻求': 缺少示例"
+      ]
+    },
+    "recommendations": [
+      "命名规范：使用行动导向的动词开头，如'寻求帮助'、'建立关系'",
+      "定义质量：确保每个概念都有清晰完整的定义（10-100字符）",
+      "示例充分性：为每个概念提供至少2个具体示例"
+    ]
+  },
+  "metadata": {
+    "input_file": "D:\\stigmergy-CLI-Multi-Agents\\sscisubagent-skills\\skills\\coding\\performing-open-coding\\scripts\\concepts_test.json",
+    "timestamp": "2025-12-19T10:20:31.670572",
+    "version": "1.0.0"
+  }
+}

package/skills/performing-open-coding/tests/run_integration_tests.py

@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+集成测试运行器 - 快速验证核心功能
+"""
+
+import sys
+from pathlib import Path
+
+# 添加scripts到路径
+sys.path.insert(0, str(Path(__file__).parent.parent / 'scripts'))
+
+def test_preprocess():
+    """测试文本预处理"""
+    from preprocess_text import tokenize_chinese, remove_stopwords, preprocess_text
+    
+    print("🧪 测试 preprocess_text...")
+    
+    # 测试分词
+    words = tokenize_chinese("学生寻求老师的帮助")
+    assert len(words) > 0, "分词失败"
+    print(f"  ✅ 分词: {len(words)} 个词")
+    
+    # 测试停用词过滤
+    filtered = remove_stopwords(['学习', '的', '方法'])
+    assert '的' not in filtered, "停用词过滤失败"
+    print(f"  ✅ 停用词过滤: {len(filtered)} 个词")
+    
+    # 测试完整流程
+    result = preprocess_text("学生寻求帮助。老师提供指导。")
+    assert 'segments' in result, "预处理流程失败"
+    print(f"  ✅ 完整流程: {result['total_words']} 个词")
+    
+    return True
+
+def test_auto_loader():
+    """测试自动加载器"""
+    from auto_loader import OpenCodingAutoLoader
+    
+    print("🧪 测试 auto_loader...")
+    
+    loader = OpenCodingAutoLoader()
+    
+    # 测试概念提取
+    concepts = loader.quick_concept_extract("学生寻求老师的帮助和指导")
+    assert len(concepts) > 0, "概念提取失败"
+    print(f"  ✅ 概念提取: {len(concepts)} 个概念")
+    
+    # 测试概念分类
+    concept_type = loader._classify_concept("寻求帮助")
+    assert concept_type == '行动概念', "概念分类失败"
+    print(f"  ✅ 概念分类: {concept_type}")
+    
+    # 测试编码建议
+    suggestions = loader.generate_coding_suggestions(concepts)
+    assert len(suggestions) > 0, "编码建议生成失败"
+    print(f"  ✅ 编码建议: {len(suggestions)} 条")
+    
+    return True
+
+def test_compare_codes():
+    """测试持续比较"""
+    from compare_codes import calculate_similarity, identify_duplicates
+    
+    print("🧪 测试 compare_codes...")
+    
+    # 测试相似度计算
+    sim = calculate_similarity("寻求帮助", "寻求帮助")
+    assert sim > 0.9, "相似度计算失败"
+    print(f"  ✅ 相似度计算: {sim:.2f}")
+    
+    # 测试重复识别
+    codes = [
+        {'concept': '寻求帮助', 'frequency': 5},
+        {'concept': '寻求帮助', 'frequency': 3}
+    ]
+    duplicates = identify_duplicates(codes, threshold=0.8)
+    assert len(duplicates) > 0, "重复识别失败"
+    print(f"  ✅ 重复识别: {len(duplicates)} 对")
+    
+    return True
+
+def test_integration_workflow():
+    """测试完整集成流程"""
+    from preprocess_text import preprocess_text
+    from auto_loader import OpenCodingAutoLoader
+    from compare_codes import identify_duplicates
+    
+    print("🧪 测试集成流程...")
+    
+    text = """
+    学生寻求老师的帮助。老师提供学习指导。
+    学生建立学习计划。执行学习计划。
+    """
+    
+    # 1. 预处理
+    preprocessed = preprocess_text(text)
+    print(f"  ✅ 步骤1-预处理: {preprocessed['total_words']} 个词")
+    
+    # 2. 概念提取
+    loader = OpenCodingAutoLoader()
+    concepts = loader.quick_concept_extract(text)
+    print(f"  ✅ 步骤2-概念提取: {len(concepts)} 个概念")
+    
+    # 3. 持续比较
+    duplicates = identify_duplicates(concepts, threshold=0.7)
+    print(f"  ✅ 步骤3-持续比较: {len(duplicates)} 对重复")
+    
+    return True
+
+def main():
+    """运行所有测试"""
+    print("=" * 60)
+    print("开放编码技能 - 集成测试")
+    print("=" * 60)
+    
+    tests = [
+        ("文本预处理", test_preprocess),
+        ("自动加载器", test_auto_loader),
+        ("持续比较", test_compare_codes),
+        ("集成流程", test_integration_workflow)
+    ]
+    
+    passed = 0
+    failed = 0
+    
+    for name, test_func in tests:
+        try:
+            if test_func():
+                passed += 1
+                print(f"✅ {name} - 通过\n")
+        except Exception as e:
+            failed += 1
+            print(f"❌ {name} - 失败: {e}\n")
+    
+    print("=" * 60)
+    print(f"测试结果: {passed} 通过, {failed} 失败")
+    print("=" * 60)
+    
+    if failed == 0:
+        print("🎉 所有测试通过！")
+        return 0
+    else:
+        print(f"⚠️  {failed} 个测试失败")
+        return 1
+
+if __name__ == "__main__":
+    sys.exit(main())