Sync: add knowledge graph and design notes

wiki/sources/agents-orchestrator.md

@@ -0,0 +1,62 @@
+---
+title: "Agents Orchestrator"
+type: source
+tags: []
+date: 2026-04-20
+---
+
+## Source File
+- [[Agent/agency-agents/specialized/agents-orchestrator.md]]
+
+## Summary（用中文描述）
+- 核心主题：AI 多智能体开发流水线编排器，自主管理从规格到交付的完整开发流程
+- 问题域：多专业 Agent 协同工作流中，如何确保每个任务通过质量验证后才推进，如何处理失败和重试
+- 方法/机制：四阶段流水线（PM→ArchitectUX→[Dev↔QA循环]→最终集成）；基于截图证据的质量门控；最大3次重试上限
+- 结论/价值：通过强制性质量门控和 Dev-QA 循环，确保只有通过验证的功能才能推进，最终交付符合规格要求的生产就绪产品
+
+## Key Claims（用中文描述）
+- AgentsOrchestrator 通过持续 Dev-QA 循环实现任务级质量验证，每个任务必须通过 EvidenceQA 的截图验证才能推进
+- 四阶段流水线（PM→ArchitectUX→[Dev↔QA循环]→最终集成）确保从规格到生产的完整质量覆盖
+- 最大重试次数为3次，超过后进行升级处理，避免无限循环同时保证任务有足够修正机会
+- AgentsOrchestrator 提供标准化状态报告模板，实现流水线进度的透明化追踪
+
+## Key Quotes
+> "Each task must pass QA before advancing." — 质量门控原则：每个任务必须通过 QA 验证才能推进到下一任务
+> "Default to 'NEEDS WORK' unless overwhelming evidence proves production readiness." — testing-reality-checker 的默认判断原则，确保交付标准严格
+> "Maximum 3 attempts per task before escalation." — 重试上限机制，防止任务无限循环
+> "No shortcuts: Every task must pass QA validation." — 强制性质量验证，无例外原则
+
+## Key Concepts
+- [[Dev-QA-Loop]]：开发与质量验证的持续循环机制——每个任务完成后由 EvidenceQA 进行截图验证，通过后推进下一个任务，失败则回到开发阶段并携带具体反馈
+- [[Quality-Gate]]：质量门控机制——任务必须通过质量验证才能推进到下一阶段的强制性检查点
+- [[EvidenceQA]]：基于截图证据的质量验证专家 Agent——要求视觉证据作为验证依据，提供明确的 PASS/FAIL 判定及具体反馈
+- [[Pipeline-State-Management]]：流水线状态管理——追踪当前任务、所处阶段、完成状态，在 Agent 间传递上下文信息，处理错误并实现恢复
+- [[Agent-Handoff]]：Agent 交接协议——在多个专业 Agent 之间传递完整的上下文和具体指令，确保下一 Agent 获得足够信息执行任务
+- [[Continuous-Dev-QA-Loop]]：持续开发质量循环——开发与 QA 交替进行，每个开发交付物立即经过 QA 验证，形成快速反馈闭环
+
+## Key Entities
+- [[AgentsOrchestrator]]：编排器自身——自主流水线管理器，协调从规格到生产的完整开发流程（来源页面）
+- [[ArchitectUX]]：技术架构师 Agent——负责基于规格和任务列表创建技术架构和 UX 基础
+- [[EvidenceQA]]：截图质量验证 Agent——通过截图证据对每个任务实现进行质量验证
+- [[ProjectManagerSenior]]：高级项目经理 Agent——负责将规格文档转化为详细的任务列表
+- [[TestingRealityChecker]]：最终集成验证 Agent——在所有任务通过后进行最终集成测试，默认为"需要改进"原则
+- [[FrontendDeveloper]]：前端开发者 Agent——负责 UI/UX 任务的实现
+- [[BackendArchitect]]：后端架构师 Agent——负责服务端架构和 API 开发
+- [[MobileAppBuilder]]：移动应用构建 Agent——负责移动端应用开发
+- [[DevOpsAutomator]]：DevOps 自动化 Agent——负责基础设施任务
+
+## Connections
+- [[AgentsOrchestrator]] ← spawns ← [[ProjectManagerSenior]]（Phase 1：编排器启动项目经理创建任务列表）
+- [[AgentsOrchestrator]] ← spawns ← [[ArchitectUX]]（Phase 2：编排器启动架构师创建技术基础）
+- [[AgentsOrchestrator]] ← spawns ← [[EvidenceQA]]（Phase 3：每个任务的 QA 验证）
+- [[AgentsOrchestrator]] ← spawns ← [[TestingRealityChecker]]（Phase 4：最终集成测试）
+- [[ArchitectUX]] ← depends_on ← [[ProjectManagerSenior]]（架构基于任务列表）
+- [[Dev-QA-Loop]] ← extends ← [[Multi-Agent-System-Reliability]]（流水线编排是多 Agent 可靠性的实践框架）
+- [[AgentsOrchestrator]] ← part_of ← [[The Agency]]（编排器是 The Agency 的核心基础设施）
+
+## Contradictions
+- 与 [[specialized-workflow-architect]] 冲突：
+  - 冲突点：两个 Agent 都声称负责"编排"职责——前者是流水线执行编排器，后者是工作流设计专家
+  - 当前观点：AgentsOrchestrator 是执行层面的流水线管理器，强调任务级质量门控和自动化重试逻辑
+  - 对方观点：Workflow Architect 是设计层面的工作流架构师，专注工作流模式设计和流程建模
+  - 说明：两者不存在功能重叠——Workflow Architect 设计工作流，AgentsOrchestrator 执行工作流，属设计与执行的分层关系

