devsquad 3.6.0__py3-none-any.whl

devsquad-3.6.0.dist-info/RECORD

@@ -0,0 +1,95 @@
+devsquad-3.6.0.dist-info/licenses/LICENSE,sha256=Nx7tqYDkj_hkw6VQEEBkqOscdLFzt4BCaRu8xqOzCuU,1067
+scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+scripts/ai_semantic_matcher.py,sha256=BxTPazglCSz52BRqbf2us2_z8yvV-Gy6OqDAMwH2v6A,17242
+scripts/alert_manager.py,sha256=T0iAo128_JkHypHFFrzBFRRw747lmRxcDVn8RBS4XoI,16613
+scripts/api_server.py,sha256=S4TMICnVG-QxsBy581wEwUpUU9bUqD2wDBvzTgGyfm8,10064
+scripts/auth.py,sha256=ILGg2V8lOp-hw_cwsA7-5S5yynA5ZxyCQYYrOtjrZfg,14352
+scripts/cli.py,sha256=Oi_lmmr5UzbwP6m5y8B5ZoDARUahxUFEfd7YQ_PBce4,48328
+scripts/dashboard.py,sha256=vtdw6EytkqFz0iFQ6v07686HvA--sLB1gy0RQOVu-48,35539
+scripts/generate_benchmark_report.py,sha256=k1OscgXkyf690GjDDuywUGo83DMF3btYs2Z44qdoHew,29191
+scripts/history_manager.py,sha256=X3kqA2YJy1M2cLA34yHk5fKtwkhPonveljicgBlujzE,20504
+scripts/mcp_server.py,sha256=NEL6NbIEWyYp2z8BFrB-iBRPz5RQi82Yjr-lw1K2SpM,10690
+scripts/api/__init__.py,sha256=hDZnDkeQcFmpWYMgNNZE4Mlox9DYBD9Ze0o_tOJ2cbk,926
+scripts/api/models.py,sha256=p1VTLYT9CHBVrgs3gXGrBlgOW9oILdwuSdMUp9BdhZ4,17955
+scripts/api/routes/__init__.py,sha256=IDOWCj3p2t4eNibr9cH1nYV1PnP0LwufGJMSoVrz6OM,539
+scripts/api/routes/dispatch.py,sha256=jnfRtqDoBfFD93cYYrgry5WwcmwagjWt3cIvJv-N3fk,11177
+scripts/api/routes/lifecycle.py,sha256=yOKuFyfIRFF4WLU-nxq_EwIP7EaM86mmsBUl4w6E38M,11568
+scripts/api/routes/metrics_gates.py,sha256=5e3ysJV9bx_WSDpt4ySqGYcLUabdT4egZ-y8SOqoxA4,11368
+scripts/cli/__init__.py,sha256=ceO6s2CvYTDDSggDKLTdgVWqQqcNNM-F55Bmbn-JMb4,14
+scripts/cli/cli_visual.py,sha256=pqyDIemY0t8u57dg-GR5LGTOnXEJ9BXMCWr33pEAsPk,21614
+scripts/collaboration/__init__.py,sha256=jL3ppFqE_fIGdpwGFyW1w-rEdpSjZ23lbTJ-LAuAOzU,5922
+scripts/collaboration/_version.py,sha256=pnBAJI_5J7ByFo6sxUkzCfK3L9wcGJP7yeF7OJLugqk,22
+scripts/collaboration/agent_briefing.py,sha256=BtvCX21JsipfRiJ6QUbBBDcTA51W7I0MdEprx3IF8LA,24065
+scripts/collaboration/ai_semantic_matcher.py,sha256=yt7t9GraRAGLYh68JyJzpV1--mphCX_CVb2bsZblbyA,10351
+scripts/collaboration/anchor_checker.py,sha256=YwDqepTQG-8EY0QhNM2deO1LwnWWYnoPpUbx7jh_3SI,10100
+scripts/collaboration/anti_rationalization.py,sha256=29btejWWgx-zsQWr5cgy7_0YLljeAES4JyYzRNcefjQ,17796
+scripts/collaboration/async_integration_example.py,sha256=lwHkA54zY8-C-EyDxJENeQ7lTZ2aqvt6IrLMDG3SUGY,7959
+scripts/collaboration/batch_scheduler.py,sha256=IPbj6y_8x6qgXzsh0L4wtqebXqOw0oDQANWeC4ThUIU,4831
+scripts/collaboration/checkpoint_manager.py,sha256=X9n1PP-2KVW8IO8dRkRBW8YPRcJZWa4n9OGmA0J3o1A,21666
+scripts/collaboration/ci_feedback_adapter.py,sha256=iYpSifV3wbtPBpfjmxJdQ1IAML_XGUuItiEIfDUdIi4,12159
+scripts/collaboration/code_map_generator.py,sha256=0srNkAhBkMVngaR7sniYXtZppgBvWiuBMErP1y1Gu0o,10063
+scripts/collaboration/concern_pack_loader.py,sha256=zpRmbH4jhYbvGVktGyxGp7DPxO31X26cIuEkxLhD33Y,11720
+scripts/collaboration/confidence_score.py,sha256=_aX3U_5ny5_YQVaUgB5vhWL7XUvQNpR7sG2kCriRpgU,16965
+scripts/collaboration/config_loader.py,sha256=4eZ2iZ0NyHBTrqmdUWPvSfZG7d7R8iv5J5aTWuDfDOA,6920
+scripts/collaboration/consensus.py,sha256=kpSg_u_Xqk2RobhJjhV846nGYjAd-9b9iW6z8XCsMr4,8814
+scripts/collaboration/context_compressor.py,sha256=S4SY291ix9-8AOB3cFDawCcYvKKtzePepwep0rQ8Stg,20824
+scripts/collaboration/coordinator.py,sha256=A8zZPAOOcKIk12DEx0Yt-vq3C185YGMXC5IyHN8hZMc,26718
+scripts/collaboration/dispatcher.py,sha256=OWbfT00vs9pK3HuTPRRbR6OhcIgMG2UszeYfOOuRY8M,70722
+scripts/collaboration/dual_layer_context.py,sha256=P0ZI4yd6WnPkApQEATAdqqjKQNdmEqq8Ia-sXy68Q9w,4912
+scripts/collaboration/enhanced_worker.py,sha256=y4Iv494jk-10AG90g_gb0uaAThWN8m8a6zyPzjvKJwI,19291
+scripts/collaboration/feature_usage_tracker.py,sha256=og01psDkUV3MoGa-wYKNhpzmSqTg6NKkt24uT0_o1zk,7315
+scripts/collaboration/five_axis_consensus.py,sha256=klfzVMhHEy64Bk2CjbMxUUGEa9QQ8b5HuBTPyyJ0oU8,11203
+scripts/collaboration/input_validator.py,sha256=0QWeH6hKoPOa3dq6uTU17aIVihF-h6k6dvanQZr0UtI,12724
+scripts/collaboration/integration_example.py,sha256=TLKuBbnGq3kwpyACvxFtJuXB5em6uvqUeqvEnKX2cRA,8500
+scripts/collaboration/intent_workflow_mapper.py,sha256=LEeWJTXJkSj5t768EPV3WdgCztqMnL1T2D8y93GgfQo,13181
+scripts/collaboration/language_parsers.py,sha256=1XY-64QBctufmhiw3rCOgkXxIMV84jg9R2ucw2JPJsg,9383
+scripts/collaboration/lifecycle_protocol.py,sha256=E1gLZ0wC6jDfzA3hrxTwdBaM_Ps56KltiHwuhiKwiCM,55193
+scripts/collaboration/llm_backend.py,sha256=U04THXrfiHpizNAdAXnRh8wo1UO3q25QL_2nsPUKtJ8,16548
+scripts/collaboration/llm_cache.py,sha256=wv4u7TU-6_NxsRiygqm4OAxVlOxhHKUhj6IirMQ-UDM,14012
+scripts/collaboration/llm_cache_async.py,sha256=4qk_C6wwgRu_ltxYIcKf61LgSsOt24upbeb-FoVyEzE,11445
+scripts/collaboration/llm_retry.py,sha256=Xoi72wEntbmSJ0a0Mp9R_N26kPOYPFd1pa5LFAuZdXI,12480
+scripts/collaboration/llm_retry_async.py,sha256=hK-DFTTalZ8xsMMf5k4MZku-z7xXTgtKv8FE3uEryCo,13394
+scripts/collaboration/mce_adapter.py,sha256=0DeaPiFO6724Ie2Nukk9bl-7HlcgKs0Gq_6vk5NYVRI,22913
+scripts/collaboration/memory_bridge.py,sha256=g5ylSrzm8liPc0Kej2oT5rc9n5ecvIpQYFoOntihgaA,63098
+scripts/collaboration/models.py,sha256=qTVyRgP76oijjYccKApbEBmBqhOGU7J0vi1CZxlSMlY,18912
+scripts/collaboration/null_providers.py,sha256=CNh04uDMphUliEx0F6YVduATmBRkMjdEIKKY1q2ZHPI,9951
+scripts/collaboration/operation_classifier.py,sha256=HqGVpYI6eJvTAMdJKrxFDZ-Hkh_uJPhTitLn-zPYu3o,10251
+scripts/collaboration/output_slicer.py,sha256=ka_Qcr5rjahmeu0k5vALcICI_K91x5jvfki6x6_28oE,7148
+scripts/collaboration/performance_monitor.py,sha256=3mGkWwaMA1ezhz1wqeab5ExDEgox_47bAW1ZG9nBrhw,15156
+scripts/collaboration/permission_guard.py,sha256=oJZWCNLLCEZ_SqxfhDhOvTH0dbKVGn9F36cD746N7NM,35234
+scripts/collaboration/prompt_assembler.py,sha256=MGAGA3tv9Bdedcbb51PA7XRiN6ablFa33zrBgF9wuOY,32016
+scripts/collaboration/prompt_variant_generator.py,sha256=GbYZbVfvGJ2Yv4VWXbpv3nzR46ChMDm4dxke9IzSHmE,16800
+scripts/collaboration/protocols.py,sha256=10tCUPaC53peJLHmfXWPELANecEkzjtAx9cX1paj8V0,7772
+scripts/collaboration/report_formatter.py,sha256=mDDTz-ZroKdGsXbh3Qq6Z70oWcI-fJq1_ZGeRp3anpM,14976
+scripts/collaboration/retrospective.py,sha256=FZIMeHY6tUZQ_kDj8jscr-NP70YMbsRXDtvEMkKAv2c,10782
+scripts/collaboration/role_matcher.py,sha256=edS7wtq3o1ZYDV4AvjDRFJlXLRYYBeKDJsrtSjba7P8,3265
+scripts/collaboration/role_template_market.py,sha256=D6q0PyWbpYZrIHFViBaSQpdyRVUPWcrEoWKkIIJUaT0,12065
+scripts/collaboration/rule_collector.py,sha256=QnAsOrh4SLn1HtfGnONOFAt-eDDWCmiE6iV1zKfAr9E,28170
+scripts/collaboration/scratchpad.py,sha256=aQxD56KeGz2QPNoOYNTByYp_ge2gTYMLxSwo9F9_g20,13239
+scripts/collaboration/skill_registry.py,sha256=jxmWnQ5-MVnDB3k7TjF5fz0yqu5I01iKAGoZDixZPak,5759
+scripts/collaboration/skillifier.py,sha256=2IysxrloDkN9V6ZAUeXGB8r8DoFl3QFDGuBOWAEh_Oc,34544
+scripts/collaboration/standardized_role_template.py,sha256=01NB3SRaiZrx6dK-vHIIQDpOpCzs1dPUMRbsZvayCmg,12482
+scripts/collaboration/task_completion_checker.py,sha256=W1G6Ai0O5Hi8kSOOTCbNqbDKpl7J2jv32aQm--oJG-g,8797
+scripts/collaboration/test_quality_guard.py,sha256=0kQmEahTKPoAE5elwJpipKzEc_Im4ePkw3lY9EuPPOI,27240
+scripts/collaboration/unified_gate_engine.py,sha256=Jreycht9bMwmSGA5KI9ck-4pwOxXyvDZWGX7yZl6TeA,20743
+scripts/collaboration/usage_tracker.py,sha256=Jz01Nq1rn8TIAJeWttowP3m_x-WbFE7vES9UpMISJqw,10161
+scripts/collaboration/user_friendly_error.py,sha256=RPKDdx9iqx3HB9gLbS1ftkUDWWClrURJlO517xaQ2yU,6822
+scripts/collaboration/verification_gate.py,sha256=0hVSQE_O3UWZJ3NEMGs-R7IhrHld39Bno-vcTXgjcUs,10675
+scripts/collaboration/warmup_manager.py,sha256=MTM1Ny-dvXqxPTrAspToKobW9Ejhz3txCQARspzhMZg,22924
+scripts/collaboration/worker.py,sha256=yJSLvgh-rrF5vXzVPcAkTU9s_uR9OHD9-sZFbV2Asnk,19054
+scripts/collaboration/workflow_engine.py,sha256=HuyFe7zJCFSsHmyL9Aijrama4n3mwvt85y4awlaFehw,27168
+skills/__init__.py,sha256=rMCK3-GkjvYe5vfL834daHjSPZHJCWit2Deq7XrEnQE,1250
+skills/registry.py,sha256=ghZBXqBahez0B4IanaW99EyQ0SEpSXfew6jLGs8RYPA,2034
+skills/dispatch/handler.py,sha256=GuEotcNnlK_ubvyjxQT8UzEDocr4CpsqUJI4Hv-8EVg,1824
+skills/intent/handler.py,sha256=z3cELpXXHY0zgIm5JG5nfDsDYTTG-tSgbVOXWA1CpjY,2242
+skills/retrospective/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+skills/retrospective/handler.py,sha256=CDgdwVFphk_4LQORbWTsFBS6tZDSFWdnQN29Ncwe5g8,5288
+skills/review/handler.py,sha256=-OIy-M2V_f9IYXdNdt1GiuFo1N0WI46RRgLvS2KEf0g,13539
+skills/security/handler.py,sha256=yAJGHSktFppPQHF0qCRLNuEDtIfR7OYPgBPz1XMx6Hw,17217
+skills/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+skills/test/handler.py,sha256=imWEJtswp7aOWeQ1fupwbk5qyJNYS5lBvuyXvdoTWck,3310
+devsquad-3.6.0.dist-info/METADATA,sha256=QRFK1sMIrsBKI3pm4UUool1q8QMM8lgNN1ywFQ8rP-Y,45435
+devsquad-3.6.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+devsquad-3.6.0.dist-info/entry_points.txt,sha256=9h61tKPkQeHCn2jCkXSkhPU7iWrb7dhj9Tshg1YDwLk,46
+devsquad-3.6.0.dist-info/top_level.txt,sha256=KmkXcHcHyHTs335-6-kswfgudjHF25nFPQIMILfMJWM,15
+devsquad-3.6.0.dist-info/RECORD,,

