Sync: add integration and agent file notes
This commit is contained in:
27
wiki/concepts/AgentFileFormat.md
Normal file
27
wiki/concepts/AgentFileFormat.md
Normal file
@@ -0,0 +1,27 @@
|
||||
---
|
||||
title: "AgentFileFormat"
|
||||
type: concept
|
||||
tags: []
|
||||
---
|
||||
|
||||
## Definition
|
||||
Agent 定义文件采用 `.md` + YAML frontmatter 格式，是 Agency 项目与 GitHub Copilot 的共同标准文件格式。
|
||||
|
||||
## Core Properties
|
||||
- **格式**：`Markdown 文本 + YAML frontmatter 元数据`
|
||||
- **Frontmatter 字段**（典型）：`name`、`description`、`instructions`、`tools`、`model` 等
|
||||
- **兼容平台**：The Agency agents、GitHub Copilot agents、Cursor（通过 `.mdc` 转换）
|
||||
|
||||
## Usage
|
||||
1. **The Agency**：所有 agent 定义均使用此格式，存储于 `agency-agents/` 目录下
|
||||
2. **GitHub Copilot**：直接读取 `.md` + YAML frontmatter，无需转换
|
||||
3. **Cursor**：通过 `install.sh --tool cursor` 转换为 `.mdc` 规则文件
|
||||
|
||||
## Aliases
|
||||
- Agent Definition Format
|
||||
- Agency Agent Format
|
||||
|
||||
## Related
|
||||
- [[GitHubCopilot]] — 使用此格式的 IDE
|
||||
- [[TheAgency]] — 使用此格式的核心项目
|
||||
- [[Cursor]] — 支持此格式（需转换）的 IDE
|
||||
44
wiki/entities/BackendArchitect.md
Normal file
44
wiki/entities/BackendArchitect.md
Normal file
@@ -0,0 +1,44 @@
|
||||
---
|
||||
title: "Backend Architect"
|
||||
type: entity
|
||||
tags: [the-agency, engineering, multi-agent]
|
||||
last_updated: 2026-04-26
|
||||
---
|
||||
|
||||
## Overview
|
||||
The Agency 工程部门的资深后端架构师 Agent，专门负责可扩展系统设计、数据库架构、API 开发与云基础设施构建。
|
||||
|
||||
## Role
|
||||
- **Division**: Engineering
|
||||
- **Personality**: Strategic, security-focused, scalability-minded, reliability-obsessed
|
||||
- **Type**: Person（AI Agent 角色）
|
||||
|
||||
## Core Deliverables
|
||||
- 系统架构设计文档（高阶架构/服务分解/数据流）
|
||||
- 数据库 Schema 设计（PostgreSQL/MySQL 及索引规范）
|
||||
- API 设计与规范（REST/GraphQL/gRPC）
|
||||
- 云基础设施配置（AWS/GCP/Azure）
|
||||
|
||||
## Memory Integration
|
||||
Backend Architect 是 The Agency 中首批深度集成 MCP Memory 的 Agent 之一：
|
||||
|
||||
- **会话启动**：检索标签含 `backend-architect` + 项目名的历史记忆，防止重复讨论已做决策
|
||||
- **架构决策**：以标签化快照持久化（`backend-architect` + 项目名 + 主题标签如 `database-schema`/`api-design`/`auth-strategy`），包含决策理由
|
||||
- **交付物完成**：主动记忆并标记接收方（如 `frontend-developer` + `api-spec`），供下游 Agent 查找
|
||||
- **QA 失败**：检索最近良好检查点并回滚，而非手动撤销变更链
|
||||
|
||||
## Success Metrics
|
||||
- API 响应时间 95 百分位持续低于 200ms
|
||||
- 系统可用性超过 99.9%
|
||||
- 数据库查询平均低于 100ms（含正确索引）
|
||||
- 安全审计零高危漏洞
|
||||
- 峰值负载下成功处理 10 倍正常流量
|
||||
|
||||
## References
|
||||
- Source: [[backend-architect-with-memory]]
|
||||
- Coordinated by: [[agents-orchestrator]]
|
||||
- Enabled by: [[mcp-builder-agent]]
|
||||
|
||||
## Aliases
|
||||
- Backend Architect with Memory
|
||||
- backend-architect-with-memory
|
||||
18
wiki/entities/GitHubCopilot.md
Normal file
18
wiki/entities/GitHubCopilot.md
Normal file
@@ -0,0 +1,18 @@
|
||||
---
|
||||
title: "GitHubCopilot"
|
||||
type: entity
|
||||
tags: []
|
||||
---
|
||||
|
||||
## Identity
|
||||
GitHub Copilot — GitHub 开发的 AI 编程助手，通过 GitHub 官方集成支持用户自定义 agent。
|
||||
|
||||
## Role in Wiki
|
||||
- 使用 [[AgentFileFormat]] 作为 agent 定义标准
|
||||
- 通过 [[TheAgency]] 提供 147+ 专业化 agent
|
||||
- 用户级别全局生效（安装到 `~/.github/agents/` 或 `~/.copilot/agents/`）
|
||||
|
||||
## Related
|
||||
- [[github-copilot]] — 集成文档
|
||||
- [[AgentFileFormat]] — 支持的文件格式
|
||||
- [[TheAgency]] — agent 来源
|
||||
25
wiki/entities/Windsurf.md
Normal file
25
wiki/entities/Windsurf.md
Normal file
@@ -0,0 +1,25 @@
|
||||
---
|
||||
title: "Windsurf"
|
||||
type: entity
|
||||
tags: []
|
||||
sources: ["windsurf-integration", "integrations-readme", "Vibe-Coding"]
|
||||
last_updated: 2026-04-25
|
||||
---
|
||||
|
||||
## Overview
|
||||
Windsurf 是 Codeium 开发的 AI 代码编辑器，支持通过 `.windsurfrules` 文件注入自定义规则和 Agent 角色定义。
|
||||
|
||||
## Details
|
||||
- **开发者**：Codeium
|
||||
- **集成方式**：`.windsurfrules` 文件，项目级生效
|
||||
- **Agent 来源**：The Agency Agent roster（147 个 Agent 跨 12 部门）
|
||||
- **激活方式**：在 Windsurf prompt 中按名称引用 Agent（如 "Use the Frontend Developer agent to build this component."）
|
||||
- **安装脚本**：`install.sh --tool windsurf`，从项目根目录执行
|
||||
- **规则生成**：`convert.sh --tool windsurf` 重新生成规则文件
|
||||
|
||||
## Aliases
|
||||
- Windsurf IDE
|
||||
- Codeium Windsurf
|
||||
|
||||
## Connections
|
||||
- The Agency 的项目级 IDE 集成生态成员之一，与 [[Cursor Integration]]（.mdc）和 [[Aider Integration]]（CONVENTIONS.md）构成互补
|
||||
@@ -4,9 +4,19 @@
|
||||
- [Overview](overview.md) — living synthesis
|
||||
|
||||
## Sources
|
||||
- [2026-05-02] [Claude Code Integration](sources/claude-code-integration.md)
|
||||
- [2026-04-25] [Aider Integration](sources/readme.md)
|
||||
- [2026-04-25] [Aider Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [Backend Architect with Memory](sources/backend-architect-with-memory.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-25] [Historian Agent Personality](sources/academic-historian.md)
|
||||
- [2026-04-25] [Academic Geographer](sources/academic-geographer.md)
|
||||
- [2026-04-25] [Academic Narratologist](sources/academic-narratologist.md)
|
||||
@@ -393,7 +403,7 @@
|
||||
- [2026-04-21] [workflow-with-memory](sources/workflow-with-memory.md) — (expected: wiki/sources/workflow-with-memory.md — source missing)
|
||||
- [2026-04-21] [workflow-landing-page](sources/workflow-landing-page.md) — (expected: wiki/sources/workflow-landing-page.md — source missing)
|
||||
- [2026-04-21] [workflow-startup-mvp](sources/workflow-startup-mvp.md) — (expected: wiki/sources/workflow-startup-mvp.md — source missing)
|
||||
- [2026-04-21] [Aider Integration](sources/readme.md)
|
||||
- [2026-04-21] [OpenCode Integration](sources/readme.md)
|
||||
- [2026-04-21] [workflow-book-chapter](sources/workflow-book-chapter.md) — (expected: wiki/sources/workflow-book-chapter.md — source missing)
|
||||
- [2026-04-21] [support-executive-summary-generator](sources/support-executive-summary-generator.md) — (expected: wiki/sources/support-executive-summary-generator.md — source missing)
|
||||
- [2026-04-21] [support-finance-tracker](sources/support-finance-tracker.md) — (expected: wiki/sources/support-finance-tracker.md — source missing)
|
||||
@@ -409,12 +419,6 @@
|
||||
- [2026-04-21] [testing-reality-checker](sources/testing-reality-checker.md) — (expected: wiki/sources/testing-reality-checker.md — source missing)
|
||||
- [2026-04-21] [testing-workflow-optimizer](sources/testing-workflow-optimizer.md) — (expected: wiki/sources/testing-workflow-optimizer.md — source missing)
|
||||
- [2026-04-21] [testing-api-tester](sources/testing-api-tester.md) — (expected: wiki/sources/testing-api-tester.md — source missing)
|
||||
- [2026-04-21] [Aider Integration](sources/readme.md)
|
||||
- [2026-04-21] [Aider Integration](sources/readme.md)
|
||||
- [2026-04-21] [Aider Integration](sources/readme.md)
|
||||
- [2026-04-21] [Aider Integration](sources/readme.md)
|
||||
- [2026-04-21] [backend-architect-with-memory](sources/backend-architect-with-memory.md) — (expected: wiki/sources/backend-architect-with-memory.md — source missing)
|
||||
- [2026-04-21] [Aider Integration](sources/readme.md)
|
||||
- [2026-04-20] [security](sources/security.md) — (expected: wiki/sources/security.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)
|
||||
@@ -437,15 +441,10 @@
|
||||
- [legal-billing-time-tracking](sources/legal-billing-time-tracking.md) — (expected: wiki/sources/legal-billing-time-tracking.md — source missing)
|
||||
- [legal-client-intake](sources/legal-client-intake.md) — (expected: wiki/sources/legal-client-intake.md — source missing)
|
||||
- [hospitality-guest-services](sources/hospitality-guest-services.md) — (expected: wiki/sources/hospitality-guest-services.md — source missing)
|
||||
- [Aider Integration](sources/readme.md)
|
||||
- [OpenCode Integration](sources/readme.md)
|
||||
- [marketing-seo-specialist](sources/marketing-seo-specialist.md) — (expected: wiki/sources/marketing-seo-specialist.md — source missing)
|
||||
- [marketing-agentic-search-optimizer](sources/marketing-agentic-search-optimizer.md) — (expected: wiki/sources/marketing-agentic-search-optimizer.md — source missing)
|
||||
- [Aider Integration](sources/readme.md)
|
||||
- [Aider Integration](sources/readme.md)
|
||||
- [Aider Integration](sources/readme.md)
|
||||
- [Aider Integration](sources/readme.md)
|
||||
- [Aider Integration](sources/readme.md)
|
||||
- [Aider Integration](sources/readme.md)
|
||||
- [OpenCode Integration](sources/readme.md)
|
||||
- [finance-bookkeeper-controller](sources/finance-bookkeeper-controller.md) — (expected: wiki/sources/finance-bookkeeper-controller.md — source missing)
|
||||
- [finance-fpa-analyst](sources/finance-fpa-analyst.md) — (expected: wiki/sources/finance-fpa-analyst.md — source missing)
|
||||
- [finance-investment-researcher](sources/finance-investment-researcher.md) — (expected: wiki/sources/finance-investment-researcher.md — source missing)
|
||||
@@ -575,6 +574,7 @@
|
||||
- [AWS-Step-Functions](entities/AWS-Step-Functions.md)
|
||||
- [Axton](entities/Axton.md)
|
||||
- [Azure](entities/Azure.md)
|
||||
- [BackendArchitect](entities/BackendArchitect.md)
|
||||
- [baoyu](entities/baoyu.md)
|
||||
- [BehavioralNudgeEngine](entities/BehavioralNudgeEngine.md)
|
||||
- [bitwarden](entities/bitwarden.md)
|
||||
@@ -637,6 +637,7 @@
|
||||
- [Gamma-AI](entities/Gamma-AI.md)
|
||||
- [GDPR](entities/GDPR.md)
|
||||
- [Gitea](entities/Gitea.md)
|
||||
- [GitHubCopilot](entities/GitHubCopilot.md)
|
||||
- [Gitmoji](entities/Gitmoji.md)
|
||||
- [glances](entities/glances.md)
|
||||
- [gog](entities/gog.md)
|
||||
@@ -790,6 +791,7 @@
|
||||
- [Vinay](entities/Vinay.md)
|
||||
- [VMware](entities/VMware.md)
|
||||
- [WildCard](entities/WildCard.md)
|
||||
- [Windsurf](entities/Windsurf.md)
|
||||
- [Xiaohongshu](entities/Xiaohongshu.md)
|
||||
- [XR-Cockpit-Interaction-Specialist](entities/XR-Cockpit-Interaction-Specialist.md)
|
||||
- [XR-Immersive-Developer](entities/XR-Immersive-Developer.md)
|
||||
@@ -831,6 +833,7 @@
|
||||
- [Agent-Routing-Rules](concepts/Agent-Routing-Rules.md)
|
||||
- [Agent-Specialization](concepts/Agent-Specialization.md)
|
||||
- [Agent-Template](concepts/Agent-Template.md)
|
||||
- [AgentFileFormat](concepts/AgentFileFormat.md)
|
||||
- [AGENTS.md](concepts/AGENTS.md.md)
|
||||
- [Agile-Ceremonies](concepts/Agile-Ceremonies.md)
|
||||
- [AgilePractices](concepts/AgilePractices.md)
|
||||
|
||||
97
wiki/log.md
97
wiki/log.md
@@ -1,3 +1,84 @@
|
||||
## [2026-05-05] ingest | OpenCode Integration
|
||||
- Source file: Agent/agency-agents/integrations/opencode/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: OpenCode Integration——The Agency Agent roster 与 OpenCode 编辑器的子 Agent 集成方案，通过 `./scripts/install.sh --tool opencode` 安装，将 .md 格式 Agent 转换为 OpenCode 的 `.opencode/agents/` 格式。核心机制：`mode: subagent` 使 Agent 仅在 `@agent-name` 触发时出现，不在 Tab 循环中占位；命名颜色自动映射为十六进制颜色代码。支持项目级和全局级两种安装范围。与 [[readme|Cursor Integration]]（.mdc）、[[github-copilot|GitHub Copilot Integration]]、[[windsurf-integration|Windsurf Integration]] 同属 The Agency 多 IDE 集成生态。
|
||||
- Concepts created: 无（Subagent、OpenCode 仅在本文档出现1次，未达创建阈值）
|
||||
- Entities updated: 无（[[The Agency]] 已在其他来源中覆盖，无需新建 OpenCode entity）
|
||||
- Source page: wiki/sources/readme.md
|
||||
- Notes: 无内容冲突。index.md 和 overview.md 已更新。
|
||||
|
||||
## [2026-05-04] ingest | Kimi Code CLI Integration
|
||||
- Source file: Agent/agency-agents/integrations/kimi/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: Kimi Code CLI Integration——将 Agency agents 项目转换为 Kimi Code CLI 可用的 agent specification，通过 `convert.sh` 和 `install.sh` 脚本生成 `agent.yaml` + `system.md` 目录结构，安装到 `~/.config/kimi/agents/`。使用 `--agent-file` 标志激活，支持 `extend: default` 继承 Kimi 内置工具集。与 [[readme|Cursor Integration]] 和 [[github-copilot|GitHub Copilot Integration]] 同属 The Agency 多 IDE/CLI 集成生态。
|
||||
- Concepts created: 无（YAML配置文件、Agent规范、SystemPrompt 均仅在本文档出现1次，未达创建阈值）
|
||||
- Entities created: 无（Kimi Code CLI、Moonshot AI 均仅在本文档出现1次，未达创建阈值）
|
||||
- Source page: wiki/sources/kimi.md
|
||||
- Notes: 无内容冲突。index.md 和 overview.md 已更新。
|
||||
|
||||
## [2026-05-04] ingest | Antigravity Integration
|
||||
- Source file: Agent/agency-agents/integrations/antigravity/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: Antigravity Integration——The Agency Agent roster 与 Antigravity/Gemini 的集成方案，通过 `./scripts/install.sh --tool antigravity` 将全部 Agent roster 转换为 Antigravity SKILL.md 文件，复制到 `~/.gemini/antigravity/skills/`。所有 skill slug 统一使用 `agency-` 前缀避免命名冲突。用户可通过自然语言激活对应 agent。与 [[Cursor Integration]]（.mdc 规则）、[[Windsurf Integration]]（.windsurfrules）、[[GitHub Copilot Integration]]（原生兼容）共同构成 The Agency 的完整多平台集成生态。
|
||||
- Concepts updated: 无需更新（SKILL.md Format、Antigravity Skills、Skill Prefix Convention 等概念已在其他来源中覆盖）
|
||||
- Entities created: 无（Antigravity/Gemini、Agency Agents 均已在其他来源中出现，无需新建）
|
||||
- Source page: wiki/sources/antigravity-integration.md
|
||||
- Notes: 无内容冲突。index.md 和 overview.md 已更新。与 [[Cursor Integration]] 在"多 IDE 集成覆盖"定位上存在功能重叠，已在 Contradictions 节标注区分（前者 GUI 编辑器生态，后者 Gemini 生态）。
|
||||
|
||||
## [2026-05-03] ingest | Windsurf Integration
|
||||
- Source file: Agent/agency-agents/integrations/windsurf/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: Windsurf Integration——The Agency Agent roster 与 Windsurf 编辑器的集成方案，通过 `.windsurfrules` 文件将 Agent roster 聚合为单一规则文件，install.sh 从项目根目录安装，项目级生效。在 prompt 中按名称引用 Agent 即可激活。与 [[Cursor Integration]]（.mdc）和 [[Aider Integration]]（CONVENTIONS.md）同为项目级 IDE 集成，共同构成 The Agency 的多 IDE 覆盖体系。
|
||||
- Concepts updated: [[Agent-Activation-Pattern]]（补充 Windsurf 应用场景）、[[Project-Scoped-Tools]]（替代 Project-Scoped-Integration，与 integrations-readme.md 保持一致）
|
||||
- Entities created: [[Windsurf]]（Windsurf.md，Codeium 开发的 AI 代码编辑器，跨 3 个 source 页面出现）
|
||||
- Source page: wiki/sources/windsurf-integration.md
|
||||
- Notes: 无内容冲突。index.md 和 overview.md 已更新。slug 避免与同名 readme.md 冲突（已有多条同名占位条目），采用 windsurf-integration.md。
|
||||
|
||||
## [2026-04-26] ingest | Gemini CLI Integration
|
||||
- Source file: Agent/agency-agents/integrations/gemini-cli/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: Gemini CLI Integration——将 61 个 Agency Agents 打包为 Gemini CLI 扩展插件，安装到 `~/.gemini/extensions/agency-agents/`，安装后可在 Gemini CLI 中通过自然语言按名称激活 Agent skill（如 `frontend-developer`）。
|
||||
- Entities created: 无（Agency Agents 已在其他来源中出现，无需新建；Agent Skill 和 Extension 机制未达到 ≥2 次出现阈值）
|
||||
- Concepts created: 无
|
||||
- Source page: wiki/sources/gemini-cli.md
|
||||
- Notes: 无内容冲突。
|
||||
|
||||
## [2026-05-03] ingest | Cursor Integration
|
||||
- Source file: Agent/agency-agents/integrations/cursor/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: Cursor Integration——将 Agency roster 中的 agent 转换为 Cursor `.mdc` 规则文件，安装到项目根目录的 `.cursor/rules/` 下，**项目级别生效**。支持 `@agent-slug` 引用特定 agent，或通过 `alwaysApply: true` 设为常驻规则。与 Aider Integration 形成 IDE 集成互补。
|
||||
- Entities created: 无（Agency Agents 和 Cursor 未达到 ≥2 次出现阈值）
|
||||
- Concepts created: 无（Cursor.mdc Rules/Agency Roster/Project-Scoped Rules 仅出现 1 次，不满足 ≥2 次阈值，均以 wikilink 形式记录于 Source page）
|
||||
- Source page: wiki/sources/readme.md
|
||||
- Notes: 无内容冲突。overview.md 已新增 Cursor Integration 段落于 The Agency 贡献指南段落后。与 [[Aider Integration]] 存在功能重叠（两个工具都将 Agency agents 集成到不同 IDE），已在 Source page Contradictions 节记录。
|
||||
|
||||
## [2026-05-03] ingest | OpenClaw Integration
|
||||
- Source file: Agent/agency-agents/integrations/openclaw/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: The Agency Agent 与 OpenClaw 多智能体框架的集成方案——通过 convert.sh 将 Agent 转换为 OpenClaw workspace（含 SOUL.md/AGENTS.md/IDENTITY.md），install.sh 复制到 ~/.openclaw/agency-agents/，openclaw gateway restart 使 Agent 通过 agentId 可用。slug 采用 openclaw-integration.md 以避免与同名 Aider Integration 的 readme.md 冲突。
|
||||
- Entities created: 无（OpenClaw/The-Agency/OpenClaw-Gateway 在 overview.md 已出现多次，不满足新建阈值）
|
||||
- Concepts created: 无（OpenClaw-Workspace/Workspace-Based-Agent/Agent-Conversion 仅在源页面内出现 1 次，不满足 ≥2 次阈值，均以 wikilink 形式记录于 Source page）
|
||||
- Source page: wiki/sources/openclaw-integration.md
|
||||
- Notes: 无内容冲突。overview.md 已有 OpenClaw 相关内容，无需修订。integrations-readme.md 已有 OpenClaw wikilink，无需重复创建 Entity 页面。
|
||||
|
||||
## [2026-05-02] ingest | MCP Memory Integration
|
||||
- Source file: Agent/agency-agents/integrations/mcp-memory/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: MCP Memory Integration——通过在 Agent 提示词中加入标准化的 Memory Integration 段落，为 The Agency 中任意 Agent 添加跨会话持久记忆能力。MCP Memory Server 提供 remember/recall/rollback/search 四个核心工具。Rollback 是杀手级功能：QA 失败或架构决策出错时恢复到已知良好状态，无需手动 undo。无代码修改，仅需在 prompt 中加入标准化指令段。
|
||||
- Entities created: 无（The-Agency 已存在于 entities/，Backend-Architect/Startup-MVP-Workflow 仅出现 1 次，均不满足 ≥2 次阈值）
|
||||
- Concepts created: 无（Cross-Session-Memory/Handoff-Continuity/Rollback/Memory-Integration-Pattern/MCP-Memory-Tools/Checkpoint 均仅出现 1 次，均不满足 ≥2 次阈值，均以 wikilink 形式记录于 Source page）
|
||||
- Source page: wiki/sources/mcp-memory-integration.md
|
||||
- Notes: 无内容冲突。index.md 和 overview.md 已更新（新增 MCP Memory Integration 段落于 The Agency 段落后）。
|
||||
|
||||
## [2026-05-02] ingest | Claude Code Integration
|
||||
- Source file: Agent/agency-agents/integrations/claude-code/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: The Agency Agent 资产与 Claude Code 的原生集成方案。The Agency 从一开始就为 Claude Code 构建，无需任何格式转换，Agent 天然使用 `.md` + YAML frontmatter 格式。通过 install.sh 或手动复制将 Agent 部署到 `~/.claude/agents/`，在 Claude Code 会话中通过名称引用即可激活对应 Agent。
|
||||
- Entities created: 无（Claude Code/The Agency 均仅出现 1 次，不满足 ≥2 次阈值，以 wikilink 形式记录于 Source page）
|
||||
- Concepts created: 无（Agent-Activation-Pattern 仅出现 1 次，不满足 ≥2 次阈值）
|
||||
- Source page: wiki/sources/claude-code-integration.md
|
||||
- Notes: 无内容冲突。slug 冲突解决：原 Aider Integration 已占用 `readme.md`，Claude Code README 同名，故采用 `claude-code-integration.md`。overview.md 无需修订（内容属配置说明，集成概述由 integrations-readme.md 覆盖）。
|
||||
|
||||
## [2026-05-02] ingest | Aider Integration
|
||||
- Source file: Agent/agency-agents/integrations/aider/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
@@ -3303,3 +3384,19 @@
|
||||
- Entities created: [[The-Agency]]（The Agency 多智能体系统组织，147 个 Agent 跨 12 部门）
|
||||
- Source page: wiki/sources/study-abroad-advisor.md
|
||||
- Notes: index.md 中原有 "source missing" 占位条目（2026-04-20）已替换为完整条目；overview.md Specialized 部门新增 Study Abroad Advisor 条目置于 lsp-index-engineer 之后；与 corporate-training-designer 同属服务型 Agent 已在 overview.md 建立关联。4 个 Concept 页面（Holistic-Admissions/UCAS-System/IANG-Visa/Grandes-Ecoles）和 1 个 Entity 页面（The-Agency）创建前均已做去重检查，确认均不存在。
|
||||
|
||||
## [2026-04-26] ingest | Backend Architect with Memory
|
||||
- Source file: Agent/agency-agents/integrations/mcp-memory/backend-architect-with-memory.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: 具备持久记忆能力的后端架构师 AI Agent 设计规范——专注于可扩展系统设计（微服务/Serverless）、数据库架构（PostgreSQL/索引/CQRS）、API 开发（REST/GraphQL/gRPC）与云基础设施。核心价值：MCP Memory 集成实现跨会话记忆召回，防止重复讨论已做决策；架构决策以标签化快照持久化；交付物完成后主动标记接收方供下游 Agent 查找；QA 失败时自动回滚到上一个良好检查点。
|
||||
- Entities created: BackendArchitect（The Agency 工程部门资深后端架构师 Agent，满足 ≥2 次阈值）
|
||||
- Concepts created: 无（MicroservicesArchitecture/CQRS/EventSourcing/ServerlessArchitecture/DatabaseIndexing/CircuitBreaker/DefenseInDepth 均仅出现 1 次，均不满足 ≥2 次阈值，均以 wikilink 形式记录于 Source page）
|
||||
- Source page: wiki/sources/backend-architect-with-memory.md
|
||||
## [2026-04-25] ingest | GitHub Copilot Integration
|
||||
- Source file: Agent/agency-agents/integrations/github-copilot/README.md
|
||||
- Status: ✅ 成功摄入
|
||||
- Summary: The Agency 与 GitHub Copilot 的开箱即用集成——无需转换，`.md` + YAML frontmatter 格式原生兼容。一键安装 `./scripts/install.sh --tool copilot`，或手动复制到 `~/.github/agents/` 或 `~/.copilot/agents/`。用户可在 Copilot 会话中通过名称激活特定 agent。
|
||||
- Concepts created: AgentFileFormat
|
||||
- Entities created: GitHubCopilot
|
||||
- Source page: wiki/sources/github-copilot.md
|
||||
- Notes: 无内容冲突。index.md（Sources + Concepts + Entities）、overview.md（替换 Cursor Integration 段落为 GitHub Copilot Integration）、log.md 均已更新。Concept AgentFileFormat.md 已创建于 wiki/concepts/，Entity GitHubCopilot.md 已创建于 wiki/entities/。
|
||||
|
||||
@@ -9,6 +9,20 @@ The wiki covers two major multi-agent frameworks: **The Agency** (agency-agents)
|
||||
|
||||
**The Agency 贡献指南**（[[contributing_zh-cn]] + [[contributing]] 英文原版）：The Agency 项目贡献者指南——核心贡献方式：①创建全新智能体（8大分类：engineering/design/marketing/product/project-management/testing/support/spatial-computing/specialized）；②优化现有智能体；③分享成功案例；④反馈问题。智能体设计五原则：**鲜明性格**（拒绝通用人设）、**明确交付物**（真实代码/模板）、**可量化指标**、**经过验证的工作流**、**学习记忆机制**。PR 流程包含提交前检查（真实场景测试、遵循模板、补充示例）、社区评审与迭代优化。属 [[Multi-Agent-System-Reliability]] 的智能体设计规范层，为 [[Multi-Agent-Team]] 提供标准化的智能体创建框架。
|
||||
|
||||
**GitHub Copilot Integration**（[[github-copilot]]）：The Agency 与 GitHub Copilot 的开箱即用集成——无需转换，Agency 的 `.md` + YAML frontmatter 格式与 GitHub Copilot 原生兼容。通过 `./scripts/install.sh --tool copilot` 一键安装，或手动复制到 `~/.github/agents/` 或 `~/.copilot/agents/` 目录。用户可在任意 Copilot 会话中通过名称激活特定 agent，如 `"Activate Frontend Developer and help me build a React component."`。与 [[readme|Cursor Integration]] 互补——后者项目级别生效，Copilot Integration 用户级别全局生效，共同构成 [[The Agency]] 的多 IDE 集成生态。
|
||||
|
||||
**Windsurf Integration**（[[windsurf-integration]]）：The Agency Agent roster 与 Windsurf 编辑器的集成方案——通过 `.windsurfrules` 文件将全部 Agent roster 聚合为单一规则文件，install.sh 脚本从项目根目录安装，项目级生效。Windsurf 中在 prompt 里按名称引用 Agent 即可激活（如 "Use the Frontend Developer agent to build this component."）。与 [[Cursor Integration]]（.mdc 规则）和 [[Aider Integration]]（CONVENTIONS.md）同为项目级 IDE 集成，机制相似，共同构成 The Agency 的多 IDE 覆盖体系。[[integrations-readme]] 已覆盖所有 11 种集成工具的概览。
|
||||
|
||||
**Antigravity Integration**（[[antigravity-integration]]）：The Agency Agent roster 与 Antigravity/Gemini 的集成方案——通过 `./scripts/install.sh --tool antigravity` 将全部 Agent roster 转换为 Antigravity SKILL.md 文件，复制到 `~/.gemini/antigravity/skills/` 目录。所有 skill slug 统一使用 `agency-` 前缀（如 `agency-frontend-developer`）以避免与 Antigravity 原生 skills 冲突。用户可通过 `"Use the agency-frontend-developer skill to review this component."` 激活对应 agent。与 [[Cursor Integration]]（.mdc 规则）和 [[Windsurf Integration]]（.windsurfrules）同属多 IDE/平台集成，共同构成 The Agency 的完整集成生态，覆盖 Cursor（VS Code 兼容）、Windsurf、Copilot（用户级）和 Antigravity（Gemini）四大平台。
|
||||
|
||||
**Kimi Code CLI Integration**（[[kimi]]）：The Agency 与 Kimi Code CLI 的集成方案——通过 `./scripts/convert.sh --tool kimi` 将所有 agent 转换为 `agent.yaml`（规范定义）+ `system.md`（系统提示词）的目录结构，再通过 `./scripts/install.sh --tool kimi` 安装到 `~/.config/kimi/agents/`。使用 `--agent-file` 标志激活特定 agent，支持 `extend: default` 继承 Kimi 内置 default agent 的工具集。与 [[readme|Cursor Integration]] 和 [[github-copilot]] 同属 The Agency 的多 IDE/CLI 集成生态，Kimi Code CLI 由 Moonshot AI 出品，与 Claude Code 形成竞争。
|
||||
|
||||
**OpenCode Integration**（[[readme|OpenCode Integration]]）：The Agency Agent roster 与 OpenCode 编辑器的子 Agent 集成方案——通过 `./scripts/install.sh --tool opencode` 安装，将 The Agency 的 .md 文件格式 Agent 转换为 OpenCode 的 `.opencode/agents/` 目录格式。核心机制：在 YAML frontmatter 中添加 `mode: subagent` 使 Agent 仅在 `@agent-name` 触发时出现，不会在 Tab 循环列表中占位；颜色通过命名颜色到十六进制的自动映射实现。支持两种安装范围：项目级（`.opencode/agents/`）和全局级（`~/.config/opencode/agents/`）。与 [[readme|Cursor Integration]]（.mdc 规则）、[[github-copilot]]（用户级 Copilot）、[[windsurf-integration]]（.windsurfrules）同属 The Agency 的多 IDE 集成生态，[[integrations-readme]] 已覆盖所有集成工具概览。
|
||||
|
||||
**MCP Memory Integration**（[[mcp-memory-integration]]）：The Agency 的 MCP Memory 集成方案——通过在 Agent 提示词中加入标准化的 Memory Integration 段落，为任意 Agent 赋予跨会话持久记忆能力，无需修改 Agent 代码。MCP Memory Server 提供四个核心工具：`remember`（存储决策/交付物快照）、`recall`（跨会话检索）、`rollback`（失败时回滚到上一个检查点）、`search`（跨 Agent 搜索记忆）。**Rollback 是杀手级功能**——当 QA 检查失败或架构决策出错时，直接恢复到已知良好状态而非从头重建。标签一致性是关键：每个记忆使用 Agent 名称和项目名称作为标签，确保 recall 可靠。与 [[specialized-mcp-builder]]（构建 MCP Server）和 [[ai-memory-tools-two-camps]]（AI 记忆工具全景分类）同属 The Agency MCP 生态的核心组成部分。
|
||||
|
||||
**Backend Architect with Memory**（[[backend-architect-with-memory]]）：The Agency 中具备持久记忆能力的后端架构师 Agent——专门负责可扩展系统设计、数据库架构、API 开发与云基础设施。核心记忆机制：会话启动时检索 `backend-architect` + 项目名标签的历史记忆，防止重复讨论已做决策；架构决策（选型数据库/定义 API 契约/选择通信模式）以标签化快照持久化；交付物（Schema/API 规范/架构文档）完成后主动标记接收方（如 `frontend-developer` + `api-spec`）供下游 Agent 查找；QA 失败时检索最近良好检查点回滚。作为 [[agents-orchestrator]] 调度的具体执行 Agent，通过 MCP Memory 实现多 Agent 协作中的上下文连续性。
|
||||
|
||||
**[[multi-channel-assistant]]**：基于 [[OpenClaw]] 的多渠道个人助理方案——以 Telegram Topic 路由为统一入口，整合 Google Workspace（gog）、Slack、Todoist、Asana，实现"说一句话完成全套工作"。核心价值：消除应用切换疲劳，AI 主动推送定时提醒（如每周垃圾清理、公司周报）。
|
||||
|
||||
**[[phone-based-personal-assistant]]**：通过 ClawdTalk + Telnyx 将任意手机变成 AI 助理语音入口——拨打电话即可与 [[OpenClaw]] 对话，支持日历查询、Jira 任务更新、网络搜索等技能，无需智能手机 App 或浏览器，覆盖驾驶、步行等双手占用场景。与 [[multi-channel-assistant]] 互补：文字入口覆盖图文交互，语音入口覆盖无屏场景。
|
||||
|
||||
51
wiki/sources/antigravity-integration.md
Normal file
51
wiki/sources/antigravity-integration.md
Normal file
@@ -0,0 +1,51 @@
|
||||
---
|
||||
title: "Antigravity Integration"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-25
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/antigravity/README.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：Agency Agents 与 Antigravity 的集成方案
|
||||
- 问题域：如何在 Antigravity 工具中复用 Agency 团队定义的 Agent 角色
|
||||
- 方法/机制：通过 `install.sh` 脚本将 Agency roster 中的 agent 复制为 Antigravity 技能文件（SKILL.md），所有 agent 统一前缀 `agency-` 以避免命名冲突
|
||||
- 结论/价值：用户可在 Antigravity 中通过激活特定 skill 直接调用专家 agent，实现多角色快速切换
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- Agency agents 可通过 `./scripts/install.sh --tool antigravity` 一键安装为 Antigravity skills
|
||||
- 安装脚本将文件复制到 `~/.gemini/antigravity/skills/` 目录
|
||||
- 所有 skill slug 统一使用 `agency-<agent-name>` 前缀命名（如 `agency-frontend-developer`）
|
||||
- 可通过 `./scripts/convert.sh --tool antigravity` 重新生成 skill 文件（agent 修改后需执行）
|
||||
- Antigravity skill 文件为标准的 SKILL.md 格式，含 YAML frontmatter
|
||||
|
||||
## Key Quotes
|
||||
> "Installs the full Agency roster as Antigravity skills. Each agent is prefixed with `agency-` to avoid conflicts with existing skills." — 核心定位说明
|
||||
|
||||
> "In Antigravity, activate an agent by its slug: Use the agency-frontend-developer skill to review this component." — 使用方式示例
|
||||
|
||||
> "Each skill is a `SKILL.md` file with Antigravity-compatible frontmatter" — 文件格式说明
|
||||
|
||||
## Key Concepts
|
||||
- [[Agency Roster]]：Agency Agents 项目中定义的所有 agent 角色集合，提供完整的技能矩阵
|
||||
- [[Antigravity Skills]]：Antigravity/Gemini 工具的技能扩展机制，通过 SKILL.md 文件定义 agent 行为
|
||||
- [[Skill Prefix Convention]]：通过 `agency-` 前缀隔离 Agency agents 与 Antigravity 原生 skills，避免命名冲突
|
||||
- [[SKILL.md Format]]：技能文件格式，包含 name、description、risk、source、date_added 等标准字段
|
||||
|
||||
## Key Entities
|
||||
- [[Agency Agents]]：提供 AI agent 角色定义的工具集，支持多种 IDE 和平台集成（包括 Antigravity）
|
||||
- [[Antigravity]]（Gemini）：Google 的 AI agent 工具，支持通过 skill 文件扩展 agent 能力
|
||||
|
||||
## Connections
|
||||
- [[Agency Agents]] ← provides agents ← [[Antigravity Integration]]
|
||||
- [[Antigravity]] ← consumes skills from ← [[Agency Agents]]
|
||||
- [[Cursor Integration]] ← alternative integration → [[Antigravity Integration]]（同为 Agency agents 的 IDE 集成路径）
|
||||
|
||||
## Contradictions
|
||||
- 与 [[Cursor Integration]] 存在功能重叠：
|
||||
- 冲突点：两个集成都试图将 Agency agents 集成到不同的 AI 工具中（Cursor IDE vs Antigravity/Gemini）
|
||||
- 当前观点：Antigravity Integration 适合 Gemini/Gemini CLI 用户，覆盖 Gemini 生态
|
||||
- 对方观点：Cursor Integration 适合 GUI 代码编辑器用户，覆盖 VS Code 兼容生态
|
||||
- 结论：两者面向不同工具生态，不存在直接冲突，可共存
|
||||
47
wiki/sources/backend-architect-with-memory.md
Normal file
47
wiki/sources/backend-architect-with-memory.md
Normal file
@@ -0,0 +1,47 @@
|
||||
---
|
||||
title: "Backend Architect with Memory"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-26
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/mcp-memory/backend-architect-with-memory.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：具备持久记忆能力的后端架构师 AI Agent 设计规范，专注于可扩展系统设计、数据库架构、API 开发与云基础设施
|
||||
- 问题域：如何构建一个能够跨会话保留架构决策、系统设计和技术约束记忆的 AI 后端架构专家
|
||||
- 方法/机制：基于 MCP Memory 集成框架，在会话开始时检索相关上下文，完成交付物后主动记忆，跨 Agent 交接时自动传递上下文
|
||||
- 结论/价值：解决多 Agent 协作中重复讨论已做决策、交接信息丢失的问题，提升 AI 架构师的实际工程价值
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- 后端架构师应在会话启动时主动检索项目相关的历史架构决策，防止重复讨论
|
||||
- 架构决策（选型数据库、定义 API 契约、选择通信模式）应以标签形式持久化，供未来会话和其他 Agent 查找
|
||||
- 交付物（Schema、API 规范、架构文档）完成后应主动记忆并标记接收方，确保下游 Agent 无需手动复制粘贴
|
||||
- 遇到 QA 失败或错误决策时，应检索上一个已知良好状态并回滚，而非手动撤销变更链
|
||||
|
||||
## Key Quotes
|
||||
> "When you start a session, recall relevant context from previous sessions. Search for memories tagged with 'backend-architect' and the current project name." — 会话启动时的记忆召回机制
|
||||
> "When you make an architecture decision — choosing a database, defining an API contract, selecting a communication pattern — remember it with tags including 'backend-architect', the project name, and the topic." — 架构决策的持久化规范
|
||||
> "This prevents re-litigating decisions that were already made." — 记忆系统的核心价值
|
||||
|
||||
## Key Concepts
|
||||
- [[MicroservicesArchitecture]]：微服务架构，支持水平扩展和独立部署，是 Backend Architect 默认推荐的架构模式
|
||||
- [[CQRS]]：命令查询职责分离，Backend Architect 在复杂领域驱动设计中的推荐数据模式
|
||||
- [[EventSourcing]]：事件溯源，与 CQRS 配合用于复杂业务域的数据建模
|
||||
- [[ServerlessArchitecture]]：无服务器架构，Backend Architect 认可的可自动扩展且成本效益高的部署方式
|
||||
- [[DatabaseIndexing]]：数据库索引优化，用于实现子 100ms 平均查询性能
|
||||
- [[CircuitBreaker]]：断路器模式，Backend Architect 实现系统可靠性和优雅降级的核心机制
|
||||
- [[DefenseInDepth]]：深度防御策略，Security-First Architecture 的核心原则
|
||||
|
||||
## Key Entities
|
||||
- Backend Architect：主 Agent，专门负责系统架构和服务器端开发，特点：战略思维、安全导向、可扩展性优先、可靠性至上
|
||||
- Frontend Developer：下游接收方 Agent，接收 Backend Architect 提供的 API 规范
|
||||
- QA Agent：质量保障 Agent，在失败时触发记忆回滚机制
|
||||
|
||||
## Connections
|
||||
- [[AgentsOrchestrator]] ← coordinates ← [[BackendArchitectWithMemory]]
|
||||
- [[MCPBuilderAgent]] ← enables ← [[BackendArchitectWithMemory]]（MCP Memory 集成）
|
||||
|
||||
## Contradictions
|
||||
- 无明显冲突内容
|
||||
@@ -24,7 +24,7 @@ date: 2026-05-02
|
||||
> "The Agency was built for Claude Code. No conversion needed — agents work natively with the existing `.md` + YAML frontmatter format." — 核心设计理念，阐明 The Agency 与 Claude Code 的原生兼容性
|
||||
|
||||
## Key Concepts
|
||||
- [[Agent-Activation-Pattern]]：在 Claude Code 中通过名称引用激活预设 Agent 角色的机制
|
||||
- [[Agent-Activation-Pattern]]：在 Claude Code 和 Windsurf 中通过名称引用激活预设 Agent 角色的机制
|
||||
|
||||
## Key Entities
|
||||
- [[Claude-Code]]：Anthropic 官方 AI 编程 CLI 工具，本集成的目标平台
|
||||
|
||||
35
wiki/sources/gemini-cli.md
Normal file
35
wiki/sources/gemini-cli.md
Normal file
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: "Gemini CLI Integration"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-26
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/gemini-cli/README.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：将 61 个 Agency Agents 打包为 Gemini CLI 扩展插件
|
||||
- 问题域：AI Agent 的可移植性与跨工具调用能力
|
||||
- 方法/机制：通过 `./scripts/convert.sh --tool gemini-cli` 生成扩展文件，再通过 `./scripts/install.sh --tool gemini-cli` 安装到 `~/.gemini/extensions/agency-agents/`，安装后可在 Gemini CLI 中按名称激活 Agent skill
|
||||
- 结论/价值：为 Gemini CLI 用户提供即插即用的 61 个专业 Agent，覆盖前端开发、后端架构、现实核查等多个领域
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- Gemini CLI 可通过扩展机制集成 Agency 的全部 61 个 Agent，形成即用型工具包
|
||||
|
||||
## Key Quotes
|
||||
> "Packages all 61 Agency agents as a Gemini CLI extension. The extension installs to `~/.gemini/extensions/agency-agents/`." — 核心价值声明
|
||||
> "Use the frontend-developer skill to help me build this UI." — 在 Gemini CLI 中激活 Agent 的自然语言示例
|
||||
|
||||
## Key Concepts
|
||||
- [[Agent Skill]]：Agent 以 Skill 形式封装，可在 Gemini CLI 中通过自然语言引用激活
|
||||
- [[Extension（扩展机制）]]：Gemini CLI 支持第三方扩展，扩展安装到 `~/.gemini/extensions/` 目录
|
||||
|
||||
## Key Entities
|
||||
- [[Agency Agents]]：提供 61 个预置专业 Agent 的项目
|
||||
|
||||
## Connections
|
||||
- [[agents-orchestrator]] ← extends ← [[gemini-cli]]（通过 Gemini CLI 扩展触发 Agent 编排）
|
||||
|
||||
## Contradictions
|
||||
- （无冲突检测到此文档与现有 Wiki 内容无矛盾）
|
||||
38
wiki/sources/github-copilot.md
Normal file
38
wiki/sources/github-copilot.md
Normal file
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: "GitHub Copilot Integration"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-25
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/github-copilot/README.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：The Agency 项目与 GitHub Copilot 的开箱即用集成方案
|
||||
- 问题域：如何在 GitHub Copilot 环境中使用 Agency 的 agent 定义文件
|
||||
- 方法/机制：通过脚本安装或手动复制 `.md` + YAML frontmatter 格式的 agent 文件到 Copilot 目录
|
||||
- 结论/价值：无需转换，Agency 的 agent 文件格式与 GitHub Copilot 原生兼容，用户可零成本迁移
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- Agency agents 使用 `.md` + YAML frontmatter 格式，无需任何转换即可在 GitHub Copilot 中使用
|
||||
- 通过 `./scripts/install.sh --tool copilot` 可一键将所有 agents 复制到 Copilot agents 目录
|
||||
- 用户可在任何 GitHub Copilot 会话中通过名称激活特定 agent
|
||||
- Agents 按部门（division）组织，具体列表见主 README
|
||||
|
||||
## Key Quotes
|
||||
> "The Agency works with GitHub Copilot out of the box. No conversion needed — agents use the existing `.md` + YAML frontmatter format." — 核心价值主张
|
||||
|
||||
## Key Concepts
|
||||
- [[AgentFileFormat]]：Agent 定义文件采用 `.md` + YAML frontmatter 格式，是 Agency 与 GitHub Copilot 的共同标准
|
||||
|
||||
## Key Entities
|
||||
- [[TheAgency]]：The Agency 开源项目本身，提供多领域专业化 agent 定义
|
||||
- [[GitHubCopilot]]：GitHub Copilot AI 编程助手，支持通过 agent 文件扩展功能
|
||||
|
||||
## Connections
|
||||
- [[GitHubCopilot]] ← integrates_with ← [[TheAgency]]
|
||||
- [[GitHubCopilot]] ← uses_agent_format ← [[AgentFileFormat]]
|
||||
|
||||
## Contradictions
|
||||
（暂无已知冲突）
|
||||
41
wiki/sources/kimi.md
Normal file
41
wiki/sources/kimi.md
Normal file
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: "Kimi Code CLI Integration"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-25
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/kimi/README.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：将 Agency agents 项目转换为 Kimi Code CLI 可用的 agent specification
|
||||
- 问题域：多 agent 工具链集成、agent 规范在不同 CLI 平台间的迁移
|
||||
- 方法/机制：通过 `convert.sh` 和 `install.sh` 脚本，将每个 agent 转换为包含 `agent.yaml` 和 `system.md` 的目录结构；安装到 `~/.config/kimi/agents/`
|
||||
- 结论/价值：提供了一套将 agency-agents 项目的 agent 定义无缝迁移到 Kimi Code CLI 的完整工作流
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- Kimi Code CLI 通过 `agent.yaml` + `system.md` 文件定义 agent，支持 `--agent-file` 标志激活
|
||||
- agent 规范支持继承机制（`extend: default`），可复用 Kimi 内置 default agent 的工具集
|
||||
- 源文件修改后需重新运行 `convert.sh` + `install.sh` 完成同步
|
||||
|
||||
## Key Quotes
|
||||
> "Converts all Agency agents into Kimi Code CLI agent specifications. Each agent becomes a directory containing `agent.yaml` (agent spec) and `system.md` (system prompt)." — 项目概述
|
||||
> "Install agents: `./scripts/install.sh --tool kimi` — This copies agents to `~/.config/kimi/agents/`." — 安装机制
|
||||
|
||||
## Key Concepts
|
||||
- [[YAML配置文件]]: `agent.yaml` 是 agent 的规范定义文件，包含 name、version、继承关系和工具列表
|
||||
- [[Agent规范]]: Agent specification，指用 YAML 格式描述的 agent 元数据（工具集、子 agent、扩展关系等）
|
||||
- [[SystemPrompt]]: `system.md` 文件包含 agent 的系统提示词、个性和指令
|
||||
|
||||
## Key Entities
|
||||
- [[Kimi Code CLI]]: Moonshot AI 出品的命令行 agent 工具，通过 `--agent-file` 加载自定义 agent 规范
|
||||
- [[Moonshot AI]]: Kimi 背后的公司，提供 Kimi Code CLI 产品
|
||||
- [[Agency Agents]]: 本源文件的母项目，提供跨平台 agent 集成框架
|
||||
|
||||
## Connections
|
||||
- [[Cursor Integration]] ← similar_approach ← [[Kimi Code CLI Integration]]: 两者都旨在将 agency-agents 转换为各自的 IDE/CLI 工具规范
|
||||
- [[Claude Code]] ← competes_with ← [[Kimi Code CLI Integration]]: 两者都是 AI 编程 CLI 工具，存在工具生态竞争
|
||||
|
||||
## Contradictions
|
||||
- 无已知冲突
|
||||
53
wiki/sources/mcp-memory-integration.md
Normal file
53
wiki/sources/mcp-memory-integration.md
Normal file
@@ -0,0 +1,53 @@
|
||||
---
|
||||
title: "MCP Memory Integration"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-05-02
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/mcp-memory/README.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：通过 MCP（Model Context Protocol）为 The Agency 中的任意 AI Agent 添加跨会话持久记忆能力
|
||||
- 问题域：Agent 默认每次会话从零开始，缺乏记忆；多 Agent 间交接依赖手动 copy-paste，无法自动延续上下文
|
||||
- 方法/机制：在 Agent 提示词中加入 Memory Integration 指令段，Agent 自动调用 MCP 内存工具（remember/recall/rollback/search）；MCP Server 由外部提供，配置在 Claude Code/Cursor 等 MCP Client 中
|
||||
- 结论/价值：无需修改 Agent 代码，只需在 prompt 中加入标准化的 Memory Integration 段落，即可实现跨会话记忆、交接延续和失败回滚；Rollback 是核心杀手级功能
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- Agent 默认每次会话从零开始，缺乏上下文延续能力
|
||||
- MCP Memory Server 提供 remember、recall、rollback、search 四个核心工具
|
||||
- 只需在 Agent prompt 中加入 Memory Integration 段落，即可为任意 Agent 赋予持久记忆
|
||||
- Rollback 是 MCP Memory 的杀手级功能：当 QA 检查失败或架构决策出错时，回滚到上一个已知良好状态，而非从头重建
|
||||
- 标签一致性是关键：每次记忆都使用 Agent 名称和项目名称作为标签，确保 recall 可靠
|
||||
- 无需修改 Agent 代码，无需编写 API 调用，MCP 工具处理所有持久化逻辑
|
||||
|
||||
## Key Quotes
|
||||
> "Give any agent persistent memory across sessions using the Model Context Protocol (MCP)." — MCP Memory Integration 的设计目标
|
||||
> "Rollback is the killer feature: When a Reality Checker fails a deliverable, the original agent can roll back to its last checkpoint instead of trying to manually undo changes." — Rollback 作为关键恢复机制的定位
|
||||
> "No code changes to the agent files. No API calls to write. The MCP tools handle everything." — 零侵入性的集成方式
|
||||
|
||||
## Key Concepts
|
||||
- [[Cross-Session-Memory]]：跨会话记忆能力，Agent 在新会话中能自动检索并恢复上一次的决策和上下文
|
||||
- [[Handoff-Continuity]]：多 Agent 交接延续性，一个 Agent 完成任务后交接给下一个 Agent，后者能通过 MCP Memory 自动获取前者的交付物和待办，无需手动 copy-paste
|
||||
- [[Rollback]]：失败回滚机制，当 QA 检查失败或架构决策出错时，恢复到上一个已知良好状态
|
||||
- [[Memory-Integration-Pattern]]：Memory Integration 段落——在 Agent prompt 中加入标准化指令，指导 Agent 在关键时机调用 MCP 内存工具（remember/recall/rollback/search）
|
||||
- [[MCP-Memory-Tools]]：MCP Memory Server 提供的四个核心工具——remember（存储记忆）、recall（检索记忆）、rollback（回滚状态）、search（跨 Agent 搜索记忆）
|
||||
- [[Checkpoint]]：检查点，Agent 在完成关键决策或交付物时存储的快照状态，供后续 rollback 使用
|
||||
|
||||
## Key Entities
|
||||
- [[The-Agency]]：The Agency 多智能体编码框架，MCP Memory Integration 的应用目标
|
||||
- [[MCP]]：Model Context Protocol，MCP Memory Integration 的底层协议，定义了 remember/recall/rollback/search 等内存工具的接口规范
|
||||
- [[Backend-Architect]]：后端架构师 Agent，MCP Memory Integration 的具体应用示例（见 backend-architect-with-memory.md）
|
||||
- [[Startup-MVP-Workflow]]：创业 MVP 工作流，MCP Memory Integration 的完整工作流示例（见 workflow-with-memory.md）
|
||||
|
||||
## Connections
|
||||
- [[The-Agency]] ← enables ← [[Memory-Integration-Pattern]]
|
||||
- [[MCP]] ← provides_tools_for ← [[Cross-Session-Memory]]
|
||||
- [[MCP]] ← provides_tools_for ← [[Rollback]]
|
||||
- [[Backend-Architect]] ← enhanced_by ← [[MCP-Memory-Integration]]
|
||||
- [[Startup-MVP-Workflow]] ← enhanced_by ← [[MCP-Memory-Integration]]
|
||||
- [[Memory-Integration-Pattern]] ← uses ← [[MCP-Memory-Tools]]
|
||||
|
||||
## Contradictions
|
||||
- 无已知内容冲突
|
||||
47
wiki/sources/openclaw-integration.md
Normal file
47
wiki/sources/openclaw-integration.md
Normal file
@@ -0,0 +1,47 @@
|
||||
---
|
||||
title: "OpenClaw Integration"
|
||||
type: source
|
||||
tags: [OpenClaw, The-Agency, Integration]
|
||||
date: 2026-05-03
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/openclaw/README.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：The Agency Agent 资产与 OpenClaw 多智能体框架的集成方案
|
||||
- 问题域：如何将 The Agency 的 .md 格式 Agent 角色转换为 OpenClaw workspace 并安装激活
|
||||
- 方法/机制：① `convert.sh --tool openclaw` 将 Agent 转换为 OpenClaw workspace；② `install.sh --tool openclaw` 将 workspace 复制到 `~/.openclaw/agency-agents/`；③ `openclaw gateway restart` 重启网关使 Agent 可用
|
||||
- 结论/价值：The Agency 的 Agent 资产通过 OpenClaw 的 workspace 机制获得持久记忆、n8n 工作流编排和多渠道接入能力
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- OpenClaw agents 以 workspace 形式安装，包含 `SOUL.md`、`AGENTS.md` 和 `IDENTITY.md` 文件
|
||||
- `convert.sh --tool openclaw` 脚本将 The Agency 的 Agent 配置转换为 OpenClaw workspace 格式
|
||||
- `install.sh --tool openclaw` 将 workspace 复制到 `~/.openclaw/agency-agents/` 并自动注册
|
||||
- 安装后 agents 通过 OpenClaw gateway 的 `agentId` 对外暴露
|
||||
- Gateway 运行状态下安装后需执行 `openclaw gateway restart` 使新 Agent 生效
|
||||
|
||||
## Key Quotes
|
||||
> "OpenClaw agents are installed as workspaces containing `SOUL.md`, `AGENTS.md`, and `IDENTITY.md` files" — OpenClaw workspace 核心组件定义
|
||||
> "The installer copies each workspace into `~/.openclaw/agency-agents/` and registers it when the `openclaw` CLI is available" — 安装路径与注册机制
|
||||
> "If the OpenClaw gateway is already running, restart it after installation" — Gateway 热加载要求
|
||||
|
||||
## Key Concepts
|
||||
- [[OpenClaw-Workspace]]：OpenClaw agent 的工作空间目录，包含 SOUL.md（性格）、AGENTS.md（职责）、IDENTITY.md（身份元数据）等配置文件
|
||||
- [[Workspace-Based-Agent]]：基于 workspace 目录架构的 Agent 部署模式，与 [[The-Agency]] 原生的 `.md + YAML frontmatter` 格式不同
|
||||
- [[Agent-Conversion]]：通过 `convert.sh` 脚本将 The Agency Agent 转换为目标工具可识别格式的过程
|
||||
|
||||
## Key Entities
|
||||
- [[The-Agency]]：The Agency 多智能体编码框架，提供 147+ Agent 角色
|
||||
- [[OpenClaw]]：开源自主 Agent 框架，专注持久记忆与工作流编排
|
||||
- [[OpenClaw-Gateway]]：OpenClaw 的网关服务，通过 `agentId` 暴露 Agent 能力
|
||||
|
||||
## Connections
|
||||
- [[The-Agency]] ← converts_agents_to ← [[OpenClaw-Workspace]]（通过 `convert.sh`）
|
||||
- [[OpenClaw-Workspace]] ← installs_to ← `~/.openclaw/agency-agents/`（通过 `install.sh`）
|
||||
- [[OpenClaw]] ← serves ← [[OpenClaw-Gateway]]
|
||||
- [[openclaw-integration]] ← part_of ← [[integrations-readme]]（The Agency 11 种集成之一）
|
||||
- [[openclaw-integration]] ← related_to ← [[claude-code-integration]]（同为 The Agency 集成方案）
|
||||
|
||||
## Contradictions
|
||||
- 无已知内容冲突
|
||||
@@ -1,42 +1,40 @@
|
||||
---
|
||||
title: "Aider Integration"
|
||||
title: "OpenCode Integration"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-05-02
|
||||
date: 2026-04-26
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/aider/README.md]]
|
||||
- [[Agent/agency-agents/integrations/opencode/README.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：Aider 编辑器集成 The Agency Agent 资产的安装与使用指南
|
||||
- 问题域：如何在 Aider 项目中激活并调用 The Agency 的多智能体 Agent 角色
|
||||
- 方法/机制：通过 `install.sh --tool aider` 安装，将 Agent 配置注入 Aider 项目；Aider 自动读取项目根目录下的 `CONVENTIONS.md` 文件以激活 Agent 角色
|
||||
- 结论/价值：The Agency 的 Agent 资产可通过 CONVENTIONS.md 机制无缝集成到 Aider 工作流中，实现项目级的多智能体编码辅助
|
||||
- 核心主题：OpenCode 的子 Agent 集成机制——如何将 .md 文件格式的 Agent 转换为 OpenCode 可调用的子代理
|
||||
- 问题域：OpenCode IDE 中的多 Agent 协作与按需调用
|
||||
- 方法/机制：通过 YAML frontmatter 中的 `mode: subagent` 标记，将具名 Agent 从 Tab 循环列表中分离，改为按需 `@agent-name` 调用；颜色通过命名颜色到十六进制的自动映射实现
|
||||
- 结论/价值：提供了一种轻量级、无需修改主 Agent 系统的子 Agent 扩展方案，支持项目级和全局级两种安装范围
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- Aider 会自动检测并读取项目根目录中的 `CONVENTIONS.md` 文件
|
||||
- 安装脚本 `install.sh --tool aider` 将 The Agency 的 Agent 配置转换为 Aider 可识别的格式
|
||||
- 用户可通过 `convert.sh --tool aider` 重新生成配置文件
|
||||
- 在 Aider 会话中直接通过名称引用 Agent（如 "Frontend Developer"）
|
||||
- OpenCode Agent 通过在 `.opencode/agents/` 目录存储 .md 文件（带 YAML frontmatter）实现——文件格式与 The Agency 的 Agent 定义格式兼容
|
||||
- `mode: subagent` 配置使 Agent 仅在 `@agent-name` 触发时出现，不会在 Tab 循环列表中占位——保持主 Agent 列表的简洁性
|
||||
- 命名颜色（如 `cyan`）在安装脚本中被自动转换为十六进制颜色代码——无需手动查表
|
||||
- Agent 支持两种安装范围：项目级（`.opencode/agents/`）和全局级（`~/.config/opencode/agents/`）——通过不同路径实现作用域隔离
|
||||
- 转换脚本 `./scripts/convert.sh --tool opencode` 负责将 The Agency 的标准 Agent 文件转换为 OpenCode 兼容格式
|
||||
|
||||
## Key Quotes
|
||||
> "The full Agency roster is consolidated into a single `CONVENTIONS.md` file" — 所有 Agent 角色汇总在单一的 CONVENTIONS.md 文件中
|
||||
> "Aider reads this file automatically when it's present in your project root" — Aider 自动读取项目根目录的 CONVENTIONS.md
|
||||
> "Use the Frontend Developer agent to refactor this component" — Aider 会话中按名称调用 Agent
|
||||
> "mode: subagent — agent is available on-demand, not shown in the primary Tab-cycle list"
|
||||
> — Agent YAML frontmatter 的核心语义，说明 subagent 模式与普通 agent 的本质区别
|
||||
|
||||
## Key Concepts
|
||||
- [[CONVENTIONS.md]]：The Agency Agent 角色配置文件，Aider 自动读取
|
||||
- [[Project-Scoped-Integration]]：项目级工具集成模式（需在项目根目录安装）
|
||||
- [[Agent-Activation]]：Agent 激活机制，通过名称引用在对话中调用
|
||||
- [[Subagent]]：按需调用的辅助 Agent，通过 `@agent-name` 语法触发，不参与 Tab 循环
|
||||
- [[OpenCode]]：一个支持多 Agent 协作的 IDE/编辑器扩展平台
|
||||
|
||||
## Key Entities
|
||||
- [[Aider]]：Aider CLI 编码工具，AI 结对编程编辑器
|
||||
- [[The-Agency]]：The Agency 多智能体编码框架（147+ Agent 角色）
|
||||
- [[The Agency]]：OpenCode Agent 的来源框架，提供 147 个专业化 Agent 定义
|
||||
|
||||
## Connections
|
||||
- [[The-Agency]] ← provides_agents_to ← [[Aider]]
|
||||
- [[Aider]] ← reads ← [[CONVENTIONS.md]]
|
||||
- [[contributing]] ← 贡献来源 ← [[Agent/agency-agents/integrations/opencode/README.md]]
|
||||
- [[The Agency]] ← Agent 定义来源 ← [[Agent/agency-agents/integrations/opencode/README.md]]
|
||||
|
||||
## Contradictions
|
||||
- 无已知内容冲突
|
||||
- （未检测到与其他页面的明显冲突）
|
||||
|
||||
45
wiki/sources/windsurf-integration.md
Normal file
45
wiki/sources/windsurf-integration.md
Normal file
@@ -0,0 +1,45 @@
|
||||
---
|
||||
title: "Windsurf Integration"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-25
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[Agent/agency-agents/integrations/windsurf/README.md]]
|
||||
|
||||
## Summary（用中文描述）
|
||||
- 核心主题：The Agency Agent 与 Windsurf 编辑器的集成方案
|
||||
- 问题域：如何在 Windsurf IDE 中使用 The Agency 的 Agent 角色
|
||||
- 方法/机制：通过 `.windsurfrules` 文件将 Agent roster 注入 Windsurf，项目级别生效；在 prompt 中按名称引用 Agent 激活使用；install.sh 安装脚本一键部署，convert.sh 重新生成规则文件
|
||||
- 结论/价值：项目级生效的 IDE 集成方案，与 [[Cursor Integration]]（项目级 .mdc）和 [[Aider Integration]]（项目级 CONVENTIONS.md）互补，共同构成 The Agency 的多 IDE 覆盖体系
|
||||
|
||||
## Key Claims（用中文描述）
|
||||
- `.windsurfrules` 文件将 The Agency 全部 Agent roster 合并为单一规则文件
|
||||
- Windsurf 集成是项目级别生效（project-scoped），需在项目根目录安装
|
||||
- Agent 通过在 prompt 中按名称引用激活（如 "Use the Frontend Developer agent..."）
|
||||
- 规则文件可通过 convert.sh 重新生成
|
||||
|
||||
## Key Quotes
|
||||
> "The full Agency roster is consolidated into a single `.windsurfrules` file." — 单一规则文件聚合全部 Agent roster
|
||||
> "Rules are **project-scoped** — install them from your project root." — 项目级别生效机制
|
||||
> "In Windsurf, reference an agent by name in your prompt" — 按名称引用激活 Agent
|
||||
|
||||
## Key Concepts
|
||||
- [[Agent-Activation-Pattern]]：通过在 prompt 中按名称引用来激活 Agent（"Use the Frontend Developer agent to build this component."），在 [[windsurf-integration]] 和 [[claude-code-integration]] 中均有应用
|
||||
- [[Project-Scoped-Tools]]：工具集成生效范围为项目级别（OpenCode/Cursor/Aider/Windsurf/Qwen Code），区别于全局安装的工具（Claude Code/GitHub Copilot）；需在项目根目录安装
|
||||
|
||||
## Key Entities
|
||||
- [[The-Agency]]：多智能体编码系统组织，本次 Windsurf 集成的 Agent 来源
|
||||
- [[Windsurf]]：Codeium 开发的 AI 代码编辑器，支持通过 .windsurfrules 注入自定义规则
|
||||
|
||||
## Connections
|
||||
- [[integrations-readme]] ← part_of ← [[Windsurf Integration]]（集成生态的一员）
|
||||
- [[Cursor Integration]] ← similar_pattern ← [[Windsurf Integration]]（同为项目级 IDE 集成，机制相似）
|
||||
- [[Aider Integration]] ← similar_pattern ← [[Windsurf Integration]]（同为项目级 Agent 注入方案）
|
||||
|
||||
## Contradictions
|
||||
- 与 [[integrations-readme]] 存在潜在冲突：
|
||||
- 冲突点：integrations-readme.md 描述 Windsurf 为"项目级别集成"（Project-Scoped），本文档同样确认项目级别
|
||||
- 当前观点：项目级别是正确描述——install.sh 复制到项目根目录而非全局
|
||||
- 对方观点：无冲突，两者一致
|
||||
Reference in New Issue
Block a user