wiki/sources/sales-data-extraction-agent.md

@@ -0,0 +1,47 @@
+---
+title: "Sales Data Extraction Agent"
+type: source
+tags: []
+date: 2026-04-25
+---
+
+## Source File
+- [[raw/Agent/agency-agents/specialized/sales-data-extraction-agent.md]]
+
+## Summary（用中文描述）
+- 核心主题：销售数据提取 AI Agent，专门监控 Excel 文件并提取关键销售指标
+- 问题域：销售报告自动化处理、销售指标实时监控
+- 方法/机制：文件系统监控 + 灵活列映射 + PostgreSQL 持久化
+- 结论/价值：实现销售数据的自动化提取与下游分发，减少人工干预
+
+## Key Claims（用中文描述）
+- Agent 实时监控指定目录中的 Excel 文件（新文件或更新版本）
+- Agent 从 Excel 工作簿中提取 MTD（月度至今）、YTD（年度至今）和 Year End（年终预测）指标
+- Agent 支持灵活列名映射（revenue/sales/total_sales 等）
+- Agent 自动计算配额达成率
+- Agent 使用事务将提取的指标批量插入 PostgreSQL，保证原子性
+- Agent 保留完整的审计跟踪记录
+
+## Key Quotes
+> "You are the Sales Data Extraction Agent — an intelligent data pipeline specialist who monitors, parses, and extracts sales metrics from Excel files in real time. You are meticulous, accurate, and never drop a data point." — Agent 身份定义
+
+> "Never overwrite existing metrics without a clear update signal (new file version)" — 关键规则：数据覆盖保护
+
+## Key Concepts
+- [[FilesystemWatcher]]：文件系统监控，检测目录中的 .xlsx 和 .xls 文件变化
+- [[FuzzyColumnMapping]]：模糊列名匹配，处理 revenue/sales/total_sales、units/qty/quantity 等变体
+- [[MetricExtraction]]：指标提取，从工作簿中识别 MTD、YTD、Year End 等指标类型
+- [[TransactionalDatabase]]：事务性数据库操作，使用 PostgreSQL 事务保证原子性
+- [[AuditTrail]]：审计跟踪，记录每次导入的文件名、处理行数、失败行数、时间戳
+
+## Key Entities
+- [[PostgreSQL]]：目标数据库，用于存储提取的销售指标
+- [[SalesRepresentative]]：销售代表，Agent 通过邮箱或全名匹配
+- [[ExcelWorkbook]]：Excel 工作簿，包含多个 sheet 的销售数据
+
+## Connections
+- [[AgentsOrchestrator]] ← orchestrates ← [[SalesDataExtractionAgent]]
+- [[SalesDataExtractionAgent]] ← provides_data ← [[ReportDistributionAgent]]
+
+## Contradictions
+- 与 [[DataConsolidationAgent]]：DataConsolidationAgent 整合来自多个来源的数据，而 SalesData Extraction Agent 专注于从 Excel 文件提取数据；两者可以互补使用

wiki/sources/specialized-french-consulting-market.md

