opencode-collaboration 2.2.0.post2__py3-none-any.whl → 2.2.0.post4__py3-none-any.whl

{opencode_collaboration-2.2.0.post2.dist-info → opencode_collaboration-2.2.0.post4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-collaboration
-Version: 2.2.0.post2
+Version: 2.2.0.post4
 Summary: 双Agent协作框架 - 产品经理与开发的分离式协作工具
 Author-email: liuzhen <dev@opencode.ai>
 License: MIT

{opencode_collaboration-2.2.0.post2.dist-info → opencode_collaboration-2.2.0.post4.dist-info}/RECORD

@@ -2,7 +2,7 @@ src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/main.py,sha256=W_G68r7XFyioa8wHlSsdwBK1eIyWDaIQWciyZxhZHgg,15
 src/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/cli/agent.py,sha256=o8-3UpfcnUMePltpBdVBuBFMECMiKnOA7airyvi1m54,9874
-src/cli/main.py,sha256=E91PR24_r1gfKPlmtgQin2OZ-YHCck4dUe01X81FpIo,44189
+src/cli/main.py,sha256=nzC2NCkDgqKMSv2WZPJqMk-050V-APfe_FbirOddXQM,50007
 src/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/core/agent_manager.py,sha256=Mxe4G_IfEaQ1lERdGNfMvK0tIS6DuE3WJUNOxgtAD8o,16535
 src/core/auto_doc_git.py,sha256=_yphH8tLAMq3R-yMHpc2bcmmap2p7b2So4qVmXUtCh8,1396
@@ -10,7 +10,8 @@ src/core/auto_docs.py,sha256=rQfJrrKGe8fiQK4eSq4gAp1rfFAu_o-sDV_ZloaFQVQ,11142
 src/core/auto_engine.py,sha256=bV9VXa0naPpxKuE7p7xHAZKZJe9DIGfzrFwHhiaDHKA,16031
 src/core/auto_git_sync.py,sha256=jklR_NOYBXYgRSdG0rMRgvQM3jvRBpvm-qSjc-vDK28,2077
 src/core/auto_retry.py,sha256=qG4UY2d312PoECJKKuIq3qspe6qP1mTMEQ4M2Y9J1oo,7571
-src/core/brain_engine.py,sha256=OJliBiMIxMwTCyEMJW0Os9SRpB5mCf3ujCnvjFVbLcg,14893
+src/core/brain_engine.py,sha256=b6PtFde-zkFfCtDihd1es-BEROA_6wQXBJV9S_fL9WE,15032
+src/core/change_compliance.py,sha256=twFvW5gwEpzJHtPubkYJqV2xnzpHRPmczkRvGDVuRSE,3574
 src/core/config_reloader.py,sha256=Fne2FJ-AgPNnqV7Ody-nRpLOSptde65ZXqyGoFl-PbE,8726
 src/core/daemon.py,sha256=pu776YVEC-dw4mKFh7JZg4q7R6XGPe52wiQtwnsQxb4,6470
 src/core/design_review_notifier.py,sha256=XlWyPXUZ7V4CeWdvgf92QBqbrSvO_VzBW7VhUWmlRqk,9826
@@ -27,22 +28,26 @@ src/core/monitor.py,sha256=3s0xuc6l7pF4MtnRjYVxbfn8MLfKk7p7mljqtsZDQZ0,8949
 src/core/phase_advance.py,sha256=76UN8TI7RpJgRfjgV4bvs7uWlvNt-h_dz6gTDgK2zrY,11285
 src/core/project_manager.py,sha256=qayc8NHy3go26LWZgw17nL57p8LXKjpprAS1_iKZHDg,16637
 src/core/resource_lock.py,sha256=1G2yOdbqZnWqVdcIt6IKbhRLhSg23kLgJhdwiFt7jdY,13889
-src/core/signoff.py,sha256=fG6KFNz3AYh6hKYMPfognU_SBs5amCW2q4bne4huFf0,6643
+src/core/session_manager.py,sha256=2Hr36C71kIPia4UYKXx8Ym86T7_9TTQxC8ZrXm65IZU,6825
+src/core/signoff.py,sha256=Zl5rV7C6X3tg1xwZiePH5kbetmOGReJIN4ydhQIjtxY,8037
+src/core/signoff_record_manager.py,sha256=66ZqKdVzYR2-oGprbvfu-QXEMHH0yj3Byzetsq3wPv8,3051
 src/core/state_machine.py,sha256=L1gfdsYC6mlWcHP5RwQQen8vCTwV2spIP-Ktwz4gux8,14919
 src/core/state_manager.py,sha256=jkgci5q71DRjmKe8igeFhOTxHJ2xqNjAHJo6THFtw_M,16672
 src/core/state_migrator.py,sha256=OYXtwxA_ePFAS_XqOMhKR2fyU1werLePbqCyNZg8eXQ,13746
 src/core/state_validator.py,sha256=Q86jbEO0fNdzDi3zIPB_G_ibQ0QWyXFYV_rPj6Eakjw,18827
 src/core/story_manager.py,sha256=8b0Kelw6zdvZYr9sb0Rnlf7_XeXXOSdVar4q2vQjdbI,21867
 src/core/supervisor.py,sha256=pT_5CkimpFgB_gyqzsUL-25l3MsRGP1TWFEnHdGJtwo,7290
-src/core/task_executor.py,sha256=xcM9sNu8MyAVqlNvtc2GL4eiYeTMmeduTrrA3j292aM,23720
+src/core/task_executor.py,sha256=l3FeVe5yWZ-z8mwfucCsp5FwXhc2Rvpw5zJEu7u2Kso,24881
 src/core/workflow.py,sha256=LpH9g6xbtCmYOhhCSxpcstRR7TptN8e6b0mEag3UcW4,5634
+src/core/workflow_inference.py,sha256=XU8Z32H4z4MGj5AUS2x9gmS88nD9UL7xWQueXJRlvmA,6093
 src/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/utils/date.py,sha256=iWS0hTaoDE2iC0jJb3lTIB5yK5xxRbrC1C98Fgb8LFc,577
+src/utils/environment.py,sha256=zowgHHBIZ8fgVAZ_fP_I4mX7S9zSn3mvPvnFUYIethE,1509
 src/utils/file.py,sha256=5IFKkT2m1emJUHDzIiLsa4YG9GCqOhhmiLvc6aVY9-Y,1301
 src/utils/lock.py,sha256=soxYFsBKJHUzN-_QXkorVfgnmt0D5p1SZtqwPNqcWPI,2880
 src/utils/yaml.py,sha256=zcbh0OP7NOqxTexEAR3akQkllUh8xeKt42O2CHIImyg,777
-opencode_collaboration-2.2.0.post2.dist-info/METADATA,sha256=Go86yt_j1okQlr3gYOlj4EJRPASxF24oKMi2txN0FEo,3127
-opencode_collaboration-2.2.0.post2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-opencode_collaboration-2.2.0.post2.dist-info/entry_points.txt,sha256=fYyHWa_NefMp527B7fHl-29SwZQCElRdtxm_7LoUK-Y,48
-opencode_collaboration-2.2.0.post2.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-opencode_collaboration-2.2.0.post2.dist-info/RECORD,,
+opencode_collaboration-2.2.0.post4.dist-info/METADATA,sha256=9kWRm0S8WLlmBDyc6OY9aQM74-aY5LxJTGxLGNR9HiI,3127
+opencode_collaboration-2.2.0.post4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+opencode_collaboration-2.2.0.post4.dist-info/entry_points.txt,sha256=fYyHWa_NefMp527B7fHl-29SwZQCElRdtxm_7LoUK-Y,48
+opencode_collaboration-2.2.0.post4.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+opencode_collaboration-2.2.0.post4.dist-info/RECORD,,

src/cli/main.py

@@ -17,6 +17,7 @@ from ..core.auto_engine import AutoCollaborationEngine, TodoCommandExecutor, Wor
 from ..core.auto_retry import AutoRetry, AutoRetryConfig
 from ..core.auto_docs import AutoDocs, AutoDocsConfig
 from ..core.phase_advance import PhaseAdvanceEngine
+from ..core.session_manager import SessionManager
 from ..utils.lock import LockExistsError
 
 
@@ -123,6 +124,9 @@ def status_command():
         req_status = state_manager.get_signoff_status("requirements")
         console.print(f"需求签署 - 产品经理: {'✓' if req_status['pm_signoff'] else '✗'}, 开发: {'✓' if req_status['dev_signoff'] else '✗'}")
 
+        session_manager = SessionManager(project_path)
+        session_manager.show_welcome(active_agent)
+
     except StateFileNotFoundError:
         click.echo("错误: 未找到项目状态文件，请先初始化项目")
         sys.exit(1)
@@ -136,22 +140,33 @@ def status_command():
 
 @main.command("switch")
 @click.argument("agent_id", type=click.IntRange(1, 2))
-def switch_command(agent_id: int):
+@click.option("--welcome/--no-welcome", "-w", default=True, help="显示欢迎信息")
+def switch_command(agent_id: int, welcome: bool):
     """切换Agent角色。"""
     try:
         project_path = get_project_path()
         state_manager = StateManager(project_path)
-        
+
         current_agent = state_manager.get_active_agent()
         if current_agent == f"agent{agent_id}":
             click.echo(f"已经是 Agent {agent_id}")
             return
-        
+
         state_manager.set_active_agent(f"agent{agent_id}")
-        
-        agent_info = state_manager.load_state()["agents"][f"agent{agent_id}"]
-        click.echo(f"已切换到 Agent {agent_id} ({agent_info['role']})")
-        
+
+        if welcome:
+            session_manager = SessionManager(project_path)
+            session_manager.show_welcome(f"agent{agent_id}")
+        else:
+            try:
+                state = state_manager.load_state()
+                agents = state.get("agents", {})
+                agent_info = agents.get(f"agent{agent_id}", {})
+                role = agent_info.get("role", "未知")
+            except Exception:
+                role = "未知"
+            click.echo(f"已切换到 Agent {agent_id} ({role})")
+
     except Exception as e:
         click.echo(f"错误: {e}")
         sys.exit(1)
@@ -159,26 +174,27 @@ def switch_command(agent_id: int):
 
 @main.command("review")
 @click.argument("stage", type=click.Choice(["requirements", "design", "test"]))
+@click.option("--file", "-f", help="指定评审文件路径")
 @click.option("--new", is_flag=True, default=False)
 @click.option("--list", "-l", is_flag=True, default=False)
-def review_command(stage: str, new: bool, list: bool):
+def review_command(stage: str, file: str, new: bool, list: bool):
     """管理评审流程。"""
     try:
         project_path = get_project_path()
         state_manager = StateManager(project_path)
         workflow_engine = WorkflowEngine(state_manager)
-        
+
         if new:
             workflow_engine.start_review(stage)
             click.echo(f"已发起 {stage} 评审")
-        
+
         if list:
             history = state_manager.get_history()
             console.print(f"\n[bold]{stage.upper()} 评审历史[/bold]")
             for item in history[:10]:
                 if "review" in item["action"] or "signoff" in item["action"]:
                     console.print(f"- {item['timestamp']}: Agent {item['agent']} - {item['details']}")
-        
+
     except Exception as e:
         click.echo(f"错误: {e}")
         sys.exit(1)
@@ -188,26 +204,74 @@ def review_command(stage: str, new: bool, list: bool):
 @click.argument("stage", type=click.Choice(["requirements", "design", "test"]))
 @click.option("--comment", "-m", default="")
 @click.option("--reject", "-r", default=None)
-def signoff_command(stage: str, comment: str, reject: str):
+@click.option("--sync", "-s", is_flag=True, default=False, help="签署后自动同步到远程")
+def signoff_command(stage: str, comment: str, reject: str, sync: bool):
     """签署确认。"""
     try:
         project_path = get_project_path()
         state_manager = StateManager(project_path)
         workflow_engine = WorkflowEngine(state_manager)
         signoff_engine = SignoffEngine(state_manager, workflow_engine)
-        
+
         agent_id = state_manager.get_active_agent()
-        
+
         if reject:
             result = signoff_engine.reject(stage, agent_id, reject)
             click.echo(f"已拒签 {stage} 阶段")
         else:
-            result = signoff_engine.sign(stage, agent_id, comment)
-            click.echo(f"已签署 {stage} 阶段")
-            
+            if sync:
+                from ..core.git import GitHelper
+                git_helper = GitHelper(project_path)
+                result = signoff_engine.signoff_with_sync(stage, agent_id, comment, git_helper)
+                click.echo(result.message)
+            else:
+                result = signoff_engine.sign(stage, agent_id, comment)
+                click.echo(f"已签署 {stage} 阶段")
+
             if state_manager.can_proceed_to_next_phase():
                 click.echo("双方已签署，可以推进到下一阶段")
-        
+
+    except Exception as e:
+        click.echo(f"错误: {e}")
+        sys.exit(1)
+
+
+@main.command("signoffs")
+@click.option("--list", "-l", is_flag=True, default=False, help="列出所有签署记录")
+@click.option("--id", "-i", help="查看特定签署记录ID")
+def signoffs_command(list: bool, id: str):
+    """查看签署记录。"""
+    try:
+        from ..core.signoff_record_manager import SignoffRecordManager
+
+        project_path = get_project_path()
+        manager = SignoffRecordManager(project_path)
+
+        if id:
+            record = manager.get_signoff(id)
+            if record:
+                console.print(f"\n[bold]签署记录: {id}[/bold]")
+                console.print(f"里程碑: {record.get('milestone')}")
+                console.print(f"阶段: {record.get('phase')}")
+                console.print(f"状态: {record.get('status')}")
+                console.print("\n签署者:")
+                for signer in record.get("signers", []):
+                    status_icon = "✓" if signer.get("status") == "approved" else "○"
+                    console.print(f"  {status_icon} {signer.get('role')} ({signer.get('agent')}) - {signer.get('timestamp')}")
+            else:
+                click.echo(f"未找到签署记录: {id}")
+        elif list:
+            signoffs = manager.list_signoffs()
+            if signoffs:
+                console.print("\n[bold]签署记录列表[/bold]")
+                for record in signoffs:
+                    status_icon = "✓" if record.get("status") == "APPROVED" else "○"
+                    console.print(f"{status_icon} {record.get('signoff_id')} - {record.get('milestone')} - {record.get('phase')}")
+            else:
+                click.echo("暂无签署记录")
+        else:
+            click.echo("请使用 --list 列出所有记录，或 --id 查看特定记录")
+
     except Exception as e:
         click.echo(f"错误: {e}")
         sys.exit(1)
@@ -1104,5 +1168,87 @@ def advance_command(phase: str, force: bool, check: bool):
         sys.exit(1)
 
 
+@main.command("workflow")
+@click.option("--check", "-c", is_flag=True, help="显示合规检查结果")
+@click.option("--suggest", "-s", is_flag=True, help="显示下一步建议")
+def workflow_command(check: bool, suggest: bool):
+    """查看当前工作流状态和推理。"""
+    try:
+        from ..core.workflow_inference import WorkflowInferenceEngine
+
+        project_path = get_project_path()
+        state_manager = StateManager(project_path)
+        engine = WorkflowInferenceEngine(project_path, state_manager)
+
+        result = engine.infer_next_action()
+
+        if result.unknown:
+            click.echo("⚠️ 无法确定当前流程状态")
+            click.echo("请先初始化项目: oc-collab project init")
+        else:
+            console.print(Panel(
+                f"当前阶段: {result.current_phase}\n\n{result.suggestion}",
+                title="工作流状态",
+                style="blue"
+            ))
+
+            if check or suggest:
+                compliance = result.compliance_check
+                if compliance.valid:
+                    click.echo("\n✅ 流程合规")
+                else:
+                    click.echo("\n⚠️ 流程不合规:")
+                    for violation in compliance.violations:
+                        click.echo(f"  - {violation}")
+                    for suggestion in compliance.suggestions:
+                        click.echo(f"  💡 {suggestion}")
+
+    except Exception as e:
+        click.echo(f"错误: {e}")
+        sys.exit(1)
+
+
+@main.command("compliance")
+@click.option("--prd", "-p", help="检查 PRD 文件")
+@click.option("--rfc", "-r", help="检查 RFC 文件")
+@click.option("--detect", "-d", is_flag=True, help="检测冲突")
+def compliance_command(prd: str, rfc: str, detect: bool):
+    """检查变更合规性。"""
+    try:
+        from ..core.change_compliance import ChangeComplianceChecker
+
+        project_path = get_project_path()
+        checker = ChangeComplianceChecker(project_path)
+
+        if prd:
+            result = checker.check_prd_compliance(prd)
+            if result.valid:
+                click.echo("✅ PRD 合规")
+            else:
+                for v in result.violations:
+                    click.echo(f"❌ {v}")
+
+        if rfc:
+            result = checker.check_rfc_compliance(rfc, prd)
+            if result.valid:
+                click.echo("✅ RFC 合规")
+            else:
+                for v in result.violations:
+                    click.echo(f"❌ {v}")
+
+        if detect and prd and rfc:
+            conflicts = checker.detect_conflicts(prd, rfc)
+            if conflicts:
+                click.echo(f"⚠️ 发现 {len(conflicts)} 个冲突:")
+                for c in conflicts:
+                    click.echo(f"  - {c.type}: {c.description}")
+            else:
+                click.echo("✅ 未检测到冲突")
+
+    except Exception as e:
+        click.echo(f"错误: {e}")
+        sys.exit(1)
+
+
 if __name__ == "__main__":
     main()

src/core/brain_engine.py

@@ -141,11 +141,11 @@ class BrainEngine:
                 agent_type=AgentType.AGENT_1,
                 conditions=[
                     Condition("phase_equals", {"value": "requirements_review"}),
-                    Condition("signoff_complete", {"stage": "requirements"})
+                    Condition("custom", {"function": lambda ctx: not ctx.get("signoff", {}).get("requirements", {}).get("pm_signoff", False)})
                 ],
                 action=ActionType.SIGNOFF_REQUIREMENTS,
                 priority=90,
-                description="当阶段为requirements_review且双方签署后，签署需求"
+                description="当阶段为requirements_review且Agent1未签署时，签署需求"
             ),
             Rule(
                 id="agent1-review-design",
@@ -191,11 +191,11 @@ class BrainEngine:
                 agent_type=AgentType.AGENT_2,
                 conditions=[
                     Condition("phase_equals", {"value": "requirements_review"}),
-                    Condition("signoff_complete", {"stage": "requirements"})
+                    Condition("custom", {"function": lambda ctx: not ctx.get("signoff", {}).get("requirements", {}).get("dev_signoff", False)})
                 ],
                 action=ActionType.SIGNOFF_REQUIREMENTS,
                 priority=95,
-                description="当阶段为requirements_review且双方签署后，签署需求"
+                description="当阶段为requirements_review且Agent2未签署时，签署需求"
             ),
             Rule(
                 id="agent2-create-design",

src/core/change_compliance.py

@@ -0,0 +1,112 @@
+"""变更合规检查器模块。"""
+from pathlib import Path
+from typing import List, Dict, Any, Optional, Tuple
+from dataclasses import dataclass, field
+import re
+import logging
+
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass
+class ComplianceResult:
+    """合规检查结果"""
+    valid: bool
+    violations: List[str] = field(default_factory=list)
+    warnings: List[str] = field(default_factory=list)
+    suggestions: List[str] = field(default_factory=list)
+
+
+@dataclass
+class Conflict:
+    """冲突信息"""
+    type: str
+    file: str
+    description: str
+    details: str
+
+
+class ChangeComplianceChecker:
+    """变更合规检查器"""
+
+    PRD_PATTERN = r'(?:FR|UR|NFR|BUG)-[\w]+(?:[-][\w]+)*'
+    RFC_PATTERN = r'RFC-[\d]+'
+
+    def __init__(self, project_path: str):
+        self.project_path = Path(project_path)
+
+    def check_prd_compliance(self, prd_file: str) -> ComplianceResult:
+        """检查 PRD 合规性"""
+        result = ComplianceResult(valid=True)
+
+        if not Path(prd_file).exists():
+            result.valid = False
+            result.violations.append(f"PRD 文件不存在: {prd_file}")
+            return result
+
+        with open(prd_file, 'r') as f:
+            content = f.read()
+
+        if "## 签署确认" not in content:
+            result.violations.append("PRD 缺少签署确认章节")
+            result.suggestions.append("请添加签署确认表格")
+
+        prd_ids = re.findall(self.PRD_PATTERN, content)
+        if prd_ids:
+            result.warnings.append(f"发现 {len(set(prd_ids))} 个需求 ID，建议检查追溯性")
+
+        return result
+
+    def check_rfc_compliance(self, rfc_file: str, prd_file: str = None) -> ComplianceResult:
+        """检查 RFC 合规性"""
+        result = ComplianceResult(valid=True)
+
+        if not Path(rfc_file).exists():
+            result.valid = False
+            result.violations.append(f"RFC 文件不存在: {rfc_file}")
+            return result
+
+        with open(rfc_file, 'r') as f:
+            content = f.read()
+
+        rfc_ids = re.findall(self.RFC_PATTERN, content)
+        if rfc_ids:
+            result.suggestions.append(f"发现 {len(set(rfc_ids))} 个 RFC 引用")
+
+        if prd_file and Path(prd_file).exists():
+            with open(prd_file, 'r') as f:
+                prd_content = f.read()
+
+            if content.strip()[-100:] in prd_content[-200:]:
+                result.warnings.append("RFC 内容可能已包含在 PRD 中，可作为记录无需单独评审")
+
+        return result
+
+    def detect_conflicts(self, prd_file: str, rfc_file: str) -> List[Conflict]:
+        """检测 PRD 与 RFC 之间的冲突"""
+        conflicts = []
+
+        if not Path(prd_file).exists() or not Path(rfc_file).exists():
+            return conflicts
+
+        with open(prd_file, 'r') as f:
+            prd_content = f.read()
+
+        with open(rfc_file, 'r') as f:
+            rfc_content = f.read()
+
+        prd_ids = set(re.findall(self.PRD_PATTERN, prd_content))
+        rfc_refs = set(re.findall(self.RFC_PATTERN, rfc_content))
+
+        for prd_id in prd_ids:
+            for rfc_ref in rfc_refs:
+                if prd_id in rfc_content and prd_id not in rfc_ref:
+                    conflicts.append(Conflict(
+                        type="内容冲突",
+                        file=f"PRD vs RFC",
+                        description=f"需求 {prd_id} 在 RFC 中被引用，但 RFC 编号不一致",
+                        details=f"PRD 引用: {prd_id}, RFC 内容: 包含 {prd_id}"
+                    ))
+
+        return conflicts

src/core/session_manager.py

@@ -0,0 +1,213 @@
+from pathlib import Path
+from typing import Optional, List
+from rich.console import Console
+from rich.panel import Panel
+from rich.text import Text
+
+from .state_manager import StateManager
+
+console = Console()
+
+AGENT_ROLES = {
+    "agent1": {
+        "role": "产品经理",
+        "responsibilities": [
+            "编写和评审需求文档",
+            "定义验收标准",
+            "签署需求确认",
+            "评审设计文档",
+            "评审测试报告"
+        ]
+    },
+    "agent2": {
+        "role": "开发负责人",
+        "responsibilities": [
+            "评审需求文档",
+            "编写详细设计",
+            "代码实现",
+            "编写单元测试",
+            "签署技术确认"
+        ]
+    }
+}
+
+COMMON_COMMANDS = [
+    ("oc-collab status", "查看项目状态"),
+    ("oc-collab todo", "查看待办事项"),
+    ("oc-collab review", "评审文档"),
+    ("oc-collab signoff", "签署确认"),
+    ("oc-collab history", "查看协作历史"),
+    ("oc-collab switch <1|2>", "切换Agent角色")
+]
+
+
+class SessionConfig:
+    def __init__(self, project_path: str):
+        self.project_path = project_path
+        self.enabled = True
+        self.show_responsibilities = True
+        self.show_todo = True
+        self.show_pending = True
+        self.load_config()
+
+    def load_config(self):
+        state_file = Path(self.project_path) / "state" / "project_state.yaml"
+        if state_file.exists():
+            try:
+                import yaml
+                with open(state_file) as f:
+                    state = yaml.safe_load(f) or {}
+                session_config = state.get("session_start", {})
+                self.enabled = session_config.get("enabled", True)
+                self.show_responsibilities = session_config.get("show_responsibilities", True)
+                self.show_todo = session_config.get("show_todo", True)
+                self.show_pending = session_config.get("show_pending", True)
+            except Exception:
+                pass
+
+
+class SessionManager:
+    def __init__(self, project_path: str):
+        self.project_path = project_path
+        self.state_manager = StateManager(project_path)
+        self.config = SessionConfig(project_path)
+
+    def get_project_info(self) -> dict:
+        try:
+            state = self.state_manager.load_state()
+            metadata = state.get("metadata", {})
+            project_info = state.get("project", {})
+
+            return {
+                "name": metadata.get("project_name") or project_info.get("name", "未配置"),
+                "phase": project_info.get("phase") or state.get("phase", "未知"),
+                "milestone": state.get("current_milestone", "待定义")
+            }
+        except Exception:
+            return {"name": "未配置", "phase": "未知", "milestone": "待定义"}
+
+    def get_agent_info(self, agent_id: str) -> dict:
+        agent_config = AGENT_ROLES.get(agent_id, {
+            "role": "未知",
+            "responsibilities": []
+        })
+
+        try:
+            state = self.state_manager.load_state()
+            agents = state.get("agents", {})
+            agent_state = agents.get(agent_id, {})
+        except KeyError:
+            agent_state = {}
+        except Exception:
+            agent_state = {}
+
+        return {
+            "id": agent_id,
+            "role": agent_config["role"],
+            "current_task": agent_state.get("current_task", ""),
+            "responsibilities": agent_config["responsibilities"]
+        }
+
+    def get_responsibilities_text(self, agent_id: str) -> str:
+        agent = self.get_agent_info(agent_id)
+        if not self.config.show_responsibilities:
+            return ""
+
+        lines = ["你的职责:"]
+        for resp in agent["responsibilities"]:
+            lines.append(f"  - {resp}")
+        return "\n".join(lines)
+
+    def get_todo_items(self) -> str:
+        if not self.config.show_todo:
+            return ""
+
+        try:
+            from .auto_engine import TodoCommandExecutor
+            executor = TodoCommandExecutor(self.project_path)
+            todo_list = executor.get_todo_list()
+
+            if not todo_list:
+                return "待办事项:\n  暂无待办事项"
+
+            lines = ["待办事项:"]
+            for item in todo_list[:5]:
+                task = item.get("task", "")
+                lines.append(f"  [ ] {task}")
+            return "\n".join(lines)
+        except Exception:
+            return "待办事项:\n  暂无待办事项"
+
+    def get_pending_issues(self) -> str:
+        if not self.config.show_pending:
+            return ""
+
+        pending_file = Path(self.project_path) / "state" / "memory" / "pending.yaml"
+        if not pending_file.exists():
+            return "上次会话遗留:\n  无遗留问题"
+
+        try:
+            import yaml
+            with open(pending_file) as f:
+                pending = yaml.safe_load(f) or []
+
+            if not pending:
+                return "上次会话遗留:\n  无遗留问题"
+
+            lines = ["上次会话遗留:"]
+            for item in pending[:5]:
+                desc = item.get("description", item)
+                lines.append(f"  - {desc}")
+            return "\n".join(lines)
+        except Exception:
+            return "上次会话遗留:\n  无遗留问题"
+
+    def get_common_commands(self) -> str:
+        lines = ["常用命令:"]
+        for cmd, desc in COMMON_COMMANDS:
+            lines.append(f"  - {cmd}: {desc}")
+        return "\n".join(lines)
+
+    def get_welcome_message(self, agent_id: str) -> str:
+        if not self.config.enabled:
+            return ""
+
+        project = self.get_project_info()
+        agent = self.get_agent_info(agent_id)
+
+        parts = [
+            f"=== Agent {agent_id.replace('agent', '')} ({agent['role']}) ===",
+            "",
+            f"当前项目: {project['name']}",
+            f"当前阶段: {project['phase']}",
+            f"当前里程碑: {project['milestone']}",
+            ""
+        ]
+
+        resp_text = self.get_responsibilities_text(agent_id)
+        if resp_text:
+            parts.append(resp_text)
+            parts.append("")
+
+        todo_text = self.get_todo_items()
+        if todo_text:
+            parts.append(todo_text)
+            parts.append("")
+
+        pending_text = self.get_pending_issues()
+        if pending_text:
+            parts.append(pending_text)
+            parts.append("")
+
+        parts.append(self.get_common_commands())
+
+        return "\n".join(parts)
+
+    def show_welcome(self, agent_id: str):
+        message = self.get_welcome_message(agent_id)
+        if message:
+            console.print(Panel(
+                Text(message, justify="left"),
+                title="会话引导",
+                style="blue"
+            ))

src/core/signoff.py

@@ -1,5 +1,6 @@
 """签署引擎模块。"""
-from typing import Tuple
+from typing import Tuple, Optional
+from dataclasses import dataclass
 
 
 class SignoffError(Exception):
@@ -27,6 +28,22 @@ class RejectionError(SignoffError):
     pass
 
 
+@dataclass
+class SignoffResult:
+    """签署结果"""
+    success: bool
+    message: str
+    synced: bool = False
+    sync_error: Optional[str] = None
+
+
+@dataclass
+class SyncResult:
+    """同步结果"""
+    success: bool
+    message: str
+
+
 class SignoffEngine:
     """签署引擎。"""
     
@@ -194,3 +211,36 @@ class SignoffEngine:
                 return False
         
         return True
+    
+    def signoff_with_sync(self, stage: str, agent: str, comment: str = "", git_helper=None) -> SignoffResult:
+        """执行签署并同步到远程"""
+        try:
+            sign_result = self.sign(stage, agent, comment)
+            
+            synced = False
+            sync_error = None
+            
+            if git_helper:
+                try:
+                    git_helper.push()
+                    synced = True
+                except Exception as e:
+                    sync_error = str(e)
+            
+            message = f"签署成功: {stage} 阶段"
+            if synced:
+                message += "\n✓ 已同步到远程仓库"
+            elif sync_error:
+                message += f"\n⚠ 同步失败: {sync_error}"
+            
+            return SignoffResult(
+                success=True,
+                message=message,
+                synced=synced,
+                sync_error=sync_error
+            )
+        except SignoffError as e:
+            return SignoffResult(
+                success=False,
+                message=f"签署失败: {e}"
+            )

src/core/signoff_record_manager.py

@@ -0,0 +1,94 @@
+"""签署记录管理器模块。"""
+from pathlib import Path
+from typing import List, Optional, Dict, Any
+import yaml
+from datetime import datetime
+from dataclasses import dataclass, asdict
+
+
+@dataclass
+class SignoffRecord:
+    """签署记录"""
+    signoff_id: str
+    milestone: str
+    phase: str
+    signers: List[Dict[str, Any]]
+    status: str
+    created_at: str
+
+    def to_dict(self) -> Dict[str, Any]:
+        return asdict(self)
+
+
+class SignoffRecordManager:
+    """签署记录管理器"""
+
+    def __init__(self, project_path: str):
+        self.project_path = Path(project_path)
+        self.signoffs_dir = self.project_path / "state" / "signoffs"
+        self.signoffs_dir.mkdir(parents=True, exist_ok=True)
+
+    def _generate_signoff_id(self, milestone: str) -> str:
+        """生成签署记录ID"""
+        timestamp = datetime.now().strftime("%Y%m%d")
+        return f"SIG-{milestone}-{timestamp}"
+
+    def save_signoff(self, milestone: str, phase: str, signers: List[Dict[str, Any]], status: str = "PENDING") -> str:
+        """保存签署记录"""
+        signoff_id = self._generate_signoff_id(milestone)
+
+        record = SignoffRecord(
+            signoff_id=signoff_id,
+            milestone=milestone,
+            phase=phase,
+            signers=signers,
+            status=status,
+            created_at=datetime.now().isoformat()
+        )
+
+        file_path = self.signoffs_dir / f"{signoff_id}.yaml"
+        with open(file_path, 'w') as f:
+            yaml.dump(record.to_dict(), f)
+
+        return signoff_id
+
+    def get_signoff(self, signoff_id: str) -> Optional[Dict[str, Any]]:
+        """获取签署记录"""
+        file_path = self.signoffs_dir / f"{signoff_id}.yaml"
+
+        if file_path.exists():
+            with open(file_path) as f:
+                return yaml.safe_load(f)
+
+        return None
+
+    def list_signoffs(self) -> List[Dict[str, Any]]:
+        """列出所有签署记录"""
+        signoffs = []
+        for file_path in self.signoffs_dir.glob("*.yaml"):
+            with open(file_path) as f:
+                signoffs.append(yaml.safe_load(f))
+        return signoffs
+
+    def update_signoff_status(self, signoff_id: str, status: str, signer: Dict[str, Any] = None):
+        """更新签署记录状态"""
+        record = self.get_signoff(signoff_id)
+        if record:
+            record["status"] = status
+
+            if signer:
+                for i, s in enumerate(record["signers"]):
+                    if s.get("agent") == signer.get("agent"):
+                        record["signers"][i] = signer
+                        break
+
+            file_path = self.signoffs_dir / f"{signoff_id}.yaml"
+            with open(file_path, 'w') as f:
+                yaml.dump(record, f)
+
+    def check_all_signed(self, signoff_id: str) -> bool:
+        """检查签署记录中所有签署者是否都已签署"""
+        record = self.get_signoff(signoff_id)
+        if record:
+            return all(s.get("status") == "approved" for s in record.get("signers", []))
+        return False

src/core/task_executor.py

@@ -442,7 +442,7 @@ class ExecuteBlackboxTestStrategy(TaskStrategy):
             test_result_path = f"docs/03-test/test_report_{project_name}_v1.md"
             
             result = subprocess.run(
-                ["python", "-m", "pytest", "-v", "--tb=short"],
+                ["python3", "-m", "pytest", "-v", "--tb=short"],
                 capture_output=True,
                 text=True,
                 timeout=300
@@ -646,13 +646,20 @@ class TaskExecutor:
         FixBugsStrategy()
     ]
     
-    def __init__(self, max_retries: int = 3, default_timeout: int = 300):
-        """初始化任务执行器。"""
+    def __init__(self, max_retries: int = 3, default_timeout: int = 300, mock_mode: bool = False):
+        """初始化任务执行器。
+
+        Args:
+            max_retries: 最大重试次数
+            default_timeout: 默认超时时间（秒）
+            mock_mode: 是否使用 Mock 模式（E2E 测试时使用）
+        """
         self.strategies: Dict[str, TaskStrategy] = {}
         self.task_history: List[Task] = []
         self.max_retries = max_retries
         self.default_timeout = default_timeout
-        
+        self.mock_mode = mock_mode
+
         for strategy in self.DEFAULT_STRATEGIES:
             self.register_strategy(strategy)
     
@@ -742,31 +749,61 @@ class TaskExecutor:
             return result
     
     def execute_action(self, action_type: str, context: Dict[str, Any]) -> TaskResult:
-        """根据动作类型执行任务。"""
+        """根据动作类型执行任务。
+
+        Args:
+            action_type: 动作类型
+            context: 上下文信息
+
+        Returns:
+            任务执行结果
+        """
         action_to_task_type = {
             "create_requirements": "create_requirements",
             "review_requirements": "review_requirements",
             "signoff_requirements": "signoff_requirements",
             "create_design": "create_design",
             "review_design": "review_design",
+            "implement_code": "implement_code",
+            "fix_bugs": "fix_bugs",
             "execute_blackbox_test": "execute_blackbox_test",
-            "execute_deployment": "execute_deployment",
-            "implement_code": "implement_code"
+            "execute_deployment": "execute_deployment"
         }
-        
+
         task_type = action_to_task_type.get(action_type)
         if not task_type:
             return TaskResult(
                 success=False,
                 message=f"未知的动作类型: {action_type}"
             )
-        
+
+        if self.mock_mode and action_type == "execute_blackbox_test":
+            return TaskResult(
+                success=True,
+                message="黑盒测试通过（Mock 模式）",
+                files_created=[],
+                files_modified=[],
+                duration=0.0,
+                quality_score=1.0
+            )
+
+        if self.mock_mode and action_type == "fix_bugs":
+            pending_issues = context.get("pending_issues", 0)
+            return TaskResult(
+                success=True,
+                message=f"已修复 {pending_issues} 个 Bug（Mock 模式）",
+                files_created=[],
+                files_modified=[],
+                duration=0.0,
+                quality_score=1.0
+            )
+
         task = self.create_task(
             name=f"执行{action_type}",
             task_type=task_type,
             params=context
         )
-        
+
         return self.execute_task(task, context)
     
     def get_pending_tasks(self) -> List[Task]:

src/core/workflow_inference.py

@@ -0,0 +1,169 @@
+"""主动流程推理引擎模块。"""
+from typing import List, Dict, Any, Optional
+from dataclasses import dataclass, field
+from enum import Enum
+import logging
+
+
+logger = logging.getLogger(__name__)
+
+
+class ComplianceLevel(Enum):
+    """合规级别"""
+    VALID = "valid"
+    WARNING = "warning"
+    VIOLATION = "violation"
+
+
+@dataclass
+class ComplianceResult:
+    """合规检查结果"""
+    valid: bool
+    level: ComplianceLevel
+    violations: List[str] = field(default_factory=list)
+    warnings: List[str] = field(default_factory=list)
+    suggestions: List[str] = field(default_factory=list)
+
+
+@dataclass
+class InferenceResult:
+    """流程推理结果"""
+    current_phase: str
+    next_phases: List[str]
+    suggestion: str
+    compliance_check: ComplianceResult
+    unknown: bool = False
+
+
+class WorkflowInferenceEngine:
+    """主动流程推理引擎"""
+
+    PHASE_SEQUENCE = {
+        "requirements": ["design", "development", "testing"],
+        "design": ["development", "testing"],
+        "development": ["testing"],
+        "testing": ["deployment"],
+    }
+
+    PHASE_NEXT = {
+        "requirements": "设计阶段",
+        "design": "开发阶段",
+        "development": "测试阶段",
+        "testing": "部署阶段",
+    }
+
+    def __init__(self, project_path: str, state_manager):
+        """初始化流程推理引擎"""
+        self.project_path = project_path
+        self.state_manager = state_manager
+
+    def infer_next_action(self) -> InferenceResult:
+        """根据当前状态推理下一步应该执行的操作"""
+        try:
+            current_state = self.state_manager.load_state()
+            phase = current_state.get("phase", current_state.get("project", {}).get("phase", "unknown"))
+
+            if phase == "unknown":
+                return InferenceResult(
+                    current_phase="unknown",
+                    next_phases=[],
+                    suggestion="请先初始化项目: oc-collab project init",
+                    compliance_check=ComplianceResult(
+                        valid=False,
+                        level=ComplianceLevel.VIOLATION,
+                        violations=["无法确定当前流程状态"],
+                        suggestions=["请先初始化项目"]
+                    ),
+                    unknown=True
+                )
+
+            next_phases = self.PHASE_SEQUENCE.get(phase, [])
+
+            compliance = self._run_compliance_check(phase, current_state)
+
+            if next_phases:
+                suggestion = f"当前阶段: {phase}\n建议: 进入 {self.PHASE_NEXT.get(phase, phase)}"
+            else:
+                suggestion = f"当前阶段: {phase}\n可选: 无（流程已完成）"
+
+            return InferenceResult(
+                current_phase=phase,
+                next_phases=next_phases,
+                suggestion=suggestion,
+                compliance_check=compliance
+            )
+
+        except Exception as e:
+            logger.error(f"流程推理失败: {e}")
+            return InferenceResult(
+                current_phase="unknown",
+                next_phases=[],
+                suggestion=f"推理失败: {e}",
+                compliance_check=ComplianceResult(
+                    valid=False,
+                    level=ComplianceLevel.VIOLATION,
+                    violations=[str(e)],
+                    suggestions=["请检查项目状态"]
+                ),
+                unknown=True
+            )
+
+    def _run_compliance_check(self, phase: str, current_state: Dict[str, Any]) -> ComplianceResult:
+        """运行合规检查"""
+        violations = []
+        warnings = []
+        suggestions = []
+
+        if phase == "unknown":
+            violations.append("无法确定当前流程状态")
+            suggestions.append("请先初始化项目")
+
+        if phase == "requirements":
+            requirements_status = current_state.get("requirements", {})
+            if isinstance(requirements_status, dict):
+                if not requirements_status.get("pm_signoff") or not requirements_status.get("dev_signoff"):
+                    violations.append("需求阶段尚未完成签署")
+                    suggestions.append("请先完成需求评审和签署")
+
+        elif phase == "design":
+            design_status = current_state.get("design", {})
+            if isinstance(design_status, dict):
+                if not design_status.get("pm_signoff") or not design_status.get("dev_signoff"):
+                    violations.append("设计阶段尚未完成签署")
+                    suggestions.append("请先完成设计评审和签署")
+            elif isinstance(design_status, list):
+                if not design_status:
+                    violations.append("没有设计文档")
+                    suggestions.append("请先创建设计文档")
+
+        return ComplianceResult(
+            valid=len(violations) == 0,
+            level=ComplianceLevel.VIOLATION if violations else ComplianceLevel.VALID,
+            violations=violations,
+            warnings=warnings,
+            suggestions=suggestions
+        )
+
+    def validate_phase_transition(self, from_phase: str, to_phase: str) -> ComplianceResult:
+        """验证阶段转换是否合规"""
+        valid_transitions = self.PHASE_SEQUENCE.get(from_phase, [])
+
+        if to_phase not in valid_transitions:
+            return ComplianceResult(
+                valid=False,
+                level=ComplianceLevel.VIOLATION,
+                violations=[f"阶段顺序不正确: {from_phase} → {to_phase}"],
+                suggestions=[f"从 {from_phase} 阶段只能转换到: {', '.join(valid_transitions)}"]
+            )
+
+        return ComplianceResult(
+            valid=True,
+            level=ComplianceLevel.VALID,
+            violations=[],
+            suggestions=[f"✓ {from_phase} → {to_phase} 符合流程规范"]
+        )
+
+    def get_workflow_status(self) -> str:
+        """获取工作流状态"""
+        result = self.infer_next_action()
+        return f"[{result.current_phase.upper()}] - {result.suggestion}"

src/utils/environment.py

@@ -0,0 +1,64 @@
+"""环境检测工具模块。"""
+import sys
+import shutil
+from typing import Optional
+
+
+class EnvironmentError(Exception):
+    """环境异常基类。"""
+    pass
+
+
+class PythonNotFoundError(EnvironmentError):
+    """Python 解释器未找到异常。"""
+    pass
+
+
+def get_python_command() -> str:
+    """检测并返回可用的 Python 命令。
+
+    Returns:
+        可用的 Python 命令（优先使用 python3）
+
+    Raises:
+        PythonNotFoundError: 未找到 Python 解释器
+    """
+    if shutil.which("python3"):
+        return "python3"
+    elif shutil.which("python"):
+        return "python"
+    else:
+        raise PythonNotFoundError("未找到 Python 解释器（python 或 python3）")
+
+
+def get_python_executable() -> str:
+    """返回当前使用的 Python 解释器路径。
+
+    Returns:
+        Python 解释器的绝对路径
+    """
+    return sys.executable
+
+
+def is_test_environment() -> bool:
+    """检测是否在测试环境中运行。
+
+    Returns:
+        如果在测试环境中返回 True，否则返回 False
+    """
+    return "pytest" in sys.modules or "test" in sys.argv[0].lower()
+
+
+def get_environment_info() -> dict:
+    """获取当前环境信息。
+
+    Returns:
+        包含环境信息的字典
+    """
+    return {
+        "python_command": get_python_command(),
+        "python_executable": get_python_executable(),
+        "is_test_environment": is_test_environment(),
+        "python_version": sys.version,
+        "platform": sys.platform
+    }