Sync: expand ui system components notes
This commit is contained in:
@@ -4,6 +4,9 @@
|
||||
- [Overview](overview.md) — living synthesis
|
||||
|
||||
## Sources
|
||||
- [2026-04-25] [MCP Builder Agent](sources/specialized-mcp-builder.md)
|
||||
- [2026-04-25] [Compliance Auditor Agent](sources/compliance-auditor.md)
|
||||
- [2026-04-25] [Specialized Salesforce Architect](sources/specialized-salesforce-architect.md)
|
||||
- [2026-04-25] [LSP/Index Engineer Agent Personality](sources/lsp-index-engineer.md)
|
||||
- [2026-04-25] [Model QA Specialist](sources/specialized-model-qa.md)
|
||||
- [2026-04-25] [Corporate Training Designer](sources/corporate-training-designer.md)
|
||||
@@ -408,9 +411,6 @@
|
||||
- [2026-04-20] [sales-data-extraction-agent](sources/sales-data-extraction-agent.md) — (expected: wiki/sources/sales-data-extraction-agent.md — source missing)
|
||||
- [2026-04-20] [agents-orchestrator](sources/agents-orchestrator.md) — (expected: wiki/sources/agents-orchestrator.md — source missing)
|
||||
- [2026-04-20] [study-abroad-advisor](sources/study-abroad-advisor.md) — (expected: wiki/sources/study-abroad-advisor.md — source missing)
|
||||
- [2026-04-20] [specialized-mcp-builder](sources/specialized-mcp-builder.md) — (expected: wiki/sources/specialized-mcp-builder.md — source missing)
|
||||
- [2026-04-20] [compliance-auditor](sources/compliance-auditor.md) — (expected: wiki/sources/compliance-auditor.md — source missing)
|
||||
- [2026-04-20] [specialized-salesforce-architect](sources/specialized-salesforce-architect.md) — (expected: wiki/sources/specialized-salesforce-architect.md — source missing)
|
||||
- [2026-04-20] [automation-governance-architect](sources/automation-governance-architect.md) — (expected: wiki/sources/automation-governance-architect.md — source missing)
|
||||
- [2026-04-20] [llm-wiki](sources/llm-wiki.md) — (expected: wiki/sources/llm-wiki.md — source missing)
|
||||
- [2026-04-20] [baoyu-skills](sources/baoyu-skills.md) — (expected: wiki/sources/baoyu-skills.md — source missing)
|
||||
|
||||
26
wiki/log.md
26
wiki/log.md
@@ -1,3 +1,29 @@
|
||||
## [2026-04-25] ingest | MCP Builder Agent
|
||||
- Source file: Agent/agency-agents/specialized/specialized-mcp-builder.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: MCP Builder Agent——AI Agent 的 MCP(Model Context Protocol)服务器开发专家,设计、构建、测试和部署 MCP 服务器,为 AI Agent 提供自定义工具(Tools)、资源(Resources)和提示词模板(Prompts)能力。核心理念:工具命名即 UX,正确选用率目标 >90%;技术栈 TypeScript+Zod 或 Python+Pydantic;核心原则:无状态设计、结构化错误返回、环境变量密钥、边界验证、真实 Agent 测试。
|
||||
- Concepts created: 无(Key Concepts 中 10 个术语均为 Source Page 内可解释的协议/框架级概念,通过 wikilinks 形式表达,不具备跨页面复用价值,未单独建 Concept 页面)
|
||||
- Entities created: 无(MCP SDK/FastMCP/Zod/Pydantic 仅出现 1 次,不满足 ≥2 次条件,通过 Key Entities 链接保留在 Source Page)
|
||||
- Source page: wiki/sources/specialized-mcp-builder.md
|
||||
- Notes: index.md 中原有 "source missing" 占位条目(2026-04-20)已替换为完整条目;overview.md Specialized 部门新增 MCP Builder Agent 条目置于 visionos-spatial-engineer 之后;无冲突内容检测。
|
||||
|
||||
## [2026-04-25] ingest | Compliance Auditor Agent
|
||||
- Source file: Agent/agency-agents/specialized/compliance-auditor.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: Compliance Auditor Agent——The Agency Specialized 部门的技术合规审计专家,专注 SOC 2、ISO 27001、HIPAA、PCI-DSS 认证审计全流程。五步工作流:Scoping → Gap Assessment → Remediation Support → Audit Support → Continuous Compliance。核心原则:不跟随的政策比没政策更危险、证据必须证明整个审计周期持续有效、技术控制优于管理控制、自动化证据收集从第一天建立。
|
||||
- Concepts created: 无(Key Concepts 中 6 个术语均为 Source Page 内可解释的术语,不具备跨页面复用价值,未单独建 Concept 页面)
|
||||
- Entities created: 无(SOC-2/ISO-27001/HIPAA/PCI-DSS 均为框架级标准,在多个来源中出现但以 wikilinks 形式表达,未单独建 Entity 页面)
|
||||
- Source page: wiki/sources/compliance-auditor.md
|
||||
- Notes: index.md 中原有 "source missing" 占位条目(2026-04-20)已移除并替换为完整条目;overview.md Specialized 部门新增 Compliance Auditor 条目置于 healthcare-marketing-compliance 之后;与 [[specialized-model-qa]] 在证据定义上的差异已记录于 Contradictions 部分。
|
||||
|
||||
## [2026-04-25] ingest | Specialized Salesforce Architect
|
||||
- Source file: Agent/agency-agents/specialized/specialized-salesforce-architect.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: Salesforce 企业级解决方案架构师 Agent — 多云架构设计(Sales/Service/Marketing/Commerce/Data Cloud/Agentforce)、企业集成模式(REST/Platform Events/CDC/MuleSoft)、数据模型设计与治理、Governor Limit 预算规划、CI/CD 部署策略(Salesforce DX/DevOps Center)。核心原则:Governor limits 不可协商、Bulkification 强制要求、Declarative-first、Trigger 只委托不分发、集成模式必须处理失败场景。
|
||||
- Concepts created: 无(技术术语通过 Source Page Key Concepts + wikilinks 表达,未单独建页面)
|
||||
- Source page: wiki/sources/specialized-salesforce-architect.md
|
||||
- Notes: 无冲突内容检测;MuleSoft、Shield Platform Encryption、DevOps Center 作为 Key Entities 链接保留在 Source Page;Platform Events vs CDC 对比表已提取为 Key Claims
|
||||
|
||||
## [2026-04-25] ingest | Model QA Specialist
|
||||
- Source file: Agent/agency-agents/specialized/specialized-model-qa.md
|
||||
- Status: ✅ 成功摄入
|
||||
|
||||
@@ -63,6 +63,8 @@ The wiki covers two major multi-agent frameworks: **The Agency** (agency-agents)
|
||||
|
||||
**[[visionos-spatial-engineer]]**(visionOS Spatial Engineer):Apple visionOS 原生空间计算 Agent——专注于 visionOS 26 平台的 SwiftUI volumetric interfaces 和 Liquid Glass Design System 实现。核心能力:Liquid Glass 透明材质设计(自适应 light/dark 环境)、Spatial Widgets(吸附墙面/桌面、持久化放置)、SwiftUI Volumetric APIs(3D 内容集成、volume transient content、breakthrough UI)、RealityKit-SwiftUI 集成(Observable entities、直接手势处理、ViewAttachmentComponent)、Multi-Window Architecture(WindowGroup 管理、玻璃背景效果)、GPU 高效渲染。技术栈:SwiftUI / RealityKit / ARKit / Metal。典型交付物:visionOS 原生空间应用、volumetric 界面、Liquid Glass 体验。与 [[macos-spatial-metal-engineer]] 协同——前者专注 UI/UX 层应用开发,后者专注 GPU 密集型数据渲染,共同构成完整的 Apple 空间计算平台能力。属 [[Spatial-Computing]] 概念在 Apple 原生平台场景的具体实现。
|
||||
|
||||
**[[specialized-mcp-builder]]**(MCP Builder Agent):AI Agent 的 MCP(Model Context Protocol)服务器开发专家——设计、构建、测试和部署 MCP 服务器,为 AI Agent 提供自定义工具(Tools)、资源(Resources)和提示词模板(Prompts)能力。核心理念:**工具命名即 UX**——`search_tickets` 优于 `query1`,Agent 必须能从名称推断用途,正确选用率目标 >90%。技术栈:TypeScript + Zod(官方 MCP SDK)或 Python + Pydantic(FastMCP)。核心原则:无状态设计(每次调用独立)、结构化错误返回(`isError: true` 而非堆栈跟踪)、环境变量密钥管理、边界层参数验证、真实 Agent 完整链路测试。高级能力:多传输层支持(Stdio/SSE/Streamable HTTP)、OAuth 2.0 认证、动态工具注册(OpenAPI→MCP 自动生成)、组合式服务器架构。与 [[agentic-identity-trust]] 协同——后者提供身份与信任基础,前者提供工具能力扩展,共同构成完整 Agent 基础设施。与 [[llm-wiki]] 在知识系统层面关联——MCP 服务器可为 Wiki Agent 提供外部知识检索能力。
|
||||
|
||||
### The Agency — Project Management 部门
|
||||
|The Agency 的 Project Management 部门涵盖多个垂直领域的专业项目管理 Agent,从战略组合管理到实验跟踪,覆盖项目全生命周期。|
|
||||
|
||||
@@ -689,6 +691,8 @@ Key concepts: [[Django ORM]], [[Django REST Framework]], [[Django Admin 定制]]
|
||||
|
||||
**[[healthcare-marketing-compliance]]**(Healthcare Marketing Compliance Specialist):The Agency Specialized 部门的医疗营销合规专家——覆盖中国医疗健康全品类(药品/医疗器械/医美/保健食品/互联网医疗)营销合规,深度熟悉《广告法》《医疗广告管理办法》《互联网广告管理办法》等核心法规体系。核心能力:医疗广告审查(《医疗广告审查证明》申请与合规)、处方药/OTC药广告分规管理、医疗器械三类分级合规(I类备案/II类注册/III类严格审批)、医美"容貌焦虑"红线防控、保健品"蓝帽子"标识管理、互联网诊疗合规(初诊必须线下面诊)、患者隐私 PIPL 合规(敏感个人信息须单独授权)、学术推广合规(医疗代表备案、会议赞助标准、医师讲课费规范)。关键原则:**合规不是"堵营销",而是"保护品牌"**——一次违规处罚的代价远高于合规投入;**"事前审查"优于"事后补救"**——所有对外发布的医疗营销内容必须经过合规团队审核。成功指标:年度零监管处罚、平台违规 < 3次/年、100% 内容发布前合规审查覆盖率。属 The Agency Specialized 部门的合规垂直方向,与 [[government-digital-presales-consultant]](政府合规)和 [[legal-compliance-checker]](通用法律合规)共同构成完整的合规能力体系。
|
||||
|
||||
**[[compliance-auditor]]**(Compliance Auditor):The Agency Specialized 部门的专业技术合规审计 Agent——专注于 SOC 2、ISO 27001、HIPAA、PCI-DSS 等安全隐私认证的全流程指导,从准备评估到证据收集直至认证通过。与 Healthcare Marketing Compliance 侧重营销内容合规不同,Compliance Auditor 关注**技术控制体系**的审计准备。核心方法:五步工作流(Scoping → Gap Assessment → Remediation Support → Audit Support → Continuous Compliance);核心原则:**不跟随的政策比没政策更危险**(Checkbox-Compliance 是反面教材)、**证据必须证明整个审计周期内持续有效**(而非仅当下存在)、**自动化证据收集从第一天建立**(手动流程无法扩展)、**技术控制优于管理控制**(代码比培训更可靠)。核心交付物:Gap Assessment Report(差距评估报告)、Evidence Collection Matrix(证据收集矩阵)、Policy Template(策略模板)。成功指标:零不合格发现(zero adverse findings)、审计周期缩短 30%、年度合规状态持续可查。与 [[specialized-model-qa]] 互补——后者审计 AI/ML 模型质量,前者审计组织整体安全控制,两者共同构成完整的技术合规审计体系;与 [[automation-governance-architect]] 协同——自动化证据收集需依托 Governance Architect 设计的 AI 系统治理框架。
|
||||
|
||||
|**[[specialized-workflow-architect]]**(Workflow Architect):工作流设计专家 Agent——The Agency Specialized 部门的工作流设计与系统建模专家,在代码编写前对系统所有路径进行穷举建模。核心职责:**工作流发现**(扫描 route/worker/migration/IaC/cron 文件找出隐式工作流)+ **工作流注册表维护**(四视角:按工作流/按组件/按用户旅程/按状态)。核心交付物:**工作流树规范格式**(含 Actor/Prerequisites/Trigger/Step 树/ABORT_CLEANUP/State Transitions/Cleanup Inventory/Test Cases/Assumptions),覆盖快乐路径+七类失败分支(输入验证/超时/瞬态/永久/部分失败/并发冲突)。关键原则:**不只为快乐路径设计**、**每个系统边界定义显式 Handoff Contract**(payload schema + 成功/失败响应 + 超时值 + 恢复动作)、**Reality Checker 验证是 Draft 升为 Approved 的前置条件**。Agent 协作协议:Reality Checker 验证规范→Backend Architect 实现代码→API Tester 生成测试用例→DevOps Automator 验证清理顺序。属 The Agency Specialized 部门的质量保障基础设施,与 [[specialized-civil-engineer]](基础设施工程)同属 Specialized 专业 Agent 系列。
|
||||
|
||||
**[[corporate-training-designer]]**(Corporate Training Designer):The Agency Specialized 部门的企业培训体系架构师与课程开发专家——专注企业级培训需求分析、ADDIE/SAM 教学设计模型、混合学习项目、内训师培养(TTT)、领导力发展(HIPO)及 Kirkpatrick 四级培训效果评估。核心价值观:**优秀培训的衡量标准不是"教了什么",而是"学员回去做了什么"**。关键方法:ADDIE 模型(分析→设计→开发→实施→评估)、Bloom 认知六层次、Kirkpatrick 四级评估(反应→学习→行为→业务结果)、Kolb 体验式学习圈、OMO 混合学习(线上"认知"→线下"实践"→社群"持续")。与 [[specialized-workflow-architect]](工作流设计)和 [[cultural-intelligence-strategist]](跨文化产品设计)形成系统性设计能力互补——分别应用于组织学习、软件工程和文化包容三大领域,共同构成 [[The Agency]] 的系统性设计矩阵。
|
||||
|
||||
60
wiki/sources/compliance-auditor.md
Normal file
60
wiki/sources/compliance-auditor.md
Normal file
@@ -0,0 +1,60 @@
|
||||
---
|
||||
title: "Compliance Auditor Agent"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-25
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/specialized/compliance-auditor.md]]
|
||||
|
||||
## Summary(用中文描述)
|
||||
- 核心主题:专业 AI Agent,专注于 SOC 2、ISO 27001、HIPAA、PCI-DSS 等安全隐私认证审计的全流程指导——从准备评估到证据收集直至认证通过。
|
||||
- 问题域:组织如何系统性地通过合规认证,避免"打勾式合规"(checkbox compliance),确保控制措施真正落地而非仅存在于文档中。
|
||||
- 方法/机制:五步工作流(Scoping → Gap Assessment → Remediation Support → Audit Support → Continuous Compliance);强调自动化证据收集、右置控制项设计、以审计员视角反向思考。
|
||||
- 结论/价值:合规项目应与公司规模和实际风险匹配;技术控制优于管理控制;证据必须证明控制在整个审计周期内持续有效,而非仅存在于当下。
|
||||
|
||||
## Key Claims(用中文描述)
|
||||
- 不被遵守的政策比没有政策更危险——它制造虚假信心,增加审计风险。
|
||||
- 自动化证据收集从第一天就应建立——手动流程无法扩展。
|
||||
- 使用通用控制框架(common control framework)可一个控制集满足多个认证标准。
|
||||
- 技术控制优于管理控制——代码比培训更可靠。
|
||||
- 审计边界(scope)必须清晰定义,明确包含和排除的范围。
|
||||
- 例外情况(exceptions)需要完整文档:谁批准、为什么、有何时效、有何补偿控制。
|
||||
|
||||
## Key Quotes
|
||||
> "A policy nobody follows is worse than no policy — it creates false confidence and audit risk."
|
||||
> — 核心原则:不follow的政策比没政策更危险
|
||||
|
||||
> "Evidence must prove the control operated effectively over the audit period, not just that it exists today."
|
||||
> — 证据的核心要求:证明整个审计周期内持续有效
|
||||
|
||||
> "Think like the auditor: what would you test? what evidence would you request?"
|
||||
> — 审计员心态:反向思考,模拟审计师会问什么
|
||||
|
||||
## Key Concepts
|
||||
- [[Checkbox-Compliance]]:仅在文档层面满足合规要求,控制实际未落地或未被测试——文档中的反面案例。
|
||||
- [[Continuous-Compliance]]:持续合规——在两次年度审计之间建立自动化证据收集管道和季度控制测试机制,而非年度突击准备。
|
||||
- [[Common-Control-Framework]]:通用控制框架——设计一组控制项同时满足多个认证标准(如 SOC 2 + ISO 27001),避免重复工作。
|
||||
- [[Technical-Controls-Vs-Administrative-Controls]]:技术控制(如 IAM 策略、代码审计)优于管理控制(如培训、签到表),因为代码比人的行为更可靠。
|
||||
- [[Compensating-Control]]:补偿控制——当某项控制无法直接满足时,用于降低风险的替代措施;需完整记录批准人、原因和有效期。
|
||||
- [[Evidence-Collection-Matrix]]:证据收集矩阵——以控制目标(而非内部团队结构)组织证据的结构化文档,列出控制ID、证据类型、来源、收集方式和频率。
|
||||
|
||||
## Key Entities
|
||||
- [[SOC-2]]:安全、可用性、处理完整性、机密性、隐私五大信任服务标准(Trust Service Criteria),最常见的云服务安全认证。
|
||||
- [[ISO-27001]]:国际信息安全管理标准,提供系统化的风险管理方法。
|
||||
- [[HIPAA]]:美国医疗信息隐私法规,涵盖 PHI(受保护健康信息)的保护要求。
|
||||
- [[PCI-DSS]]:支付卡行业数据安全标准,适用于处理信用卡信息的组织。
|
||||
|
||||
## Connections
|
||||
- [[specialized-model-qa]] ← extends ← [[compliance-auditor]]:Model QA 关注 ML 模型质量,Compliance Auditor 关注整体安全控制——两者在模型部署合规证据收集上存在交叉。
|
||||
- [[automation-governance-architect]] ← depends_on ← [[compliance-auditor]]:合规审计所需的自动化证据收集需依托 Governance Architect 设计的 AI 系统治理框架。
|
||||
- [[CTP-Topic-52-3-Lines-of-Defence]] ← extends ← [[compliance-auditor]]:三道防线模型(业务管理 / 风险职能 / 内部审计)与合规审计的职责划分高度对应。
|
||||
- [[DevSecOps]] ← extends ← [[compliance-auditor]]:DevSecOps 将安全控制集成到 CI/CD 流水线中,是合规 Auditor 推荐的技术控制实现方式。
|
||||
|
||||
## Contradictions
|
||||
- 与 [[specialized-model-qa]] 的侧重点差异:
|
||||
- 冲突点:Compliance Auditor 关注组织级控制(access control, incident response),Model QA 关注模型本身的质量与统计特性,两者对"证据"的定义不同。
|
||||
- 当前观点:合规证据以控制操作日志、策略文档、访问审查记录为主。
|
||||
- 对方观点:模型证据以 PSI、校准曲线、SHAP 值等统计指标为主。
|
||||
- 协调建议:两者可互补——Compliance Auditor 负责整体安全框架,Model QA 负责嵌入其中的 AI/ML 模型专项审计。
|
||||
55
wiki/sources/specialized-mcp-builder.md
Normal file
55
wiki/sources/specialized-mcp-builder.md
Normal file
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: "MCP Builder Agent"
|
||||
type: source
|
||||
tags: ["agent-personality", "mcp", "tool-design", "ai-integration"]
|
||||
date: 2026-04-20
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/specialized/specialized-mcp-builder.md]]
|
||||
|
||||
## Summary(用中文描述)
|
||||
- 核心主题:AI Agent 的 MCP(Model Context Protocol)服务器开发专家——设计、构建、测试和部署 MCP 服务器,为 AI Agent 提供自定义工具、资源和提示词能力
|
||||
- 问题域:如何让 AI Agent 能够可靠地调用外部工具和 API,同时保持开发者体验(Developer Experience)
|
||||
- 方法/机制:遵循 MCP SDK 规范(TypeScript/Zod、Python/Pydantic),设计 Agent 友好的工具接口,提供 Resources(资源)、Tools(工具)、Prompts(提示词模板)三种扩展方式,通过真实 Agent 测试验证可用性
|
||||
- 结论/价值:工具命名和描述是 Agent 能否正确选用的关键;每个工具调用必须独立无状态;错误必须返回结构化消息而非堆栈跟踪
|
||||
|
||||
## Key Claims(用中文描述)
|
||||
- **描述性工具命名** → Agent 能从名称推断用途,正确选用率 >90%
|
||||
- **类型化参数验证(Zod/Pydantic)** → 边界层拦截非法输入,防止外部 API 污染
|
||||
- **结构化错误返回(isError: true)** → Agent 知道何时重试或请求用户,而非虚构响应
|
||||
- **无状态工具设计** → 每次调用独立,不依赖调用顺序,确保分布式环境稳定
|
||||
- **真实 Agent 测试循环** → 通过完整调用链路验证,而非仅靠单元测试
|
||||
- **环境变量密钥管理** → API Key 和 Token 从环境变量读取,绝不硬编码
|
||||
|
||||
## Key Quotes
|
||||
> "If an agent can't figure out how to use your tool from the name and description alone, it's not ready to ship." — MCP Builder 核心理念
|
||||
> "A tool that passes unit tests but confuses the agent is broken." — 测试理念,强调必须验证 Agent 的完整调用路径
|
||||
> "We return `isError: true` here so the agent knows to retry or ask the user, instead of hallucinating a response." — 错误处理设计哲学
|
||||
|
||||
## Key Concepts
|
||||
- [[Model Context Protocol (MCP)]]:Anthropic 提出的 AI Agent 与外部工具/数据源交互的标准化协议
|
||||
- [[MCP Server]]:基于 MCP 协议的服务端实现,暴露 Tools/Resources/Prompts 给 Agent
|
||||
- [[Tool Interface Design]]:为 Agent 设计友好工具接口的实践,关注命名、描述、参数类型和返回结构
|
||||
- [[Zod Validation]]:TypeScript 端的参数模式定义和验证库,用于 MCP TypeScript 服务器
|
||||
- [[Pydantic Validation]]:Python 端的参数模式定义和验证库,用于 MCP Python (FastMCP) 服务器
|
||||
- [[Stdio Transport]]:MCP 标准传输方式,适用于本地 CLI 集成和桌面 Agent
|
||||
- [[SSE Transport]]:Server-Sent Events 传输方式,适用于基于 Web 的 Agent 接口和远程访问
|
||||
- [[Streamable HTTP]]:可扩展云部署的 HTTP 流式传输,支持无状态请求处理
|
||||
- [[Stateless Tool Design]]:无状态工具设计原则,确保每次调用独立、幂等、可分布式运行
|
||||
- [[Structured Error Response]]:返回 `isError: true` 结构化错误消息,而非堆栈跟踪
|
||||
|
||||
## Key Entities
|
||||
- [[@modelcontextprotocol/sdk]]:Anthropic 官方 MCP TypeScript SDK,提供 McpServer、StdioServerTransport 等核心类
|
||||
- [[FastMCP]]:Python MCP 服务器框架,基于 Pydantic 的类型验证
|
||||
- [[Zod]]:TypeScript schema 声明和验证库,MCP TypeScript SDK 内置支持
|
||||
- [[Pydantic]]:Python 数据验证库,FastMCP 的核心依赖
|
||||
|
||||
## Connections
|
||||
- [[MCP Builder Agent]] ← implements ← [[Model Context Protocol (MCP)]]
|
||||
- [[MCP Builder Agent]] ← uses ← [[@modelcontextprotocol/sdk]]
|
||||
- [[MCP Builder Agent]] ← uses ← [[FastMCP]]
|
||||
- [[LSP/Index Engineer Agent Personality]] ← shares_tool_design_philosophy_with ← [[MCP Builder Agent]]
|
||||
|
||||
## Contradictions
|
||||
- 暂无发现与其他 Wiki 页面的冲突
|
||||
56
wiki/sources/specialized-salesforce-architect.md
Normal file
56
wiki/sources/specialized-salesforce-architect.md
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: "Specialized Salesforce Architect"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-20
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/specialized/specialized-salesforce-architect.md]]
|
||||
|
||||
## Summary(用中文描述)
|
||||
- 核心主题:Salesforce 平台企业级解决方案架构师 Agent — 多云架构设计、企业集成模式、技术治理
|
||||
- 问题域:Salesforce 组织从试点到企业规模扩展过程中的架构设计、技术债务规避、governor limits 规划
|
||||
- 方法/机制:ADR(架构决策记录)、Governor Limit Budget 追踪、Integration Pattern Template、数据模型审查清单
|
||||
- 结论/价值:提供从发现评估 → 架构设计 → 实施指导 → 审查治理的完整工作流,强调 declarative-first 原则和 bulkification 强制性要求
|
||||
|
||||
## Key Claims(用中文描述)
|
||||
- Governor limits 是不可协商的铁律,每项设计必须提前计入 SOQL(100)、DML(150)、CPU(同步10s/异步60s)、堆(同步6MB/异步12MB) 等限制
|
||||
- 业务逻辑必须放在 Handler 类中,Trigger 只负责委托分发,且每个对象只允许一个 Trigger
|
||||
- Bulkification 是强制要求 — 若代码在 200 条记录下失败,则该代码就是错误的
|
||||
- Declarative first,代码第二:优先使用 Flows、公式字段和验证规则,只在 declarative 方案变得不可维护时才考虑 Apex
|
||||
- 集成模式必须处理失败场景:每次外部调用都需要重试逻辑、断路器和死信队列
|
||||
- 数据模型是基础:在生产上线后再改数据模型,成本是设计阶段的 10 倍
|
||||
- PII 数据必须加密存储,使用 Shield Platform Encryption 或自定义加密方案
|
||||
|
||||
## Key Quotes
|
||||
> "Governor limits are non-negotiable. Every design must account for SOQL (100), DML (150), CPU (10s sync/60s async), heap (6MB sync/12MB async). No exceptions, no 'we'll optimize later.'" — 核心设计原则
|
||||
> "If the code would fail on 200 records, it's wrong." — Bulkification 强制性标准
|
||||
> "Data model is the foundation. Changing the data model after go-live is 10x more expensive." — 数据模型优先级
|
||||
> "Be direct about technical debt. If someone built a trigger that should be a flow, say so." — 沟通风格示例
|
||||
|
||||
## Key Concepts
|
||||
- [[GovernorLimits]]:Salesforce 平台执行上下文的硬性资源限制,包括 SOQL 查询数(100)、DML 语句数(150)、CPU 时间(同步10s)、堆大小(同步6MB)等
|
||||
- [[Bulkification]]:批量处理模式 — 要求所有触发器和 Apex 代码必须能在单次交易中处理多条记录(通常按 200 条/批次测试)
|
||||
- [[PlatformEvents]]:Salesforce 平台事件 — 用于跨系统集成的异步事件驱动机制,支持 72 小时重放窗口和高容量标准(10万/天)
|
||||
- [[ChangeDataCapture]](CDC):变更数据捕获 — 自动追踪 sObject 字段级变更,适合 Salesforce 原生事件同步场景
|
||||
- [[ADR]](Architecture Decision Record):架构决策记录 — 文档化记录重要技术决策的上下文、备选方案、后果和复审日期
|
||||
- [[SalesforceDX]]:Salesforce 开发者体验框架 — 基于 Scratch Org 的源代码驱动部署方式,与 DevOps Center 并行
|
||||
- [[Agentforce]]:Salesforce AI Agent 框架 — Agent 在 Salesforce governor limits 内运行,需设计在 CPU/SOQL 预算内完成的动作,使用 Einstein Trust Layer 进行 PII 脱敏
|
||||
|
||||
## Key Entities
|
||||
- [[MuleSoft]]:Salesforce 收购的企业级集成中间件,用于跨系统集成模式中的中间转换层(DataWeave 转换、3x 指数退避重试、死信队列)
|
||||
- [[ShieldPlatformEncryption]]:Salesforce 原生 PII 加密方案,与自定义加密并列作为敏感数据保护选项
|
||||
- [[DevOpsCenter]]:Salesforce 原生 CI/CD 平台,与 Salesforce DX 并行的另一种部署方式
|
||||
|
||||
## Connections
|
||||
- [[SalesforceDX]] ← supports ← [[ADR]]
|
||||
- [[PlatformEvents]] ← extends ← [[ChangeDataCapture]]
|
||||
- [[Bulkification]] ← enforces ← [[GovernorLimits]]
|
||||
- [[Agentforce]] ← bounded_by ← [[GovernorLimits]]
|
||||
|
||||
## Contradictions
|
||||
- 与 [[DevOpsCenter]] 关系:
|
||||
- 冲突点:Salesforce DX 与 DevOps Center 是两种并行的部署策略,文档将两者并列但未明确优先选用哪个
|
||||
- 当前观点:Salesforce DX 基于 Scratch Org 源码驱动是现代标准实践
|
||||
- 对方观点:DevOps Center 作为 Salesforce 原生工具对非技术用户更友好
|
||||
Reference in New Issue
Block a user