@@ -0,0 +1,63 @@
+---
+title: "French Consulting Market Navigator"
+type: source
+tags: []
+date: 2026-04-20
+---
+
+## Source File
+- [[Agent/agency-agents/specialized/specialized-french-consulting-market.md]]
+
+## Summary（用中文描述）
+- 核心主题：法国 IT 咨询市场（ESN/SI 生态系统）的运作规则、费率定位与谈判策略
+- 问题域：独立 IT 顾问在法国市场中面临的信息不对称——ESN 佣金结构不透明、平台定价机制混乱、多层billing结构税后收益差异巨大
+- 方法/机制：三层 ESN 分类定价体系（Tier 1-3）、五大平台对比矩阵（Malt/collective.work/Comet/Crème/Free-Work）、TJM→净收入换算模型、季节性市场日历、国际远程顾问定位策略
+- 结论/价值：帮助自由顾问最大化税后日均收入、最小化付款风险、建立可持续客户关系
+
+## Key Claims（用中文描述）
+- ESN 佣金结构是市场信息不对称的核心：Client 支付 1,000 EUR/天，Tier 2 ESN 实际支付顾问 600-750 EUR/天（佣金 25-40%），顾问对此往往不知情
+- Billing 结构税后收益差距显著：同等 TJM 700 EUR/天，Portage Salarial 净收入 ~208 EUR/天（~3,742 EUR/月），Micro-entreprise 净收入 ~546 EUR/天（~9,828 EUR/月），差距 338 EUR/天
+- 付款延迟是结构性而非例外：合同标注 NET-30，实际到账 60-90 天，顾问必须提前预算
+- 平台费率具有公开锚定效应：Malt 上的报价直接成为市场价格，定价必须从第一天起就谨慎
+- 费率下限有战略意义：Salesforce 架构师低于 550 EUR/天会被 ESN 视为"急于求成"，永久锚定低费率谈判基准
+- 远程/国际位置必须主动披露：谈判中期被发现会导致费率降低 5-10% 并损害信任，主动披露+价值框架可中和惩罚
+
+## Key Quotes
+> "Portage salarial is not employment. It provides social protection (unemployment, retirement contributions) but the freelancer bears all commercial risk. Never present it as equivalent to a CDI." — 核心原则：Portage 不等于就业，不能用 CDI 的安全感来类比
+
+> "Platform rates are public. What you charge on Malt is visible. Your Malt rate becomes your market rate. Price accordingly from day one." — 平台费率的公开性要求从第一天就谨慎定价
+
+> "A 600 EUR/day TJM through portage salarial yields approximately 300-330 EUR net after all charges. Through micro-entreprise, approximately 420-450 EUR. The gap is significant and must be surfaced." — 两种结构税后收益差距 30-40%，必须明确告知客户
+
+## Key Concepts
+- [[TJM]]（Taux Journalier Moyen / 毛日均费率）：法国咨询市场的核心定价单位，需区分 TJM Brut 与实际净收入
+- [[Portage-Salarial]]：法国的准雇佣模式，为自由顾问提供失业保险和退休金，但商业风险自担，净收入约为 TJM Brut 的 50%
+- [[Micro-Entreprise]]：法国简化商业结构，无社会保障福利，净收入约为 TJM Brut 的 70%
+- [[ESN-SI-Ecosystem]]：法国 IT 咨询生态系统，ESN（Entreprise de Services Numériques）= SI（System Integrator），占法国企业 IT 项目用人的主要渠道
+- [[Rate-Negotiation-Playbook]]：费率谈判四步法（知底价→探底价→锚高价→框架溢价），核心是在非 TJM 维度（期限/远程天数/续约条款）上让步
+- [[International-Freelancer-Positioning]]：面向法国市场的国际自由顾问定位策略，核心是时区重叠作为优势、法国实体偏好、主动披露原则
+
+## Key Entities
+- [[Malt]]：欧洲最大自由顾问平台，10% 佣金（客户端），费率公开可见，适合建立作品集，典型 TJM 550-700 EUR
+- [[collective.work]]：3-5% 佣金+Portage 集成，典型 TJM 650-800 EUR，适合高价值 mission
+- [[Comet]]：15% 佣金，算法驱动匹配，典型 TJM 600-750 EUR，技术顾问为主
+- [[Crème-de-la-Crème]]：15-20% 佣金，准入筛选严格，典型 TJM 700-900 EUR，高端定位
+- [[Free-Work]]：免费列表+付费选项，TJM 500-900 EUR，以中间商列表为主，噪音较大
+- [[Portage-Salarial-Company]]（Portage 公司）：作为 ESN 和顾问之间的雇佣中介，负责代扣代缴社保，提供 ARE 失业保险权利
+
+## Connections
+- [[TJM]] ← is_priced_by ← [[ESN-SI-Ecosystem]]
+- [[Portage-Salarial]] ← provides_social_protection_to ← [[TJM]]
+- [[Micro-Entreprise]] ← alternative_to ← [[Portage-Salarial]]
+- [[Malt]] ← competing_with ← [[collective.work]], [[Comet]], [[Crème-de-la-Crème]], [[Free-Work]]
+- [[International-Freelancer-Positioning]] ← requires ← [[French-Entity]]（Portage 或 SASU）
+
+## Contradictions
+- 与一般"高TJM=高收入"直觉冲突：
+  - 冲突点：同等 TJM 下，Portage Salarial 的实际净收入比 Micro-entreprise 低 30-40%
+  - 当前观点：TJM 必须换算为税后实际日均收入才能判断真实收入水平
+  - 对方观点：只看 TJM 数字，越高越好
+- 与"全职就业安全感"对比：
+  - 冲突点：Portage 提供的社保（失业保险/退休金）不等于 CDI 就业保障
+  - 当前观点：Portage 是商业安排，商业风险完全由顾问自担，绝不能包装成"准就业"
+  - 对方观点：Portage = 更好的 CDI（自由+保障）

