agency

<div align="center">  # AI 代理机构 ### *您在高层阁楼工作室的虚拟开发团队* [](.) [](LICENSE) [](mcp.example.json) **企业级的一致性。零劳动成本。没有白色背景。** [快速开始](#-快速开始) | [代理团队](#-代理团队) | [配置](#-配置) | [文档](#-文档) </div> --- ## 这是什么？ **AI 代理机构** 是一个组织 AI 辅助开发的框架，围绕 **专业的代理角色** 进行组织。您不是构建一个通用的 AI 助手，而是构建一个专家团队 - 每个专家都有明确的角色、独特的个性、文件所有权和自动审计协议。 将其视为人员配备虚拟游戏工作室，每个代理在您的顶层套房都有办公桌，并且 *从不* 批准白色背景。 ### 为什么是代理角色？ | 传统 AI 使用 | 代理机构方法 | |:-------------------|:---------------------| | 一个助手处理所有事情 | 每个领域都有专门的专家 | | 上下文重置每个对话 | 持久的协议和标准 | | 临时质量检查 | 自动每周审计 | | 不明确的责任 | 明确的文件所有权 | | 不一致的执行 | 编码规则，带有红色标记 | --- ## 5 个核心审计领域 在构建自定义团队之前，从涵盖 90% 的重复问题的 5 个类别开始： | # | 审计领域 | 检查内容 | 启动代理 | |:--|:-----------|:----------------|:--------------| | 1 | **主题和设计令牌** | 硬编码十六进制，缺少 CSS 变量，暗/亮模式不一致，WCAG 对比度 | StyleGuard | | 2 | **布局和 UX** | 损坏的断点，间距不一致，缺少响应式规则，视觉层次结构偏移 | LayoutArchitect | | 3 | **内容质量** | 不一致的格式，缺少元数据，损坏的结构，过时的副本 | ContentEditor | | 4 | **媒体和资产** | 未优化的图像，错误的纵横比，缺少延迟加载，损坏的嵌入 | AssetManager | | 5 | **SEO 和性能** | 缺少的 JSON-LD，不好的 og:image，PageSpeed 回归，未爬取的页面 | MetricsGuard | 参见 `templates/AGENT-TEMPLATE.md` 和 `mcp.example.json` 以围绕这些领域构建您自己的团队。 --- ## 展示团队（JenniNexus 工作室） `agents/` 目录包含一个来自真实生产工作室的完整示例团队。使用这些作为灵感 - 他们的个人资料、审计检查清单和红色标记是您的示例。 > 这些是项目启发的示例代理，适用于公共示例。优秀的参考资料，但不能直接使用。从 `mcp.example.json` 和 `templates/AGENT-TEMPLATE.md` 开始。 <table> <tr> <td align="center" width="130"> <img src="resources/images/agents/vidette-1x1.webp" width="80" height="80" alt="Vidette" onerror="this.style.display='none'"/><br/> <b><a href="agents/Vidette.md">Vidette</a></b><br/> _{视频和图像显示}<br/> _{📅 星期一 · 🎨 <code>#66c0f4</code>}<br/> _{<i>"如果不是 16:9，就不是正确的。"</i>} </td> <td align="center" width="130"> <img src="resources/images/agents/bloggie-1x1.webp" width="80" height="80" alt="Bloggie" onerror="this.style.display='none'"/><br/> <b><a href="agents/Bloggie.md">Bloggie</a></b><br/> _{博客和内容质量}<br/> _{📅 星期二 · 🎨 <code>#FFB020</code>}<br/> _{<i>"结构是给予读者的善意。"</i>} </td> <td align="center" width="130"> <img src="resources/images/agents/graphviz-1x1.webp" width="80" height="80" alt="GraphViz" onerror="this.style.display='none'"/><br/> <b><a href="agents/GraphViz.md">GraphViz</a></b><br/> _{主题和视觉协调}<br/> _{📅 星期三 · 🎨 <code>#A563D1</code>}<br/> _{<i>"投资者不为白色背景付费。"</i>} </td> <td align="center" width="130"> <img src="resources/images/agents/divinedesign-1x1.webp" width="80" height="80" alt="DivineDesign" onerror="this.style.display='none'"/><br/> <b><a href="agents/DivineDesign.md">DivineDesign</a></b><br/> _{布局和架构}<br/> _{📅 星期五 · 🎨 <code>#00D4AA</code>}<br/> _{<i>"间距不是装饰，而是结构。"</i>} </td> </tr> <tr> <td align="center" width="130"> <img src="resources/images/agents/metrica-1x1.webp" width="80" height="80" alt="Metrica" onerror="this.style.display='none'"/><br/> <b><a href="agents/Metrica.md">Metrica</a></b><br/> _{SEO、分析和性能}<br/> _{📅 星期六 · 🎨 <code>#39ff14</code>}<br/> _{<i>"如果没有索引，就不存在。"</i>} </td> <td align="center" width="130"> <img src="resources/images/agents/vixel-1x1.webp" width="80" height="80" alt="Vixel" onerror="this.style.display='none'"/><br/> <b><a href="agents/Vixel.md">Vixel</a></b><br/> _{VR/游戏项目站点}<br/> _{📅 星期日 · 🎨 <code>#FF6B4A</code>}<br/> _{<i>"像素不会撒谎。修复混合器。</i>} </td> <td align="center" width="130"> _{<br/><b>+ 您的代理</b><br/>复制模板，<br/>定义您的领域} </td> <td></td> </tr> </table> > **星期五下午：** 实施日 - 所有代理合作解决标记的问题。 > 肖像图片放在 `resources/images/agents/<name>.jpg`（80×80 正方形）。参见 [`docs/ART-STYLE.md`](docs/ART-STYLE.md) 以获取生成约定。 查看 [`agents/`](agents/) 中的单个代理文件以获取完整的个人资料、验证检查清单和红色标记。 --- ## 快速开始 ### 1. 克隆和配置 ```bash git clone https://github.com/jenninexus/agency.git cd agency cp mcp.example.json mcp.json cp .vscode/mcp.example.json .vscode/mcp.json # 编辑 mcp.json - 更新工作室名称、代理域、文件路径。 # 保持 mcp.json 本地；它被 gitignored 以防止推送个人 MCP/项目路径。 ``` ### 2. 创建您的第一个代理 ```bash cp templates/AGENT-TEMPLATE.md agents/YourAgent.md ``` ### 3. 在 AI 对话中引用 ``` @GraphViz.md - 检查此 CSS 是否符合主题要求 @Bloggie.md - 检查此博客帖子结构 @DivineDesign.md - 审计页面布局和 UX ``` ### 4. 打开工作区 复制工作区模板并在 VS Code 中打开： ```bash cp agency.example.code-workspace agency.code-workspace ``` 打开 `agency.code-workspace` 以获得完整的顶层工作室体验。 ### 5. 启用背景图像（可选） 工作区包括用于显示代理艺术作品的 `shalldie.background` 扩展的设置。 1. 安装推荐的扩展时提示（或搜索 `shalldie.background`） 2. 更新工作区文件中的图像 URL： ```json "background.customImages": [ "https://raw.githubusercontent.com/jenninexus/agency/main/resources/images/banner.jpg" ] ``` 或使用本地路径：`file:///path/to/agency/resources/images/banner.jpg` 3. 重新加载 VS Code - 您可能会看到“损坏”的警告（这是正常的，点击“不再显示”） 4. 在 `resources/images/` 中添加更多代理图像以进行幻灯循环 - 扩展程序每 30 秒循环一次 --- ## 配置 所有代理元数据、计划和协调规则都存储在从公共模板复制的本地注册表中： | 文件 | 目的 | |:-----|:--------| | [`mcp.example.json`](mcp.example.json) | 公共净化代理注册表模板（跟踪） | | `mcp.json` | 本地项目注册表（gitignored，复制自 `mcp.example.json`） | | [`.vscode/mcp.example.json`](.vscode/mcp.example.json) | VS Code MCP 服务器入口模板（跟踪） | | `.vscode/mcp.json` | 本地 VS Code MCP 服务器入口（gitignored） | ### 公共 vs 本地配置 - 跟踪 `mcp.example.json` 仅当数据是通用、净化且对其他项目有用的时。 - 将 `mcp.json` 保留本地以存储个人路径、私有 MCP 服务器、项目名称、审计输出和每个项目的团队。 - 跟踪 `.vscode/mcp.example.json` 仅作为最小服务器存根。 - 将 `.vscode/mcp.json` 保留本地，因为 MCP 主机通常需要特定于机器的路径或环境变量。 - 将项目特定的代理和覆盖项放在 `projects/<project-name>/` 中；该目录默认被 gitignored。 ### 普遍规则（不可协商） 1. **无白色背景** - 浅色模式使用薰衣草 `#F9F3FB` 2. **CSS 变量优于十六进制** - 始终主题感知 3. **无内联样式** - 所有样式通过 CSS 类 4. **测试两种主题** - 浅色和深色模式验证 5. **记录更改** - 更新代理更改日志 ### 颜色规则 | 上下文 | 允许 | 禁止 | |:--------|:--------|:-------| | 浅色背景 | `#F9F3FB` | `#FFFFFF`, `#FAFAFA`, `#F8F9FA`, `#F7F7F7` | | 深色背景 | `#121218` | 纯黑色 `#000000` | --- ## 项目结构 ``` agency/ ├── README.md # 你在这里 ├── package.json # npm 运行 mcp 便捷脚本 ├── mcp.example.json # 公共代理注册表模板（复制到 mcp.json） ├── mcp.json # 填充的本地注册表（gitignored） ├── .env.example # 环境变量模板 ├── agency.example.code-workspace # VS Code 工作区（复制到 agency.code-workspace） │ ├── .github/ │ └── copilot-instructions.md # 自动加载 GitHub Copilot │ ├── .vscode/ │ ├── mcp.example.json # VS Code MCP 服务器仅入口（复制到 .vscode/mcp.json） │ └── settings.example.json # 工作区默认值模板（复制到 settings.json，gitignored） │ ├── agents/ # 展示代理配置文件（公共示例） │ ├── characters.yaml # AI 图像生成提示（gitignored） │ ├── Vidette.md # 视频和媒体专家 │ ├── Bloggie.md # 博客和内容专家 │ ├── GraphViz.md # 主题和视觉专家 │ ├── DivineDesign.md # 布局和架构专家 │ ├── Metrica.md # SEO、分析和性能专家 │ └── Vixel.md # VR/游戏站点专家（跨项目） │ ├── projects/ # 项目特定代理团队（仅本地） │ └── README.md # projects/ 工作方式 - 子目录默认被 gitignored │ ├── resources/ # 代理媒体资产 │ ├── images/ │ │ ├── banner.jpg # README 页头横幅 │ │ └── agents/ # 方形肖像用于 README 卡片（80×80） │ │ └── <name>.jpg # vidette.jpg, bloggie.jpg, etc. │ └── video/ │ └── .gitkeep │ ├── docs/ # 框架文档 │ ├── ART-STYLE.md # 共享美学 + 每个代理的视觉身份 │ ├── AGENT-GUIDE.md # 角色创建指南，具有视觉设计系统 │ ├── SCHEDULE.md # 每周审计时间表模板 │ ├── WORKFLOW.md # 编辑 + MCP + 子模块同步指南 │ └── OPTIMIZATION-IDEAS.md # IDE/工作流集成策略 │ ├── templates/ │ └── AGENT-TEMPLATE.md # 空白代理配置文件模板 │ ├── examples/ │ ├── StyleGuard.md # 完整的工作示例代理 │ └── AgentRoster.md # 示例团队文档（JenniNexus 7 代理工作室） │ ├── scripts/ # 审计自动化 + MCP 服务器 │ ├── mcp-server.js # MCP stdio 服务器（零依赖，Node 18+） │ ├── _audit-common.ps1 # 共享审计实用程序 │ └── audit-template.ps1 # 审计脚本模板 │ └── audits/ # 生成的审计报告（gitignored） └── .gitkeep ``` --- ## 文档 | 文档 | 描述 | |:---------|:------------| | [`docs/ART-STYLE.md`](docs/ART-STYLE.md) | 共享工作室美学，每个代理的颜色，肖像生成约定 | | [`docs/AGENT-GUIDE.md`](docs/AGENT-GUIDE.md) | 角色创建指南，具有视觉设计系统 | | [`docs/SCHEDULE.md`](docs/SCHEDULE.md) | 每周审计时间表和跨代理协调 | | [`docs/OPTIMIZATION-IDEAS.md`](docs/OPTIMIZATION-IDEAS.md) | VS Code、Claude Code 和工作流集成策略 | | [`templates/AGENT-TEMPLATE.md`](templates/AGENT-TEMPLATE.md) | 完整的代理配置文件模板（200+ 行） | | [`examples/StyleGuard.md`](examples/StyleGuard.md) | 完整的工作示例代理 | | [`examples/AgentRoster.md`](examples/AgentRoster.md) | 示例团队文档（JenniNexus 7 代理工作室） | | [`docs/PUBLIC-LOCAL-SPLIT.md`](docs/PUBLIC-LOCAL-SPLIT.md) | 双层模式：公共框架代理与项目特定覆盖 | ### 肖像生成 代理肖像通过 AI 图像 API 生成（xAI Grok Imagine, DALL-E, Midjourney）。将 80×80 正方形肖像放在 `resources/images/agents/<name>.jpg` 以填充展示卡片。 参见 [`docs/ART-STYLE.md`](docs/ART-STYLE.md) 以获取共享美学，每个代理的强调色和提示约定。完整提示位于 `agents/characters.yaml`（仅本地 - gitignored）。 --- ## 代理通信协议 ### 代码注释 ```javascript // @GRAPHVIZ: 需要主题合规 - 无白色背景 // @VIDETTE: 视频网格需要 16:9 宽高比强制执行 // @GAMERGIRL: 游戏页面需要带有平台 CTAs 的英雄部分 ``` ### 提交消息 ```bash git commit -m "[GRAPHVIZ] 更新暗模式玻璃效果" git commit -m "[BLOGGIE] 修复标签系统以使用锚标签" ``` ### 跨引用 当多个代理合作时，在本地 `mcp.json` 中使用协调矩阵来识别依赖关系。 --- ## 高级集成 ### VS Code 任务 ```json { "label": "运行 GraphViz 审计", "type": "shell", "command": "powershell -File scripts/audit-styles.ps1" } ``` ### GitHub Actions ```yaml on: schedule: - cron: '0 9 * * 1' # 星期一 9 点 - Vidette 的审计日 jobs: audit: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: ./scripts/audit-video-pages.sh ``` ### MCP 集成（Claude Code, Cursor, Zed, Cline） 复制公共示例，然后启动服务器： ```bash cp mcp.example.json mcp.json cp .vscode/mcp.example.json .vscode/mcp.json ``` ```bash node scripts/mcp-server.js # 或：npm run mcp ``` 工具可用：`agency_list_agents`, `agency_get_agent`, `agency_get_agent_for_file`, `agency_get_schedule`, `agency_get_rules`. ### GitHub Copilot `.github/copilot-instructions.md` 由 Copilot 自动加载 - 无需服务器。代理规则、文件所有权和红色标记作为上下文注入。 ### Claude Code 集成 **CLAUDE.md 集成：** 将代理引用添加到项目的 `CLAUDE.md` 以获取自动上下文： ```markdown ## 代理团队 - 5 个 AI 代理涵盖主题、布局、内容、资产和 SEO - 代理配置文件：`agents/*.md` - 代理注册表：`mcp.json`（复制自 `mcp.example.json`，gitignored） - MCP 服务器配置：`.vscode/mcp.json`（复制自 `.vscode/mcp.example.json`，gitignored） - 审计脚本：`scripts/audit-*.ps1` - 审计结果：`audits/AUDIT_*.md` ``` **Claude Code 技能（斜线命令）：** 在 `.claude/commands/` 中创建自定义技能用于代理操作： ``` .claude/commands/ ├── agent-supervisor.md # 完整审计 + 健康仪表盘 ├── agent-audit.md # 快速运行特定代理审计 └── agent-status.md # 状态检查，无审计运行 ``` **直接代理调用：** ``` Read @GraphViz.md and audit src/styles/ for theme compliance Run the Wednesday audit checklist from @GraphViz.md @Vidette.md audit the video pages for duplicate script loads ``` **环境变量：** 复制 `.env.example` 到 `.env` 并为您的项目配置路径： ```bash cp .env.example .env # 编辑 .env 以适应您的项目路径 ``` 审计脚本通过 `_audit-common.ps1` 自动使用这些路径。 --- ## 作为子模块使用 此仓库可以作为 git 子模块嵌入到任何项目中 - 提供完整的代理框架，同时将项目特定自定义保留本地并 gitignored。 ### 初始设置 ```bash # 添加子模块（每个消耗项目一次） git submodule add https://github.com/jenninexus/agency.git storage/agency git submodule update --init --recursive ``` ### 双层覆盖模式 ``` storage/agency/agents/GraphViz.md ← 公共模板（跟踪，只读） storage/agency/projects/yourproject/ ← 本地覆盖（gitignored） GraphViz.md ← 项目特定路径，机密，脚本 landscape.webp ← 规范代理肖像（风景） square.webp ← 规范代理肖像（方形） gen-ai/ ← 原始生成输出（仅本地） ``` 参见 [`projects/README.md`](projects/README.md) 以获取完整的项目设置信息，并参见 [`docs/PUBLIC-LOCAL-SPLIT.md`](docs/PUBLIC-LOCAL-SPLIT.md) 以获取设计原理。 ### 更新子模块 始终在 **规范克隆** 中编辑（`C:\Github\agency` 或您的复刻），然后传播： ```bash # 1. 在规范克隆中编辑 cd C:\Github\agency git add <files> && git commit -m "[AGENT] description" && git push # 2. 在每个使用项目的指针中更新 cd path/to/consuming-project git submodule update --remote storage/agency git add storage/agency git commit -m "chore: bump agency submodule" ``` 永远不要在消费项目中直接编辑 `storage/agency/` 中的文件 - 这些更改不会传播回子模块源。 --- ## 未来的代理（路线图） | 代理 | 角色 | 状态 | |:------|:-----|:-------| | **Codex** | 构建系统和 DevOps | 计划中 | | **Tagster** | 标签系统专家 | 计划中 | | **Linklord** | 外部链接和 API | 计划中 | | **Docster** | 文档管理员 | 计划中 | | **Testrix** | 测试和 QA | 计划中 | > 项目特定代理（Cipher, GlassField, MissionControl, Orbiter）位于 [`projects/`](projects/) - 不在此处展示团队。 --- ## 哲学 > *"投资者不为白色背景付费。* - GraphViz AI 代理机构不仅仅是一种组织方式 - 它是一种思维方式： 1. **专业化** - 创建专家，而不是通才 2. **自动化** - 每周审计捕捉漂移，防止其累积 3. **文档** - 明确的规则胜过隐含的假设 4. **协调** - 清晰的所有权可防止冲突 5. **迭代** - 随着项目增长，添加代理 --- ## 贡献 本框架旨在适应： - 创建和分享新的代理模板 - 添加审计脚本示例 - 改进文档 - 分享您的代理团队配置 --- <div align="center"> MIT - 使用、复刻、自定义 如果这有助于您构建更好的代理团队： [给这个仓库加星](https://github.com/jenninexus/agency) · [链接](https://jenninexus.com/links) · [Patreon](https://www.patreon.com/c/JenniNexus) · [Paypal](https://paypal.me/jenninexus) 由 [Jenni](https://github.com/jenninexus) 在 [Monofinity Studio](https://github.com/monofinitystudio) 发布。 </div>