devsquad-3.6.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

devsquad-3.6.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devsquad = scripts.cli:main

devsquad-3.6.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Weiransoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

devsquad-3.6.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+scripts
+skills

scripts/ai_semantic_matcher.py

@@ -0,0 +1,512 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+AI 语义匹配器
+
+⚠️ 已弃用：此模块为 V2 遗留，V3 请使用 scripts.collaboration.ai_semantic_matcher
+
+基于大模型 AI 助手的语义理解能力，实现智能角色匹配。
+
+核心功能：
+1. 使用大模型理解任务需求的深层语义
+2. 基于角色能力描述进行智能匹配
+3. 提供匹配原因和置信度解释
+4. 支持多轮对话优化匹配结果
+
+技术优势：
+- 超越简单文本相似度，理解语义关联
+- 支持上下文感知的匹配
+- 可解释的匹配结果
+- 持续学习和优化
+"""
+
+import os
+import json
+from typing import Dict, List, Any, Optional, Tuple
+from dataclasses import dataclass, field
+from datetime import datetime
+import hashlib
+
+
+@dataclass
+class SemanticMatchResult:
+    """语义匹配结果"""
+    role_id: str
+    role_name: str
+    confidence: float  # 置信度 (0-1)
+    reasoning: str  # 匹配推理过程
+    matched_capabilities: List[str] = field(default_factory=list)
+    relevance_score: float = 0.0  # 相关性评分
+    explanation: str = ""  # 详细解释
+    metadata: Dict[str, Any] = field(default_factory=dict)
+
+
+class AISemanticMatcher:
+    """
+    AI 语义匹配器
+    
+    利用大模型 AI 助手的语义理解能力，实现智能角色匹配。
+    
+    工作原理：
+    1. 分析任务需求，提取关键语义信息
+    2. 理解角色能力和职责
+    3. 基于语义相似度进行匹配
+    4. 生成可解释的匹配结果
+    """
+    
+    def __init__(self, ai_client: Any = None):
+        """
+        初始化 AI 语义匹配器
+        
+        Args:
+            ai_client: AI 客户端实例（如 Trae AI 助手）
+        """
+        self.ai_client = ai_client
+        self.match_cache: Dict[str, SemanticMatchResult] = {}
+        self.match_history: List[Dict[str, Any]] = []
+        
+        # 匹配提示词模板
+        self.match_prompt_template = """
+你是一个智能角色匹配专家。请分析以下任务需求，并匹配最适合的角色。
+
+## 任务需求
+**标题**: {task_title}
+**描述**: {task_description}
+**所需能力**: {required_capabilities}
+**偏好技能**: {preferred_skills}
+
+## 可用角色
+{role_descriptions}
+
+## 匹配要求
+1. 分析任务的核心需求和关键能力要求
+2. 评估每个角色与任务的匹配度
+3. 考虑角色的专业能力和经验
+4. 提供匹配原因和置信度评分
+
+请以 JSON 格式返回匹配结果：
+{{
+    "matches": [
+        {{
+            "role_id": "角色 ID",
+            "role_name": "角色名称",
+            "confidence": 0.0-1.0,
+            "reasoning": "匹配推理过程",
+            "matched_capabilities": ["匹配的能力列表"],
+            "relevance_score": 0.0-1.0,
+            "explanation": "详细解释"
+        }}
+    ],
+    "best_match": "最佳匹配角色 ID",
+    "analysis": "整体分析"
+}}
+"""
+    
+    def match(self, 
+              task_title: str,
+              task_description: str,
+              roles: List[Dict[str, Any]],
+              required_capabilities: List[str] = None,
+              preferred_skills: List[str] = None,
+              use_cache: bool = True) -> List[SemanticMatchResult]:
+        """
+        使用 AI 进行智能角色匹配
+        
+        Args:
+            task_title: 任务标题
+            task_description: 任务描述
+            roles: 角色列表，每个角色包含 id, name, description, capabilities
+            required_capabilities: 必需能力列表
+            preferred_skills: 偏好技能列表
+            use_cache: 是否使用缓存
+            
+        Returns:
+            List[SemanticMatchResult]: 匹配结果列表
+        """
+        # 生成缓存键
+        cache_key = self._generate_cache_key(
+            task_title, task_description, roles
+        )
+        
+        # 检查缓存
+        if use_cache and cache_key in self.match_cache:
+            print(f"✅ 使用缓存的匹配结果")
+            return [self.match_cache[cache_key]]
+        
+        # 构建角色描述
+        role_descriptions = self._build_role_descriptions(roles)
+        
+        # 构建提示词
+        prompt = self.match_prompt_template.format(
+            task_title=task_title,
+            task_description=task_description,
+            required_capabilities=required_capabilities or [],
+            preferred_skills=preferred_skills or [],
+            role_descriptions=role_descriptions
+        )
+        
+        # 调用 AI 助手
+        try:
+            ai_response = self._call_ai_assistant(prompt)
+            
+            # 解析 AI 响应
+            results = self._parse_ai_response(ai_response, roles)
+            
+            # 缓存结果
+            if results and use_cache:
+                self.match_cache[cache_key] = results[0]
+            
+            # 记录历史
+            self._record_match(task_title, roles, results)
+            
+            return results
+            
+        except Exception as e:
+            print(f"❌ AI 匹配失败：{e}")
+            # 降级到传统匹配
+            return self._fallback_match(task_description, roles)
+    
+    def _build_role_descriptions(self, roles: List[Dict[str, Any]]) -> str:
+        """构建角色描述文本"""
+        descriptions = []
+        
+        for i, role in enumerate(roles, 1):
+            desc = f"""
+{i}. **{role.get('name', 'Unknown')}** ({role.get('id', 'unknown')})
+   - 职责：{role.get('description', '')}
+   - 能力：{', '.join(role.get('capabilities', []))}
+   - 技能：{', '.join(role.get('skills', []))}
+"""
+            descriptions.append(desc)
+        
+        return "\n".join(descriptions)
+    
+    def _call_ai_assistant(self, prompt: str) -> str:
+        """
+        调用 AI 助手
+        
+        Args:
+            prompt: 提示词
+            
+        Returns:
+            str: AI 响应
+        """
+        # 如果提供了 AI 客户端，使用真实 AI 调用
+        if self.ai_client:
+            try:
+                response = self.ai_client.complete(prompt)
+                return response
+            except Exception as e:
+                print(f"⚠️  AI 调用失败，使用模拟响应：{e}")
+        
+        # 模拟 AI 响应（用于测试和降级）
+        return self._simulate_ai_response(prompt)
+    
+    def _simulate_ai_response(self, prompt: str) -> str:
+        """
+        模拟 AI 响应
+        
+        在实际 AI 客户端不可用时使用
+        
+        Args:
+            prompt: 提示词
+            
+        Returns:
+            str: 模拟的 AI 响应
+        """
+        # 基于关键词的简单规则匹配
+        prompt_lower = prompt.lower()
+        
+        # 检测角色相关关键词
+        role_keywords = {
+            'architect': ['架构', '设计', '系统', '技术选型', '模块', '接口'],
+            'product-manager': ['需求', '产品', '用户', '功能', 'prd'],
+            'developer': ['开发', '实现', '代码', '功能', '编程'],
+            'tester': ['测试', '质量', 'bug', '用例', '验证'],
+            'ui-designer': ['ui', '设计', '界面', '交互', '视觉', '原型'],
+            'devops': ['部署', '运维', 'ci/cd', '监控', '容器']
+        }
+        
+        matches = []
+        for role_id, keywords in role_keywords.items():
+            score = sum(1 for kw in keywords if kw in prompt_lower)
+            if score > 0:
+                matches.append({
+                    'role_id': role_id,
+                    'score': score
+                })
+        
+        # 排序
+        matches.sort(key=lambda x: x['score'], reverse=True)
+        
+        # 构建响应
+        if matches:
+            best_match = matches[0]
+            response = {
+                "matches": [
+                    {
+                        "role_id": best_match['role_id'],
+                        "role_name": best_match['role_id'].replace('-', ' ').title(),
+                        "confidence": min(0.5 + best_match['score'] * 0.1, 0.95),
+                        "reasoning": f"基于关键词匹配，任务描述中包含 {best_match['score']} 个相关关键词",
+                        "matched_capabilities": ["相关能力"],
+                        "relevance_score": best_match['score'] / 10.0,
+                        "explanation": "任务需求与该角色职责高度相关"
+                    }
+                ],
+                "best_match": best_match['role_id'],
+                "analysis": f"通过分析任务描述，推荐 {best_match['role_id']} 角色"
+            }
+        else:
+            response = {
+                "matches": [],
+                "best_match": None,
+                "analysis": "未找到明确匹配的角色"
+            }
+        
+        return json.dumps(response, ensure_ascii=False)
+    
+    def _parse_ai_response(self, response: str, 
+                          roles: List[Dict[str, Any]]) -> List[SemanticMatchResult]:
+        """
+        解析 AI 响应
+        
+        Args:
+            response: AI 响应
+            roles: 角色列表
+            
+        Returns:
+            List[SemanticMatchResult]: 匹配结果
+        """
+        try:
+            # 尝试解析 JSON
+            if isinstance(response, str):
+                data = json.loads(response)
+            else:
+                data = response
+            
+            results = []
+            for match_data in data.get('matches', []):
+                result = SemanticMatchResult(
+                    role_id=match_data.get('role_id', ''),
+                    role_name=match_data.get('role_name', ''),
+                    confidence=float(match_data.get('confidence', 0.0)),
+                    reasoning=match_data.get('reasoning', ''),
+                    matched_capabilities=match_data.get('matched_capabilities', []),
+                    relevance_score=float(match_data.get('relevance_score', 0.0)),
+                    explanation=match_data.get('explanation', ''),
+                    metadata={
+                        'best_match': data.get('best_match'),
+                        'analysis': data.get('analysis')
+                    }
+                )
+                results.append(result)
+            
+            # 按置信度排序
+            results.sort(key=lambda r: r.confidence, reverse=True)
+            
+            return results
+            
+        except Exception as e:
+            print(f"❌ 解析 AI 响应失败：{e}")
+            return []
+    
+    def _fallback_match(self, task_description: str, 
+                       roles: List[Dict[str, Any]]) -> List[SemanticMatchResult]:
+        """
+        降级匹配策略
+        
+        当 AI 匹配失败时使用
+        
+        Args:
+            task_description: 任务描述
+            roles: 角色列表
+            
+        Returns:
+            List[SemanticMatchResult]: 匹配结果
+        """
+        print("⚠️  使用降级匹配策略")
+        
+        # 简单的关键词匹配
+        results = []
+        task_lower = task_description.lower()
+        
+        for role in roles:
+            # 计算关键词匹配度
+            keywords = role.get('keywords', [])
+            match_count = sum(1 for kw in keywords if kw.lower() in task_lower)
+            
+            if match_count > 0:
+                confidence = min(match_count / 5.0, 0.8)
+                result = SemanticMatchResult(
+                    role_id=role.get('id', ''),
+                    role_name=role.get('name', ''),
+                    confidence=confidence,
+                    reasoning=f"关键词匹配：{match_count} 个关键词匹配",
+                    matched_capabilities=role.get('capabilities', [])[:3],
+                    relevance_score=match_count / 10.0,
+                    explanation="基于关键词的简单匹配"
+                )
+                results.append(result)
+        
+        results.sort(key=lambda r: r.confidence, reverse=True)
+        return results
+    
+    def _generate_cache_key(self, task_title: str, 
+                           task_description: str,
+                           roles: List[Dict[str, Any]]) -> str:
+        """生成缓存键"""
+        content = f"{task_title}|{task_description}|{len(roles)}"
+        return hashlib.md5(content.encode('utf-8')).hexdigest()
+    
+    def _record_match(self, task_title: str, 
+                     roles: List[Dict[str, Any]],
+                     results: List[SemanticMatchResult]):
+        """记录匹配历史"""
+        record = {
+            'task_title': task_title,
+            'timestamp': datetime.now().isoformat(),
+            'roles_count': len(roles),
+            'results': [
+                {
+                    'role_id': r.role_id,
+                    'confidence': r.confidence,
+                    'reasoning': r.reasoning
+                } for r in results
+            ]
+        }
+        self.match_history.append(record)
+    
+    def get_match_history(self, limit: int = 10) -> List[Dict]:
+        """获取匹配历史"""
+        return self.match_history[-limit:]
+    
+    def clear_cache(self):
+        """清除缓存"""
+        self.match_cache.clear()
+        print("✅ 缓存已清除")
+    
+    def explain_match(self, result: SemanticMatchResult) -> str:
+        """
+        解释匹配结果
+        
+        Args:
+            result: 匹配结果
+            
+        Returns:
+            str: 解释文本
+        """
+        explanation = f"""
+🎯 匹配结果：{result.role_name} ({result.role_id})
+置信度：{result.confidence:.1%}
+相关性：{result.relevance_score:.1%}
+
+匹配原因:
+{result.reasoning}
+
+详细说明:
+{result.explanation}
+
+匹配的能力:
+{', '.join(result.matched_capabilities) if result.matched_capabilities else '无'}
+"""
+        return explanation.strip()
+
+
+def main():
+    """示例用法"""
+    # 创建匹配器
+    matcher = AISemanticMatcher()
+    
+    # 定义角色
+    roles = [
+        {
+            'id': 'architect',
+            'name': '架构师',
+            'description': '负责系统架构设计和技术选型',
+            'capabilities': ['系统架构设计', '技术选型', '架构评审'],
+            'skills': ['架构设计', '系统设计'],
+            'keywords': ['架构', '设计', '系统', '选型']
+        },
+        {
+            'id': 'product-manager',
+            'name': '产品经理',
+            'description': '负责需求分析和产品规划',
+            'capabilities': ['需求分析', '产品规划', '用户研究'],
+            'skills': ['需求挖掘', '文档编写'],
+            'keywords': ['需求', '产品', '用户', '功能']
+        },
+        {
+            'id': 'developer',
+            'name': '开发工程师',
+            'description': '负责代码实现和功能开发',
+            'capabilities': ['代码实现', '功能开发', '代码优化'],
+            'skills': ['编程', '调试'],
+            'keywords': ['开发', '实现', '代码', '编程']
+        }
+    ]
+    
+    # 测试任务
+    tasks = [
+        {
+            'title': '设计微服务架构',
+            'description': '设计一个高可用的微服务架构，需要考虑服务拆分、通信机制和部署方案',
+            'required_capabilities': ['系统架构设计'],
+            'preferred_skills': ['架构设计']
+        },
+        {
+            'title': '实现用户管理功能',
+            'description': '实现用户注册、登录、权限管理等功能',
+            'required_capabilities': ['代码实现'],
+            'preferred_skills': ['编程']
+        },
+        {
+            'title': '分析用户需求',
+            'description': '分析用户需求，编写 PRD 文档，定义产品功能',
+            'required_capabilities': ['需求分析'],
+            'preferred_skills': ['文档编写']
+        }
+    ]
+    
+    # 执行匹配
+    print("="*80)
+    print("AI 语义匹配测试")
+    print("="*80)
+    
+    for task in tasks:
+        print(f"\n📋 任务：{task['title']}")
+        print("-" * 80)
+        
+        results = matcher.match(
+            task_title=task['title'],
+            task_description=task['description'],
+            roles=roles,
+            required_capabilities=task.get('required_capabilities'),
+            preferred_skills=task.get('preferred_skills')
+        )
+        
+        if results:
+            best = results[0]
+            print(f"✅ 最佳匹配：{best.role_name} ({best.role_id})")
+            print(f"   置信度：{best.confidence:.1%}")
+            print(f"   相关性：{best.relevance_score:.1%}")
+            print(f"   原因：{best.reasoning}")
+            print(f"\n📝 详细说明:")
+            print(f"   {best.explanation}")
+        else:
+            print("❌ 未找到匹配的角色")
+    
+    # 显示匹配历史
+    print("\n" + "="*80)
+    print("匹配历史")
+    print("="*80)
+    history = matcher.get_match_history()
+    for record in history:
+        print(f"任务：{record['task_title']}")
+        print(f"时间：{record['timestamp']}")
+        print(f"结果：{len(record['results'])} 个匹配")
+        print()
+
+
+if __name__ == "__main__":
+    main()