wiki/sources/specialized-korean-business-navigator.md

@@ -0,0 +1,66 @@
+---
+title: "Korean Business Navigator"
+type: source
+tags: []
+date: 2026-04-25
+---
+
+## Source File
+- [[Agent/agency-agents/specialized/specialized-korean-business-navigator.md]]
+
+## Summary（用中文描述）
+- 核心主题：帮助外国专业人员在韩国商业环境中导航——将西方直接性与韩国关系动态相结合的专家 Agent
+- 问题域：韩国商业文化中的隐性规则（品의决策流程、눈치读心术、KakaoTalk商务礼仪、层级导航、关系优先的成交机制）
+- 方法/机制：品의（共识审批）六阶段时间线、Nunchi 解码表、KakaoTalk 消息模板、韩国企业职级体系、회식（商务聚餐）礼仪、Proof Project 策略
+- 结论/价值：韩国商业"成交"发生在会议室外的走廊而非会议室内；韩国"yes"不一定是同意；沉默是信息而非拒绝
+
+## Key Claims（用中文描述）
+- 冷接触（Cold Outreach）响应率 < 5%，通过介绍人接入响应率显著更高
+- 韩国品의流程耗时 6-16 周（SME 6-10 周、中型 8-12 周、财阀 12-16 周），远长于西方的 2-4 周
+- 永远不要在第一次会议要求决策时间线——询问"何时成交"等于暴露无知和绝望
+- 永远不要绕过联系人直接联系其上级——越级在韩国商业中是关系终结行为
+- KakaoTalk 群聊必须使用韩语——即使不完美也显示尊重
+- 永远不要在第一次对话中谈钱——关系第一、能力第二、价格第三
+- 회식出席是预期而非可选——拒绝会损害信任
+- 沉默（3-7 天）不等于拒绝——通常意味着内部讨论正在进行
+
+## Key Quotes
+> "검토해보겠습니다" literally means "we'll review it" but contextually means "probably not — give us a graceful exit." — 品의婉拒信号
+> "Korean business runs on 품의 (consensus approval)." — 韩国决策机制核心
+> "A Korean 'yes' is not always agreement, that silence is information, and that the real decision happens in the hallway after the meeting, not during it." — Agent 身份定位
+> "The proof project IS the sales pitch. Over-deliver deliberately." — Proof Project 策略核心
+
+## Key Concepts
+- [[품의]]：韩国共识审批流程，含六阶段（소개→미팅→내부검토→품의서→결재→계약），耗时 6-16 周，不可加速
+- [[Nunchi]]：눈치（读心术）——通过观察语境和情绪线索理解未被直接表达的意图，是韩国商业的核心技能
+- [[KakaoTalk-商务礼仪]]：韩国主流通讯工具的分阶段消息模板、响应时间期望、群聊规则（必须韩语）、表情贴纸使用时机
+- [[회식]]：회식（公司聚餐/饮酒文化）——出席是预期而非可选；斟酒、用餐、祝酒均有严格礼仪规范
+- [[Proof-Project-Strategy]]：信任未建立时用有边界的小项目证明——2-3 周、固定交付物、固定价格，用结果推动完整合作
+- [[Korean-Corporate-Hierarchy]]：韩国企业职级体系（회장→사장→부사장→전무→상무→이사→부장→차장→과장→대리）及对应的称呼规范（职称+님）
+- [[Relationship-Lifecycle]]：介绍→信任→合同三阶段关系管理，每阶段有不同的沟通策略和时机预期
+
+## Key Entities
+- [[Chaebol]]：韩国财阀（大企业集团），品의流程最长（12-16 周），建议月度跟进
+- [[SME]]（中小企业）：品의流程最短（6-10 周），建议周度跟进
+- [[KakaoTalk]]：韩国主流即时通讯工具，商务沟通的核心渠道，9AM-7PM KST 为商务时间
+- [[도장]]（印章）：韩国合同执行的物理凭证，合同签订后还需印章盖印完成
+
+## Connections
+- [[품의]] ← 是 [[Korean-Business-Decision-Process]] 的核心机制
+- [[Nunchi]] ← 是 [[품의]] 流程中读取内部信号的技能基础
+- [[KakaoTalk-商务礼仪]] ← 是 [[Relationship-Lifecycle]] 各阶段的沟通载体
+- [[회식]] ← 是建立信任（소개→신뢰→계약）的关键社交机制
+- [[Proof-Project-Strategy]] ← 是 [[Relationship-Lifecycle]] 中从 미팅 过渡到 계약 的推荐方法
+- [[Cultural-Intelligence-Strategist]] ← 上级概念：本 Agent 是其韩国商业领域的具体化
+
+## Contradictions
+- 与西方"快速成交"直觉冲突：
+  - 冲突点：西方商务文化鼓励在第一次会议明确时间线、尽快推进
+  - 当前观点：韩国品의要求 6-16 周，需等待内部审批链，不能催促
+  - 对方观点：快速推进显示专业性和效率
+  - 解决方向：理解品의是保护机制，不是障碍；用有边界的 Proof Project 降低感知风险
+- 与西方"沉默=拒绝"直觉冲突：
+  - 冲突点：西方将 3-7 天无响应视为消极信号
+  - 当前观点：沉默表示内部讨论正在进行，应等待而非催促
+  - 对方观点：及时跟进显示诚意和重视
+  - 解决方向：区分"积极沉默"（品의中）和"死单沉默"，关键信号是对方是否有主动提问

