# 克隆项目 git clone <repository-url> cd SocialGuessSkills # 安装依赖 bun install

# 运行端到端示例(社区治理模型) bun run examples/run-example.ts

{ "mcpServers": { "social-modeling": { "command": "bun", "args": ["run", "/absolute/path/to/src/server.ts"] } } }

请帮我分析:1000人社区,资源有限,如何建立稳定合作的社会体系?

{ "hypothesis": { "assumptions": [ "1000人社区,资源有限(粮食、住房、工具)", "协作可提升总产出30%", "无外部干预,孤立环境" ], "constraints": [ "通信成本:当面交流免费,间接传播有衰减", "信息不完全:个体只知道邻近50人的状态" ], "goals": [ "保证所有人基本生存(食物、住所)", "建立可持续的资源生产与分配机制", "冲突解决机制可执行" ] }, "maxIterations": 3 }

{ "agentType": "risk", "hypothesis": { "assumptions": ["资源稀缺", "有限理性"], "constraints": [], "goals": ["稳定秩序"] } }

{ "modelJson": "{...完整的模型JSON字符串...}" }

┌─────────────────────────────────────────────────────┐ │ 用户输入假设 │ │ (assumptions/constraints/goals) │ └──────────────────────┬──────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ 1. 假设验证 (Systems Agent) │ │ - 检查结构完整性,识别关键变量 │ └──────────────────────┬──────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ 2. 并行Agent推演 (7个Agent) │ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌───────┐ │ │ │Systems │ │ Econ │ │ Socio │ │Govern │ │ │ │ Agent │ │ Agent │ │ Agent │ │ Agent │ │ │ └────────┘ └────────┘ └────────┘ └───────┘ │ │ ┌────────┐ ┌────────┐ │ │ │Culture │ │ Risk │ │ │ │ Agent │ │ Agent │ │ │ └────────┘ └────────┘ │ └──────────────────────┬──────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ 3. 冲突对齐 (Risk Agent主导) │ │ - 检测逻辑矛盾、优先级冲突、风险叠加 │ │ - 标记需要重推的Agent │ └──────────────────────┬──────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ 4. 决策合成 (Governance Agent主导) │ │ - 应用决策合成规则:分层加权、冲突优先级 │ │ - 提取9层结构化模型 │ └──────────────────────┬──────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ 5. 证据校验 (Validation Agent) │ │ - 可证伪假设检验、历史案例对比、反事实推理 │ └──────────────────────┬──────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ 6. 迭代收敛 (如有冲突,回到步骤2) │ │ - 最大迭代次数: 3次(可配置) │ │ - 终止条件: 无新冲突 或 达到最大迭代 │ └──────────────────────┬──────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ 最终社会体系模型 │ │ - Agent输出(7个) │ │ - 冲突列表 │ │ - 9层结构化模型 │ │ - 元数据(迭代/置信度/时间) │ └─────────────────────────────────────────────────────┘

{ "hypothesis": { "assumptions": ["假设1", "假设2"], "constraints": ["约束1", "约束2"], "goals": ["目标1", "目标2"] }, "maxIterations": 3 }

{ "hypothesis": {...}, "agentOutputs": [...], "conflicts": [...], "structure": { "overall": {...}, "workflow": {...}, "institutions": {...}, "governance": {...}, "culture": {...}, "innovation": {...}, "risks": {...}, "metrics": {...}, "optimization": {...} }, "metadata": { "iterations": 2, "confidence": 0.79, "generatedAt": "2026-02-03T14:30:00Z" } }

{ "agentType": "systems|econ|socio|governance|culture|risk|validation", "hypothesis": {...} }

{ "modelJson": "{...模型JSON字符串...}" }

{ "isValid": true, "checks": { "hasAllAgents": true, "hasStructure": true, "hasHypothesis": true, "hasMetadata": true, "agentTypesAreValid": true }, "issues": [], "warnings": [] }

function detectCustomConflict(outputs: AgentOutput[]): Conflict[] { const conflicts: Conflict[] = []; // 你的检测逻辑 return conflicts; }

SocialGuessSkills/ ├── src/ │ ├── agents/ │ │ ├── prompts/ # 7个Agent的Prompt模板 │ │ ├── agent-factory.ts # Agent工厂 │ │ └── agent-executor.ts # Agent执行器 │ ├── workflow/ │ │ ├── orchestrator.ts # 工作流编排器 │ │ └── conflict-resolver.ts # 冲突检测 │ ├── types.ts # 核心类型定义 │ ├── server.ts # MCP Server入口 │ └── __tests__/ # 测试用例 ├── examples/ │ ├── community-governance.json # 示例输入 │ └── run-example.ts # 示例执行脚本 ├── package.json ├── tsconfig.json └── README.md

bun test