wiki/sources/study-abroad-advisor.md

@@ -0,0 +1,47 @@
+---
+title: "Study Abroad Advisor"
+type: source
+tags: []
+date: 2026-04-25
+---
+
+## Source File
+- [[Agent/agency-agents/specialized/study-abroad-advisor.md]]
+
+## Summary（用中文描述）
+- 核心主题：面向中国学生的全链路留学申请规划专家 Agent，覆盖美国/英国/加拿大/澳大利亚/欧洲/香港/新加坡七大留学目的地，涵盖本科/硕士/博士全学位层次，从选校定位到行前准备的完整流程。
+- 问题域：留学申请策略、选校定位、文书写作、背景提升、考试规划、签证办理、Offer 比较决策。
+- 方法/机制：四步工作流（全面诊断→策略制定→材料打磨→提交跟进）；数据驱动的选校概率区间（Reach 20-40% / Target 40-70% / Safety 70-90%）；多国联申时间线协调；标准化交付模板（选校报告、多国申请时间线、文书诊断、Offer 比较矩阵）。
+- 结论/价值：为每位学生提供端到端、个性化的留学规划，消除申请焦虑，强调数据透明与诚信原则（不代写文书、不夸大经历、不承诺录取结果）。
+
+## Key Claims（用中文描述）
+- Study Abroad Advisor 通过数据驱动方法，能帮助 GPA 3.2 的学生进入 Top 30， 也可能让 GPA 3.9 的学生全拒——关键在于选校策略和文书质量。
+- 多国联申策略（如 US+UK、US+HK+Singapore）需要精确的时间线协调和精力分配，但能显著提升录取概率。
+- 诚信原则（不代写文书、不承诺结果）是留学咨询的核心底线，任何"保证录取"的承诺都是骗局。
+- 文书不是经历的流水账列表，而是围绕核心叙事弧（你是谁→去哪→为什么是这个项目）的故事化表达。
+- 选校推荐必须区分"确认信息"和"经验估算"， admission probability 以区间而非精确数字表达。
+
+## Key Quotes
+> "This program admitted about 200 students last year, roughly 40 from China, with a median GPA of 3.6. Your 3.5 is within range but not strong — you'll need essays and experiences to compensate." — 数据驱动的录取概率沟通
+> "Top 10 isn't on your menu right now, but Top 30 is within reach. Let's focus energy where the odds are highest." — 务实选校，避免焦虑贩卖
+> "You think your Hackathon experience doesn't matter? You led a team to build a product with real users from scratch in 48 hours — that's exactly the kind of initiative engineering programs look for." — 优势挖掘，赋能学生信心
+
+## Key Concepts
+- [[Holistic-Admissions]]：全面评估录取模式——综合考量 GPA、标准化考试成绩、课外活动、文书、推荐信等多维度，非单一成绩决定。
+- [[UCAS-System]]：英国本科统一申请系统——学生通过 UCAS 可同时申请最多 5 所英国大学，个人陈述（Personal Statement）需面向所有申请学校，4,000 字符限制，80% 内容须聚焦学术热情。
+- [[IANG-Visa]]：非本地毕业生留港就业安排（Immigration Arrangement for Non-local Graduates）——香港为在港毕业生提供毕业后留港工作签证，无配额限制，是香港留学的核心吸引力之一。
+- [[Grandes-Ecoles]]：法国精英大学体系——与公立大学并行的高等教育精英通道，需通过竞考（concours）入学，毕业后享有高社会认可度。
+
+## Key Entities
+- The Agency Specialized 部门：该 Agent 归属 The Agency 多智能体系统的 Specialized 部门，与 Agents Orchestrator、Identity Graph Operator、MCP Builder Agent、Agentic Identity & Trust Architect 等 Specialist 同事协同工作。
+- 1point3acres（一亩三分地）：中国留学生社区论坛，是学生验证录取数据、校友去向、申请经验的重要信息来源，Agent 鼓励学生通过该论坛核实关键数据。
+
+## Connections
+- [[Agents-Orchestrator]] ← coordinates_with ← Study Abroad Advisor
+- [[specialized-mcp-builder]] ← same_department ← Study Abroad Advisor
+- [[identity-graph-operator]] ← same_department ← Study Abroad Advisor
+- [[agentic-identity-trust]] ← same_department ← Study Abroad Advisor
+- [[ProjectManagerSenior]] ← supports ← Study Abroad Advisor（两者均服务于 The Agency 的项目管理体系，PM 产出的任务列表可支撑留学规划的项目化执行）
+
+## Contradictions
+- 与其他 Agent 的信息呈现方式：Study Abroad Advisor 明确采用数据驱动、零焦虑贩卖的原则，而其他面向消费者的 Agent（如一般营销 Agent）可能倾向于过度承诺录取结果。核心区别在于：前者明确区分"确认信息"和"经验估算"，后者缺乏这种信息透明度约束。

wiki/sources/supply-chain-strategist.md

@@ -0,0 +1,75 @@
+---
+title: "Supply Chain Strategist Agent"
+type: source
+tags: [agent, supply-chain, procurement, china-manufacturing, strategy]
+date: 2026-04-25
+---
+
+## Source File
+- [[Agent/agency-agents/specialized/supply-chain-strategist.md]]
+
+## Summary（用中文描述）
+- 核心主题：基于中国制造业生态的专业供应链管理与战略采购 Agent，帮助企业建立高效、有韧性、可持续的供应链体系
+- 问题域：供应商管理、战略寻源、质量控制、库存优化、供应链数字化、成本管控、风险管理与合规 ESG
+- 方法/机制：Kraljic 矩阵分类采购策略、ABC 分级供应商管理、QCD 绩效评估、TCO 全成本分析、库存模型（EOQ/ROP/安全库存）、数字化成熟度评估
+- 结论/价值：提供端到端供应链解决方案，从供应商开发寻源到危机响应，覆盖采购、物流、库存、合规全链路
+
+## Key Claims（用中文描述）
+- 供应商 ABC 分级管理 + 战略合作伙伴关系升级，能显著提升供应链稳定性
+- Kraljic 矩阵定位采购类别，配合差异化采购策略，可实现年度采购成本降低 5-8%
+- TCO（全成本拥有权）分析是采购决策依据，而非单纯比较单价
+- 关键物料必须多源采购，单一来源是最高风险项
+- 供应链数字化成熟度分 5 级（L1 手动 → L5 自主智能），成熟度提升路径明确
+- 供应商绩效评估必须数据驱动，主观评价不超过 20%
+
+## Key Quotes
+> "Critical materials must never be single-sourced — verified alternative suppliers are mandatory" — 供应链安全第一原则
+> "TCO (Total Cost of Ownership) is the decision-making basis, not unit purchase price alone" — 成本决策核心原则
+> "Quality issues must be traced to root cause — superficial fixes are insufficient" — 质量管控原则
+> "Through consolidated purchasing, fastener category annual procurement costs decreased 12%, saving ¥870,000" — 数据驱动沟通风格示例
+
+## Key Concepts
+- [[Kraljic Matrix]]：按采购类别特性（供应风险 × 利润影响）将物料分为战略型、杠杆型、瓶颈型、常规型，对应差异化采购策略
+- [[ABC Classification]]：供应商/物料分级管理（A 类战略重点、B 类重要、C 类常规），差异化资源配置
+- [[QCD Assessment]]：Quality-Quality、Cost、Delivery 三维供应商绩效评分体系，每季度评分年度淘汰
+- [[TCO Analysis]]：Total Cost of Ownership 全成本拥有权分析，涵盖直接成本、间接成本、隐性成本、全生命周期成本
+- [[EOQ Model]]：经济订货量模型，平衡订货成本与持有成本
+- [[Safety Stock & ROP]]：安全库存与再订货点，结合 Z 值与服务水平计算
+- [[VMI]]：Vendor-Managed Inventory，供应商管理库存，减少买方库存负担
+- [[JIT Procurement]]：Just-In-Time 准时制采购，降低持有成本但要求供应链高度可靠
+- [[Supply Chain Digital Maturity]]：供应链数字化成熟度 5 级模型（L1-L5），从手动到自主智能
+- [[8D Report]]：质量问题闭环解决报告，CAPA 纠正预防措施
+- [[AQL Sampling]]：Acceptable Quality Limit，来料抽样检验标准（GB/T 2828.1 / ISO 2859-1）
+- [[RBA Code of Conduct]]：Responsible Business Alliance 电子行业社会责任行为准则
+- [[SA8000]]：社会责任国际标准，涵盖禁用童工/强迫劳动、工时薪资、职业健康安全
+- [[ERP-MM]]：SAP Materials Management 模块，物料管理系统
+- [[SRM Platform]]：Supplier Relationship Management，供应商关系管理平台
+
+## Key Entities
+- [[1688/Alibaba]]：中国最大 B2B 电商平台，适合标准件和通用材料采购
+- [[Made-in-China.com]]：中国制造网，面向出口型工厂的国际贸易平台
+- [[Global Sources]]：环球资源，高端制造商目录，适合电子和消费品
+- [[Canton Fair]]：广交会（中国进出口商品交易会），春秋两届全品类供应商集中地
+- [[SGS/TUV/Bureau Veritas/Intertek]]：第三方检验机构，负责工厂审核和产品认证
+- [[SAP Ariba]]：全球采购网络平台，适合跨国企业
+- [[ZhenYun（甄云）]]：全流程数字化采购平台，适合制造业
+- [[QiQiTong（企企通）]]：中小企业供应商协同平台
+- [[Yonyou Procurement Cloud]]：用友采购云，与用友 ERP 深度集成
+- [[Manbang/满帮]]：公路货运匹配平台，用于整车运输
+- [[Huolala/货拉拉]]：同城及跨城货运匹配平台
+- [[QiChaCha/Tianyancha]]：企查查/天眼查，企业信息查询平台，用于供应商资质验证
+- [[Kraljic Matrix]]：卡尔吉克矩阵（采购品类定位工具）
+
+## Connections
+- [[Supply Chain Strategist]] ← 供应商管理核心 → [[ABC Classification]]
+- [[Supply Chain Strategist]] ← 采购策略框架 → [[Kraljic Matrix]]
+- [[Supply Chain Strategist]] ← 成本决策方法 → [[TCO Analysis]]
+- [[Supply Chain Strategist]] ← 库存优化工具 → [[EOQ Model]]
+- [[Supply Chain Strategist]] ← 数字化成熟度 → [[Supply Chain Digital Maturity]]
+- [[Supply Chain Strategist]] ← 合规审计标准 → [[RBA Code of Conduct]], [[SA8000]]
+
+## Contradictions
+- 与 [[JIT Procurement]] 的对比：
+  - 冲突点：JIT 追求零库存与安全库存原则之间的平衡
+  - 当前观点：关键物料必须设置安全库存，防止单点供应断裂
+  - 对方观点（纯 JIT 派）：零库存是最优目标，可通过高可靠性供应链实现

wiki/sources/zk-steward.md

@@ -0,0 +1,64 @@
+---
+title: "ZK Steward Agent"
+type: source
+tags: [AI-agent, knowledge-management, zettelkasten, luhmann, productivity]
+date: 2026-04-25
+---
+
+## Source File
+- [[Agent/agency-agents/specialized/zk-steward.md]]
+
+## Summary（用中文描述）
+- 核心主题：ZK Steward——以 Niklas Luhmann 的 Zettelkasten 精神构建的 AI 时代知识库管家 Agent，通过原子笔记、连接驱动和验证循环实现有机知识网络增长。
+- 问题域：AI Agent 如何避免"一次性回答"陷阱，构建可持续积累、互相连接的知识库；如何在复杂任务中切换领域专家视角以产出深度内容。
+- 方法/机制：
+  - **Luhmann 四原则验证门**：原子性（独立可理解）/ 连接性（≥2 个有意义链接）/ 有机增长（避免过度结构化）/ 持续对话（激发进一步思考）
+  - **领域专家切换机制**：按 domain × task type × output form 三角定位，选取对应领域顶级思维（Luhmann 默认，Feynman 学习/Karpathy 工程/Munger 策略等）
+  - **Zettelkasten 工作流**：创建/归档笔记时先问"与谁对话"→建链接；再问"在哪里找到"→建议索引入口
+  - **文件归档默认**：时间路径（`YYYY/MM/YYYYMMDD/`），禁止路由到 legacy/historical-only 目录
+  - **关闭清单**：四原则检查 → 文件+网络（≥2 链接） → 日志更新 → 开放循环扫荡 → 记忆同步
+- 结论/价值：将 Niklas Luhmann 的卡片盒方法论 AI 化，为知识密集型任务提供结构化、可验证、可积累的知识网络基础设施，是 [[Second Brain]] 在 AI Agent 时代的方法论实现。
+
+## Key Claims（用中文描述）
+- ZK Steward 以 Niklas Luhmann 的 Zettelkasten 方法论为默认视角，切换到各领域顶级专家（Feynman/Munger/Ogilvy/Karpathy 等）按任务类型匹配，产出深度领域内容。
+- 每个回复必须声明专家视角 + 称呼用户名，拒绝泛泛"专家"或空头方法论引用。
+- 笔记四原则验证门（原子性/连接性/有机增长/持续对话）强制笔记可独立理解且互连成网。
+- 新笔记归档时自动触发链接提议（Link-proposer）：候选链接 + 关键词 + Gegenrede 反诘问题。
+- 任务关闭必须完成： Luhmann 四原则检查 → 文件路径+≥2 链接 → 日志更新 → 开放循环扫荡 → 记忆同步。
+- 禁止：跳过验证、创建零链接笔记、路由到 legacy-only 目录。
+
+## Key Quotes
+> "Niklas Luhmann for the AI age—turning complex tasks into organic parts of a knowledge network, not one-off answers." — ZK Steward 身份定义
+> "Index entries are entry points, not categories; one note can be pointed to by many indices." — Luhmann 索引哲学
+> "Never: skip the perspective statement, use a vague 'expert' label, or name-drop without applying the method." — 关键规则
+
+## Key Concepts
+- [[Zettelkasten]]：德国社会学家 Niklas Luhmann 发明的手动卡片笔记系统——每条笔记原子化、拥有唯一 ID、与至少一条其他笔记相连，通过积累形成有机知识网络。ZK Steward 将其 AI 化，以时间路径归档、索引入口导向、多链接驱动为核心理念。
+- [[Luhmann-四原则]]（原子性/连接性/有机增长/持续对话）：ZK Steward 的强制验证门，每条笔记必须通过四个维度检查方可归档，是 Zettelkasten 方法论的执行性约束。
+- [[Domain-Thinking]]（领域思维）：按 domain × task type × output form 三维定位，选取该领域顶级专家视角驱动输出，确保深度而非泛泛。
+- [[Gegenrede]]（反诘）：链接提议后提出一个跨学科反问，激发笔记间的辩证对话，防止同质化链接。
+- [[Atomic-Note]]（原子笔记）：可独立理解、最小粒度的知识单元，是 Zettelkasten 的基本构建块。
+- [[Link-Proposer]]（链接提议器）：新笔记归档时自动运行的流程——输出候选链接 + 关键词 + Gegenrede 反诘问题。
+- [[Daily-Log]]（每日日志）：`memory/YYYY-MM-DD.md` 格式，记录 Intent / Changes / Open loops，维持知识网络的时效性。
+
+## Key Entities
+- [[Niklas-Luhmann]]：德国社会学家（1927-1998），Zettelkasten 卡片盒知识管理法创始人，一生积累 9 万+张卡片，产出 70 部著作。ZK Steward 以其为默认视角。
+- [[zk-steward-companion]]（GitHub repo）：ZK Steward 的配套技能库，包含 link-proposer / index-note / strategic-advisor / workflow-audit / structure-note / random-walk / deep-learning 等可选用工作流。
+- **Karpathy**：AI/工程领域专家，按 domain-thinking 映射表对应 Tech/engineering 领域。
+- **Charlie Munger**：商业策略领域专家，按 domain-thinking 映射表对应 Business strategy（Mental models, inversion）。
+- **Richard Feynman**：学习/研究领域专家，按 domain-thinking 映射表对应 Learning/research（First principles, teach to learn）。
+- **David Ogilvy**：品牌营销领域专家，对应 Brand marketing（Long copy, brand persona）。
+
+## Connections
+- [[zk-steward]] ← implements ← [[Zettelkasten]]
+- [[zk-steward]] ← applies ← [[Niklas-Luhmann]]
+- [[zk-steward]] ← uses ← [[Luhmann-四原则]]
+- [[zk-steward]] ← triggers ← [[Link-Proposer]]
+- [[zk-steward]] ← follows ← [[Domain-Thinking]]
+- [[zk-steward]] ← part_of ← [[zk-steward-companion]]
+- [[Second-Brain]] ← related_to ← [[zk-steward]]（两者同属外部认知能力建设，Second Brain 为通用框架，ZK Steward 为具体 Agent 实现）
+- [[养虾日记3]] ← mentions ← [[zk-steward]]（"融合了 Karpathy 的 LLM Wiki 理念"即指 zk-steward 类型的 Zettelkasten 工作流）
+
+## Contradictions
+- 与 [[Second-Brain]] 关系：两者均强调外部知识积累，但 Second Brain 侧重捕获与检索的零摩擦（"像发短信一样简单"），ZK Steward 侧重强制结构化验证（ Luhmann 四原则）和多专家视角切换。两者互补，Second Brain 作为捕获层，ZK Steward 作为结构化处理层。
+- 与 [[agents-orchestrator]]：Agents Orchestrator 强调流水线质量门控（每个任务必须通过截图验证才能推进），ZK Steward 强调知识积累验证（四原则检查）；前者面向任务执行可靠性，后者面向知识增长质量。