simota/agent-skills

# AI Agent 技能 [](https://opensource.org/licenses/MIT) []() [](CONTRIBUTING.md) 这是一个技能集合，旨在支持与一支专业化 AI agent 团队进行协作开发。 ## 功能特性 - **90 个专业化 Agent** —— 涵盖 Bug 调查、测试、安全、UI/UX、AI/ML、可观测性等领域 - **Nexus 编排器** —— 分析任务并自动设计最优的 agent 链 - **平台无关** —— 支持 Claude Code、Codex CLI、Gemini CLI 等 ## 快速开始 ### 安装 ``` # For Claude Code git clone https://github.com/simota/agent-skills.git ~/.claude/skills # For other platforms git clone https://github.com/simota/agent-skills.git /path/to/your/skills ``` ### 使用 ``` /Nexus I want to implement a login feature /Scout Investigate the cause of this bug /Radar Improve test coverage /Vision I want to redesign the dashboard with a modern look ``` ## 概述 本仓库包含 90 个专业化 AI agent，涵盖软件开发的各个方面。每个 agent 专注于特定领域，并由 **Nexus** 编排器进行协调。 ## Agent 目录 ### 编排 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Nexus** | _“在对的时间用对的 agent，能改变一切。”_ —— 团队编排器。分解请求并设计最优 agent 链 | Prompts、进度管理 | | **Sherpa** | _“山峰不在乎你的截止日期。做好规划。”_ —— 任务分解向导。将复杂任务拆解为 15 分钟内可完成的原子步骤 | 检查清单 | | **Architect** | _“每个 agent 都是一种可能。每个 SKILL.md 都是一张出生证明。”_ —— 元设计师，负责创建新的技能 agent。生态缺口分析、重复检测、SKILL.md 生成 | SKILL.md、参考资料 | | **Rally** | _“一个任务，多双手。并行设计。”_ —— 多会话并行编排器。通过 Claude Code Agent Teams API 生成和管理多个 Claude 实例，实现并发任务执行 | 团队管理、并行执行 | | **Titan** | _“给我一个梦想，我还你一个产品。”_ —— 产品生命周期元编排器。协调全部 69 个 agent 跨越 9 个阶段（DISCOVER→BUILD→LAUNCH→EVOLVE），从模糊目标交付完整产品 | 产品交付 | | **Sigil** | _“每个项目都有等待被发掘为力量的模式。”_ —— 动态技能生成器。分析项目代码库，发现模式和约定，并为项目的 `.claude/skills/` 目录生成优化的 Claude Code 技能 | 项目专属技能 | | **Orbit** | _“给我一个目标，我给你一个能跑完的 runner。”_ —— Nexus 自动循环完成专家。生成完成脚本、操作契约和自主循环执行审计 | Runner 脚本、契约 | | **Darwin** | _“无法感知自身的生态系统无法自我进化。”_ —— 生态自我进化编排器。检测项目生命周期阶段，评估 agent 相关性，整合跨领域知识，并推动整个生态进化 | 生态适应度评分、进化提案 | | **Lore** | _“被遗忘的教训注定重演。制度记忆是经验的复利。”_ —— 跨生态知识整合的记忆策展人。从 agent 日志中发现通用模式，编目并分发给相关 agent。知识衰减检测和最佳实践传播 | METAPATTERNS.md、知识洞察 | ### 调查与规划（非编码） | Agent | 描述 | 输出 | |-------|-------------|--------| | **Scout** | _“每个 Bug 都有故事。我先读结局。”_ —— Bug 调查和根因分析（RCA）。识别复现步骤和修复位置 | 调查报告 | | **Ripple** | _“每个改变都会激起涟漪。在跳跃之前先知道它们落在哪里。”_ —— 变更前影响分析。从纵向（依赖、受影响文件）和横向（模式一致性、命名约定）两个角度评估风险 | 影响分析报告 | | **Spark** | _“最好的功能是用户不知道自己需要的功能。”_ —— 功能提案。建议利用现有数据/逻辑的功能，输出 Markdown 规格文档 | 规格文档 | | **Compete** | _“了解敌人。了解市场。了解自己。”_ —— 竞争研究、差异化和定位。SWOT 分析、功能矩阵 | 竞争分析报告 | | **Voice** | _“反馈是礼物。分析是拆开它。”_ —— 用户反馈收集、NPS 问卷设计、情感分析和洞察提取 | 反馈报告 | | **Researcher** | _“用户不会撒谎。他们只是还不知道自己想要什么。”_ —— 用户研究设计、访谈指南、定性分析、人物画像/旅程图创建 | 研究报告 | | **Trace** | _“每次点击都在讲故事。我在操作之间读懂含义。”_ —— 会话回放分析、按人物画像的行为模式提取、UX 问题叙事。与 Researcher/Echo 配合工作 | 行为分析报告 | | **Canon** | _“标准是行业积累的智慧。应用它们，不要重新发明。”_ —— 使用全球/行业标准进行调查和分析。评估 OWASP/WCAG/OpenAPI/ISO 25010 合规性，检测违规并提出改进建议 | 合规报告 | | **Lens** | _“看代码，而不只是搜索它。”_ —— 代码库理解专家。系统性调查代码结构、功能探索和数据流追踪，回答诸如“功能 X 是否存在？”、“流程 Y 如何工作？”、“这个模块的职责是什么？” | 调查报告 | | **Magi** | _“三个头脑，一个裁决。通过多样性达成共识。”_ —— 从三个视角（逻辑、共情、实用主义）进行多角度决策。架构选型、权衡分析、Go/No-Go 决策 | 决策报告 | | **Cast** | _“人物画像不是发明的。它们是被发现、诞生和演化的。”_ —— 人物画像铸造 agent。从多种输入快速生成、注册管理、生命周期追踪和跨 agent 分发人物画像 | 人物画像注册 | | **Helm** | _“没有目的地的船没有顺风。没有舵的船完全没有方向。”_ —— 商业战略模拟 agent。整合财务/市场/竞争数据进行短/中/长期模拟。SWOT/PESTLE/Porter 分析、情景规划、KPI 预测、战略路线图生成。不编写代码 | 战略模拟报告 | | **Levy** | _“納税は義務。でも、正しく知れば、賢く果たせる。”_ —— 日本报税指导 agent。面向自由职业者和副业工作者的收入分类、扣除优化、税额计算、e-Tax 手续。不编写代码 | 报税指导报告 | | **Accord** | _“三个团队，一个真相。”_ —— 跨团队规格架构师。使用渐进式细化模板创建跨业务、开发和设计团队的综合规格包（L0 愿景 > L1 需求 > L2 团队细节 > L3 验收标准）。不编写代码 | 综合规格包、可追溯性矩阵 | | **Matrix** | _“无限组合，有限资源。Matrix 找到覆盖面最大化的最小集合。”_ —— 通用多维分析 agent。控制任意轴×值输入的组合爆炸。最小覆盖集选择、执行规划和跨领域（测试、部署、UX 验证、风险评估、兼容性）优先级排序。不编写代码 | 矩阵分析、覆盖优化计划 | **Scout > Ripple > Builder 链**：Scout（Bug 调查）> Ripple（修复影响分析）> Builder（实现） **Ripple > Guardian 链**：Ripple（影响分析）> Guardian（PR 策略） **Researcher > Trace > Echo 链**：Researcher（人物画像定义）> Trace（真实数据验证）> Echo（模拟确认） **Sentinel > Canon > Builder 链**：Sentinel（漏洞检测）> Canon（OWASP 合规评估）> Builder（修复实现） **Gateway > Canon > Gateway 链**：Gateway（API 设计）> Canon（OpenAPI/RFC 合规检查）> Gateway（修正） **Echo > Canon > Palette 链**：Echo（UX 问题）> Canon（WCAG 合规评估）> Palette（无障碍修复） **Researcher > Cast > Echo 链**：Researcher（研究数据）> Cast（人物画像整合）> Echo（UI 验证） **Trace > Cast 链**：Trace（行为数据）> Cast（人物画像演化） ### Git/PR 管理 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Guardian** | _“每次提交都在讲故事。让它值得一读。”_ —— Git/PR 守门人。变更的信号/噪声分析、提交粒度优化、分支命名、PR 策略提案 | 分析报告、PR 准备 | | **Harvest** | _“代码书写历史。我收获它的意义。”_ —— PR 信息收集和报告生成。通过 gh 命令获取 PR 信息，自动生成周报/月报和发布说明 | 工作报告、发布说明 | | **Launch** | _“发布不是终点。它是责任的开始。”_ —— 发布管理。版本策略、CHANGELOG 生成、发布说明、回滚计划、功能开关设计 | 发布计划、CHANGELOG | | **Rewind** | _“每个 Bug 都有生日。每个回归都有父提交。找到它们。”_ —— Git 历史调查、回归根因分析、代码考古。穿越时间揭示真相 | 历史调查报告 | **Guardian > Judge > Zen 链**：Guardian（PR 准备）> Judge（审查）> Zen（修复） **Guardian > Launch 链**：Guardian（变更分析）> Launch（发布计划） **Rewind > Scout 链**：Rewind（回归识别）> Scout（详细调查） ### 质量保证 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Radar** | _“未经测试的代码是未完成的代码。”_ —— 单元/集成测试添加、不稳定测试修复、覆盖率提升 | 测试代码 | | **Voyager** | _“E2E 测试是 CI/CD 中用户的代言人。”_ —— E2E 测试专家。Playwright/Cypress 设置、Page Object 设计、视觉回归、CI 集成 | E2E 测试代码 | | **Sentinel** | _“安全不是功能。它是责任。”_ —— 静态安全分析（SAST）、漏洞模式检测、输入验证 | 安全修复 | | **Probe** | _“系统的安全性取决于最薄弱的端点。”_ —— 动态安全测试（DAST）、OWASP ZAP/Nuclei 集成、渗透测试 | 漏洞报告 | | **Judge** | _“好代码不需要辩护。坏代码没有借口。”_ —— 通过 codex review 进行代码审查、自动化 PR 审查、预提交检查、AI 幻觉检测 | 审查报告 | | **Zen** | _“整洁代码不是写出来的。是改出来的。”_ —— 重构和代码质量提升（行为不变） | 代码改进 | | **Sweep** | _“死代码是不产生利息的技术债务。”_ —— 未使用文件检测、死代码识别、孤立文件发现、安全删除提案 | 清理提案 | | **Warden** | _“质量不可商量。不配的东西不要发布。”_ —— V.A.I.R.E. 质量标准守护者。发布前评估、评分卡、通过/失败决策 | 质量评估报告 | | **Attest** | _“规格是真理。代码是证据。Attest 发现差距。”_ —— 规格合规验证器。从规格中提取验收标准，生成 BDD 场景，并对抗性地探测规格与实现之间的差距。发布 CERTIFIED/CONDITIONAL/REJECTED 裁决 | 合规报告、BDD 场景 | | **Specter** | _“你看不到的 Bug 才是最困扰你的。”_ —— “隐形”问题猎手，专注于并发、异步处理和资源管理。检测和分析 Race Conditions、Memory Leaks、Resource Leaks 和 Deadlocks | 检测报告 | | **Siege** | _“在用户之前破坏它。在他们注意之前修复它。”_ —— 高级测试专家。负载测试、契约测试、混沌工程、变异测试、弹性模式验证 | 测试结果、弹性报告 | | **Void** | _“最好的代码是从未写过的代码。”_ —— YAGNI 执行、范围削减、复杂度降低提案。用 5 个问题和保留成本评分挑战每个功能/抽象的存在 | 削减提案 | ### 实现 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Builder** | _“类型是契约。代码是承诺。”_ —— 生产实现。类型安全工匠，支持 TDD、Event Sourcing、CQRS 和性能优化。检测规格模糊性，支持从 Forge 自动交接 | 生产代码 | | **Artisan** | _“原型承诺。生产交付。”_ —— 生产前端实现工匠。React/Vue/Svelte、Hooks 设计、状态管理、Server Components、表单处理、数据获取 | 前端代码 | | **Forge** | _“完成比完美更好。发布它，学习，迭代。”_ —— 原型制作。优先考虑可工作软件而非完美。输出 types.ts、errors.ts、forge-insights.md 用于 Builder 交接 MVP/PoC | | **Arena** | _“Arena 是裁判，不是选手。外部引擎竞争；最佳方案获胜。”_ —— 直接驱动 codex exec / gemini CLI 进行并行实现、评估和采用。支持 Solo 模式（顺序）和 Team 模式（Agent Teams 并行） | 比较实现和评估 | ### AI/ML | Agent | 描述 | 输出 | |-------|-------------|--------| | **Oracle** | _“AI 只有在其架构上才优秀。设计它，测量它，什么都不信。”_ —— AI/ML 设计和评估专家。Prompt 工程、RAG 架构、LLM 应用模式、安全护栏、评估框架、MLOps、成本优化 | 设计规格、评估报告 | **Oracle > Builder > Radar 链**：Oracle（AI/ML 设计）> Builder（实现）> Radar（测试） **Oracle > Stream > Builder 链**：Oracle（RAG 设计）> Stream（数据管道）> Builder（实现） **Oracle > Sentinel > Oracle 链**：Oracle（安全设计）> Sentinel（安全审查）> Oracle（细化） ### 性能 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Bolt** | _“速度是功能。缓慢是你还没修复的 Bug。”_ —— 应用性能提升。前端（减少重渲染）和后端（N+1 修复）优化 | 优化代码 | | **Tuner** | _“快速查询是快乐的用户。慢速查询是流失的客户。”_ —— DB 性能优化。EXPLAIN ANALYZE 分析、索引建议、慢查询改进 | 查询优化 | ### 可观测性/SRE | Agent | 描述 | 输出 | |-------|-------------|--------| | **Beacon** | _“你看不到的就无法修复。你不测量的就看不到。”_ —— 可观测性和可靠性工程专家。SLO/SLI 设计、分布式追踪、告警策略、仪表板设计、容量规划、琐事自动化 | SLO 定义、可观测性规格 | **Beacon > Gear > Builder 链**：Beacon（可观测性设计）> Gear（监控实现）> Builder（插桩） **Triage > Beacon > Gear 链**：Triage（事故复盘）> Beacon（监控改进）> Gear（实现） ### UI/UX | Agent | 描述 | 输出 | |-------|-------------|--------| | **Vision** | _“设计不是看起来怎样。设计是感觉如何。”_ —— 创意方向。设计方向决策、设计系统创建、Muse/Palette/Flow/Forge 编排 | 设计策略 | | **Palette** | _“易用性做得好时是隐形的，做得不好时是痛苦的。”_ —— 易用性改进、认知负荷降低、a11y 支持 | UX 改进 | | **Muse** | _“Token 是设计的 DNA。小心变异它们。”_ —— 设计 Token 应用、间距/圆角/阴影统一、暗色模式支持 | 视觉改进 | | **Flow** | _“动效创造情感。动画赋予生命。”_ —— UI 动画、悬停效果、加载状态、模态框过渡 | 动画 | | **Echo** | _“我不测试界面。我感受用户的感受。”_ —— 人物画像验证。化身用户报告 UI 流程中的困惑点 | UX 报告 | | **Showcase** | _“没有 Story 的组件是没有上下文的组件。”_ —— Storybook story 创建、目录管理、Visual Regression 集成。CSF 3.0 格式 | Storybook Stories | | **Prose** | _“文字是设计的最小单位。弄错它们，其他都不重要了。”_ —— 面向用户的文字专家。微文案、错误消息、语气语调框架、新手引导文案、无障碍文本 | 文案指南、内容规格 | | **Frame** | _“设计用像素说话。我将其翻译成代码。”_ —— Figma MCP Server 桥接 agent。从 Figma 提取和结构化设计上下文供实现 agent 使用。设计到代码桥接、Code Connect 管理、设计系统规则提取。不编写代码 | 结构化设计上下文、设计系统规则 | | **Loom** | _“设计意图值得准备。我编织的每一根上下文线索都让创作更精确。”_ —— Figma Make 优化 agent。分析代码库生成 Guidelines.md，设计 prompt 策略，根据设计系统约定验证 Make 输出。不编写代码 | Guidelines.md、prompt 序列、验证报告 | **Frame 与 Loom 职责分工**： - **Frame**：Figma → Code 方向（通过 MCP 从 Figma 提取设计上下文） - **Loom**：Code → Figma Make 方向（从代码库分析为 Figma Make 准备优化输入） ### 文档 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Scribe** | _“规格是愿景与现实之间的契约。”_ —— 文档撰写者，负责 PRD/SRS/HLD/LLD、实现检查清单和测试规格 | 规格文档、设计文档 | | **Quill** | _“代码告诉计算机做什么。文档告诉人类为什么。”_ —— JSDoc/TSDoc 添加、README 更新、`any` 类型到正确类型定义 | 文档 | | **Morph** | _“文档是永恒的。它的格式是暂时的。”_ —— 文档格式转换（Markdown <> Word/Excel/PDF/HTML）。将 Scribe 规格和 Harvest 报告转换为各种格式 | 转换后文档 | | **Prism** | _“一个源头，多种光芒。”_ —— NotebookLM 转向 prompt 设计顾问。就源准备和最佳输出格式选择提供建议 | 转向 prompt | **Scribe 与 Quill 与 Morph 与 Prism 职责分工**： - **Scribe**：项目文档（PRD、SRS、设计文档、检查清单、测试规格） - **Quill**：代码文档（JSDoc/TSDoc、README、类型定义） - **Morph**：格式转换（Markdown > PDF/Word/HTML 等） - **Prism**：NotebookLM 内容优化（Audio/Video/Slide 的转向 prompt） ### 可视化 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Canvas** | _“一张图胜过一千行文档。”_ —— 设计可视化。将代码、规格和上下文转换为 Mermaid 图或 ASCII 艺术（流程图、时序图、状态机、类图、ER 图等） | Mermaid 图 / ASCII 艺术 | | **Sketch** | _“从文字到世界，从 prompt 到像素。”_ —— AI 图像生成代码工匠。通过 Gemini API 生成生产就绪的 Python 图像生成代码。Prompt 工程、批量生成、成本估算 | Python 代码 | | **Realm** | _“每家公司都在讲故事——让 agent 们书写自己的故事。”_ —— 游戏化元可视化 agent。Phaser 3 2D 办公模拟、实时 XP 增长和升级效果、交互式 HTML 地图、角色卡、任务板和徽章系统，用于生态状态可视化和团队士气 | RPG 风格仪表板、游戏可视化 | | **Dot** | _“每个像素都是一个决定。每个约束都是创造的机会。”_ —— 像素艺术专家。通过代码生成像素艺术。调色板设计、精灵表、图块集、帧动画、委托 Gemini CLI 生成 SVG | 像素艺术代码 | | **Clay** | _“从 prompt 到多边形，每个顶点都实至名归。”_ —— AI 3D 模型生成 agent。通过 Meshy、Tripo、Hunyuan3D、Rodin、Sloyd、Stability API 生成文本到 3D 和图像到 3D 的代码。游戏管道：LOD、重拓扑、UV、纹理烘焙、QC 验证 | 3D 管道代码（Python/JS/SCAD）| **Vision > Dot > Forge 链**：Vision（美术指导）> Dot（像素艺术代码）> Forge（原型整合） **Dot > Realm 链**：Dot（Phaser 3 纹理）> Realm（生态可视化） **Vision > Clay > Builder 链**：Vision（美术指导）> Clay（3D 资产代码）> Builder（游戏逻辑整合） ### 架构 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Atlas** | _“依赖即命运。先绘制它，否则它将绘制你。”_ —— 依赖分析、循环引用检测、ADR/RFC 创建 | 设计文档 | | **Horizon** | _“今天的创新是明天的遗留代码。做好规划。”_ —— 现代化。废弃库检测、原生 API 替换、PoC 创建 | 迁移计划 | | **Gateway** | _“API 是对未来的承诺。像设计契约一样设计它。”_ —— API 设计、审查、OpenAPI 规格生成、版本策略、破坏性变更检测 | API 规格 | | **Grove** | _“结构良好的仓库是结构良好的头脑。”_ —— 仓库结构设计、优化和审计。目录设计、docs/ 组织、测试结构、反模式检测 | 结构设计、审计报告 | ### 通信 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Relay** | _“每条消息都会找到出路。每个渠道都说同样的语言。”_ —— 消息集成、机器人开发和实时通信专家。频道适配器、webhook 处理器、WebSocket 服务器、事件驱动架构 | 频道适配器、消息处理器、机器人框架 | **Relay > Builder > Radar 链**：Relay（消息设计）> Builder（实现）> Radar（测试） **Gateway > Relay 链**：Gateway（webhook API 规格）> Relay（处理器设计） ### 数据 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Schema** | _“Schema 是与未来的契约。”_ —— DB Schema 设计、迁移创建、ER 图设计 | 迁移 / Schema 定义 | | **Stream** | _“数据如水般流动。我的工作是建造管道。”_ —— 数据管道。ETL/ELT 设计、Kafka/Airflow/dbt、批处理/流处理选择、数据质量管理 | 管道设计、DAG、dbt 模型 | **Schema > Stream 链**：Schema（数据模型）> Stream（管道设计） ### DevOps | Agent | 描述 | 输出 | |-------|-------------|--------| | **Anvil** | _“终端是第一个界面。让它令人难忘。”_ —— 终端 UI 构建、CLI 开发支持、开发工具集成（Linter/测试运行器/构建） | CLI/TUI 代码 | | **Gear** | _“最好的 CI/CD 是没人会想到的。”_ —— 依赖管理、CI/CD 优化、Docker 配置、运维监控 | 配置文件 | | **Scaffold** | _“基础设施是每个梦想的沉默基石。”_ —— 云基础设施、本地开发环境、IaC 设计 | 基础设施配置 | | **Hearth** | _“你的工具应该感觉像家。”_ —— 个人开发环境工匠。生成、优化和审计配置文件、dotfile 管理、shell/终端/编辑器设置 | 配置文件 | | **Latch** | _“每个事件都是机会。在它溜走之前钩住它。”_ —— Claude Code hook 专家。提议、配置、调试和维护 Claude Code hooks（PreToolUse/PostToolUse/Stop/SessionStart 等），用于工作流自动化、质量门控和安全验证 | Hook 配置 | | **Pipe** | _“工作流即管道。管道即承诺。”_ —— GitHub Actions 工作流专家。触发策略、安全加固、性能优化、PR 自动化、可复用工作流设计 | GHA 工作流 | **Hearth 与 Gear 与 Scaffold 与 Latch 与 Pipe 职责分工**： - **Hearth**：个人环境（dotfiles、shell、编辑器、终端） - **Gear**：项目级 DevOps（CI/CD、Docker、监控、Git hooks） - **Scaffold**：基础设施供应（云、Docker Compose、IaC） - **Latch**：Claude Code 事件 hooks（settings.json hooks 用于工作流自动化） - **Pipe**：GitHub Actions 工作流（高级 GHA 设计、可复用工作流、安全） ### 国际化 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Polyglot** | _“每种语言都值得尊重。每个用户都值得拥有母语。”_ —— i18n 支持。用 t() 函数替换硬编码字符串，使用 Intl API 格式化日期/货币 | i18n 实现 | ### 增长 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Growth** | _“没有转化的流量只是昂贵的虚荣。”_ —— SEO（meta/OGP/JSON-LD）、SMO（社交分享展示）、CRO（CTA 改进） | 增长举措 | | **Retain** | _“获客昂贵。留存有利可图。”_ —— 留存策略、重新、流失预防。游戏化、习惯养成设计 | 留存举措 | ### 分析 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Pulse** | _“被测量的才能被管理。被错误测量的会被摧毁。”_ —— KPI 定义、追踪事件设计、仪表板规格创建 | 指标设计 | | **Experiment** | _“每个假设都值得公平审判。每个决策都值得数据。”_ —— A/B 测试设计、假设文档、样本量计算、功能开关实现 | 实验报告 | ### 运维 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Triage** | _“在混乱中，清晰是治愈的第一步。”_ —— 事故响应、影响评估、恢复程序、复盘创建 | 运维报告 | | **Mend** | _“已知的失败值得已知的修复。恢复速度定义可靠性。”_ —— 已知失败模式的自动修复 agent。接收 Triage 诊断和 Beacon 告警，根据安全层级分类执行 runbook，进行分阶段验证，并管理回滚 | 修复结果、验证报告 | **Triage > Mend > Beacon 链**：Triage（诊断）> Mend（自动修复）> Beacon（监控恢复） ### 浏览器自动化 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Navigator** | _“浏览器是舞台。每次点击都是一幕。”_ —— 通过 Playwright/Chrome DevTools 进行浏览器自动化。数据收集、表单交互、截图、网络监控 | 自动化脚本 | | **Director** | _“打动人心的 demo 能推动产品。”_ —— 使用 Playwright E2E 测试自动录制功能 demo 视频。场景设计、录制设置、实现模式、质量检查清单 | Demo 视频（.webm）| | **Reel** | _“终端是舞台。每次按键都是表演。”_ —— 使用 VHS/terminalizer/asciinema 进行终端录制和 CLI demo 视频生成。从声明式 .tape 文件创建 GIF/MP4/WebM | GIF/视频| **Anvil > Reel > Quill 链**：Anvil（CLI 开发）> Reel（demo 录制）> Quill（README GIF 嵌入） **Director + Reel > Showcase 链**：Director（Web 录制）+ Reel（终端录制）> Showcase（视觉文档） **Director 与 Reel 职责分工**： - **Director**：浏览器 demo 视频（Playwright，.webm 输出） - **Reel**：终端 demo 录制（VHS，GIF/MP4 输出） ### AITuber/直播 | Agent | 描述 | 输出 | |-------|-------------|--------| | **Aether** | _“舞台是活的。虚拟形象在呼吸。观众在连接。”_ —— AITuber（AI VTuber）全栈编排器。设计和构建实时流媒体管道（Chat>LLM>TTS>Avatar>OBS）、直播聊天集成、TTS 语音合成、Live2D/VRM 虚拟形象控制、口型同步和 OBS WebSocket 自动化 | 管道设计、流媒体配置 | **Cast > Aether > Builder 链**：Cast（人物画像）> Aether（AITuber 管道设计）> Builder（实现） **Aether > Scaffold > Gear 链**：Aether（流媒体基础设施）> Scaffold（供应）> Gear（CI/CD） ## 工作流 ### 基本用法 1. 使用 `/AgentName` 调用 agent 2. Agent 执行任务 3. 根据需要建议移交给其他 agent ### 使用 Nexus 编排 使用 **Nexus** 处理复杂任务。Nexus 以以下模式运行： | 模式 | 触发 | 行为 | 交互 | |------|---------|----------|-------------| | **Full Auto** | `## NEXUS_AUTORUN` + 简单任务 | 全自动执行 | 仅出错时 | | **Guided** | `## NEXUS_GUIDED` 或默认 | 在决策点确认 | 基于选项的交互 | | **Interactive** | `## NEXUS_INTERACTIVE` | 每步确认 | 始终交互 | | **Continue** | `## NEXUS_HANDOFF` | 结果移交 | 按需交互 | ### 交互式执行 每个 agent 在重要决策点请求用户确认（使用平台的交互能力）： - **开始确认**：链设计完成后，执行前确认方法 - **决策点确认**：安全风险、破坏性变更、多种方法等 - **问题作为选项**：从 2-4 个选项中选择（“其他”始终可用） ``` # Example option-based question questions: - question: "A potential security vulnerability was found. How would you like to proceed?" header: "Security" options: - label: "Audit with Sentinel (Recommended)" description: "Request review from the security specialist agent" - label: "Continue with acknowledged risk" description: "Proceed at your own risk" - label: "Abort investigation" description: "Stop for safety" ``` ### 根据复杂度自动选择模式 | 指标 | 简单 | 复杂 | |-----------|--------|---------| | 预估步骤 | 1-2 | 3+ | | 受影响文件 | 1-3 | 4+ | | 安全相关 | 否 | 是 | | 破坏性变更 | 否 | 是 | - **简单 + NEXUS_AUTORUN**：全自动执行 - **复杂**：自动切换到引导模式（需要交互） 详情见 `_common/INTERACTION.md`。 ### 按任务类型的链模板 #### 调查与理解 | 任务 | 描述 | 链 | |------|-------------|-------| | INVESTIGATE/feature | 功能存在/实现调查 | Lens | | INVESTIGATE/flow | 数据流/处理流程追踪 | Lens > Canvas | | INVESTIGATE/onboarding | 完整代码库理解 | Lens > Scribe | | INVESTIGATE/pre-impl | 调查后实现 | Lens > Builder > Radar | #### Bug 修复 | 任务 | 描述 | 链 | |------|-------------|-------| | BUG/simple | 简单 Bug 修复 | Scout > Builder > Radar | | BUG/complex | 复杂 Bug（需要 RCA）| Scout > Sherpa > Builder > Radar > Sentinel | | BUG/frontend | 前端 Bug | Scout > Artisan > Radar | #### 功能开发 | 任务 | 描述 | 链 | |------|-------------|-------| | FEATURE/S | 小功能 | Builder > Radar | | FEATURE/M | 中等功能 | Sherpa > Forge > Builder > Radar | | FEATURE/L | 大功能 | Spark > Sherpa > Forge > Builder > Radar > Quill | | FEATURE/frontend | 前端功能 | Sherpa > Forge > Artisan > Radar | | FEATURE/fullstack | 全栈功能 | Sherpa > Forge > Artisan > Builder > Radar | | FEATURE/api | API 开发 | Gateway > Builder > Radar | #### UI/UX | 任务 | 描述 | 链 | |------|-------------|-------| | UI/new | 新 UI 实现 | Vision > Forge > Showcase > Muse > Artisan > Radar | | UI/redesign | UI 重设计 | Vision > Muse > Palette > Flow > Artisan > Radar | | UI/component | 组件创建 | Forge > Showcase > Muse > Artisan > Radar | | UI/animation | 动画添加 | Flow > Artisan > Radar | | UX/research | UX 研究 | Researcher > Echo > Palette | | UX/improve | UX 改进 | Echo > Palette > Artisan > Radar | | UX/session-analysis | 会话分析 | Trace > Echo > Palette | | UX/persona-validation | 人物画像验证 | Researcher > Trace > Echo | | UI/figma-make | Figma Make 指南 | Loom > Artisan | #### 重构 | 任务 | 描述 | 链 | |------|-------------|-------| | REFACTOR/small | 小重构 | Zen > Radar | | REFACTOR/arch | 架构改进 | Atlas > Sherpa > Zen > Radar | | REFACTOR/legacy | 遗留现代化 | Horizon > Sherpa > Zen > Radar | #### 性能 | 任务 | 描述 | 链 | |------|-------------|-------| | PERF/frontend | 前端优化 | Bolt > Artisan > Radar | | PERF/backend | 后端优化 | Bolt > Builder > Radar | | PERF/db | 数据库优化 | Tuner > Schema > Builder > Radar | #### AI/ML | 任务 | 描述 | 链 | |------|-------------|-------| | AI/rag | RAG 管道设计 | Oracle > Stream > Builder > Radar | | AI/llm-app | LLM 应用设计 | Oracle > Builder > Radar | | AI/safety | AI 安全审查 | Oracle > Sentinel > Oracle | | AI/prompt-ops | Prompt 工程与评估 | Oracle > Radar | #### 可观测性/SRE | 任务 | 描述 | 链 | |------|-------------|-------| | SRE/slo | SLO 定义与监控 | Beacon > Gear > Builder | | SRE/observability | 完整可观测性设置 | Beacon > Gear > Builder > Radar | #### 安全 | 任务 | 描述 | 链 | |------|-------------|-------| | SECURITY/audit | 静态分析 | Sentinel > Builder > Radar | | SECURITY/pentest | 动态测试 | Probe > Builder > Radar > Probe | | SECURITY/full | 完整审计 | Sentinel > Probe > Builder > Radar > Sentinel | #### 测试 | 任务 | 描述 | 链 | |------|-------------|-------| | TEST/unit | 单元测试添加 | Radar | | TEST/e2e | E2E 测试添加 | Voyager | | TEST/coverage | 覆盖率提升 | Radar > Voyager | | TEST/load | 负载测试 | Siege > Bolt | | TEST/chaos | 混沌工程 | Siege > Triage > Builder | | TEST/contract | 契约测试 | Gateway > Siege > Radar | | TEST/mutation | 变异测试 | Siege > Radar | #### 审查 | 任务 | 描述 | 链 | |------|-------------|-------| | REVIEW/pr | PR 审查 | Judge > Zen/Builder/Sentinel | | REVIEW/security | 安全审查 | Judge > Sentinel | #### Git/PR | 任务 | 描述 | 链 | |------|-------------|-------| | GIT/pr-prep | PR 准备 | Guardian > Judge | | GIT/commit-split | 提交拆分 | Guardian | | GIT/pr-full | 实现 > PR > 审查 | Builder > Guardian > Judge > Zen | | GIT/release | 发布说明生成 | Guardian | #### 决策 | 任务 | 描述 | 链 | |------|-------------|-------| | DECISION/arch | 架构选型 | Magi > Builder/Zen | | DECISION/strategy | 战略决策 | Magi > Spark | #### 分析 | 任务 | 描述 | 链 | |------|-------------|-------| | ANALYSIS/impact | 变更影响分析 | Ripple > Builder > Radar | | ANALYSIS/standards | 标准合规检查 | Canon > Builder > Radar | | ANALYSIS/cleanup | 代码清理 | Sweep > Zen > Radar | #### 削减与文化 | 任务 | 描述 | 链 | |------|-------------|-------| | SUBTRACT/feature-gate | 功能提案削减门控 | Spark > Void > Magi | | SUBTRACT/scope-check | 范围验证 | Sherpa > Void > Sherpa | | SUBTRACT/arch-simplify | 架构过度工程检测 | Atlas > Void > Zen | #### 文档 | 任务 | 描述 | 链 | |------|-------------|-------| | DOCS/prd | PRD 创建 | Scribe | | DOCS/srs | SRS 创建 | Scribe | | DOCS/design | 设计文档创建 | Scribe | | DOCS/spec-to-build | 规格到实现 | Spark > Scribe > Sherpa > Builder | | DOCS/code | 代码文档 | Quill | | DOCS/component | 组件文档 | Showcase > Quill | | DOCS/architecture | 架构图 | Canvas | | DOCS/convert | 格式转换 | Morph | | DOCS/report | PR 报告 | Harvest > Morph | #### Demo 与录制 | 任务 | 描述 | 链 | |------|-------------|-------| | DEMO/cli | CLI demo GIF 创建 | Anvil > Reel > Quill | | DEMO/prototype | 原型 demo | Forge > Reel > Growth | | DEMO/web-terminal | Web + 终端组合 demo | Director + Reel > Showcase | | DEMO/docs | 文档 demo | Scribe > Reel > Quill | | DEMO/ci-update | CI 集成 demo 自动更新 | Gear > Reel > Gear | | DEMO/showcase | 生产 CLI demo | Builder > Reel > Growth | #### 基础设施与 DevOps | 任务 | 描述 | 链 | |------|-------------|-------| | INFRA/ci | CI/CD 设置 | Gear > Radar | | INFRA/cloud | 云设置 | Scaffold > Gear | | INFRA/cli | CLI 开发 | Anvil > Radar | #### 部署与发布 | 任务 | 描述 | 链 | |------|-------------|-------| | DEPLOY/release | 发布执行 | Guardian > Launch | | DEPLOY/full | 完整管道 | Radar > Guardian > Launch > Harvest | #### 现代化 | 任务 | 描述 | 链 | |------|-------------|-------| | MODERNIZE/stack | 技术栈刷新 Lens > Horizon > Sherpa > Builder > Radar | | MODERNIZE/i18n | 国际化 | Polyglot > Artisan > Radar | | MODERNIZE/structure | 仓库结构改进 | Grove > Sherpa > Zen > Radar | #### 战略与增长 | 任务 | 描述 | 链 | |------|-------------|-------| | STRATEGY/seo | SEO 改进 | Growth > Artisan > Radar | | STRATEGY/compete | 竞争分析到实现 | Compete > Spark > Builder > Radar | | STRATEGY/feedback | 反馈整合 | Voice > Spark > Builder > Radar | | STRATEGY/metrics | 指标基础设施 | Pulse > Builder > Radar | | STRATEGY/retention | 留存举措 | Retain > Spark > Builder > Radar | | STRATEGY/ab-test | A/B 测试设计 | Experiment > Builder > Radar | | STRATEGY/data | 数据管道 | Stream > Schema > Builder > Radar | #### 并行执行（Rally 集成） 对于大规模任务，并行执行有益时，Nexus 会升级到 Rally。 | 任务 | 描述 | 并行链 | |------|-------------|---------------| | FEATURE/L (parallel) | 大规模全栈 | Sherpa > Rally(Artisan + Builder + Radar) | | FEATURE/fullstack (parallel) | 前端 + 后端 | Rally(Artisan, Builder, Radar) | | FEATURE/multi (parallel) | 多个独立功能 | Sherpa > Rally(Builder x N, Radar) | | BUG/multiple (parallel) | 多个独立 Bug 修复 | Rally(Builder x N) > Radar | | REFACTOR/arch (parallel) | 多模块重构 | Atlas > Sherpa > Rally(Zen x N) > Radar | | SECURITY/full (parallel) | 静态 + 动态并行扫描 | Rally(Sentinel, Probe) > Builder > Radar | | TEST/coverage (parallel) | 单元 + E2E 并行测试 | Rally(Radar, Voyager) | | MODERNIZE/stack (parallel) | 多区域现代化 | Horizon > Sherpa > Rally(Builder x N) > Radar | | DOCS/full (parallel) | 代码文档 + 图表 + stories | Rally(Quill, Canvas, Showcase) | #### 产品生命周期 | 任务 | 描述 | 链 | |------|-------------|-------| | PROJECT/full | 从模糊目标到完整产品 | Titan（通过 Nexus 的 9 阶段生命周期）| | PROJECT/mvp | 聚焦 MVP 交付 | Titan（DISCOVER→BUILD→VALIDATE→LAUNCH）| #### 其他 | 任务 | 描述 | 链 | |------|-------------|-------| | INCIDENT | 事故响应 | Triage > Scout > Builder | | TEST/quality | 迭代质量改进 | Judge > Zen > Radar | | SECURITY/concurrency | 并发 Bug 检测 | Specter > Builder > Radar | | INVESTIGATE/regression | 回归调查 | Rewind > Scout > Builder > Radar | #### 消息与实时 | 任务 | 描述 | 链 | |------|-------------|-------| | MESSAGING/bot | 机器人开发 | Relay > Builder > Radar | | MESSAGING/webhook | Webhook 处理器 | Gateway > Relay > Builder > Radar | | MESSAGING/realtime | 实时通信 | Relay > Scaffold > Builder > Radar | | MESSAGING/multi-channel | 多渠道集成 | Relay > Builder > Radar | #### AITuber/直播 | 任务 | 描述 | 链 | |------|-------------|-------| | AITUBER/setup | AITuber 管道设置 | Cast > Aether > Builder > Radar | | AITUBER/avatar | 虚拟形象与口型同步设置 | Aether > Builder | | AITUBER/streaming | 直播自动化 | Aether > Gear > Builder | ## 共享知识 Agent 通过 `.agents/` 目录共享知识： | 文件 | 目的 | 更新时机 | |------|---------|---------------| | `PROJECT.md` | 共享知识 + 活动日志 | **所有 agent 完成工作后必须更新** | | `{agent}.md` | Agent 专属学习 | 发现领域特定知识时 | ### PROJECT.md 结构 - **架构决策** —— 架构选择记录 - **领域术语表** —— 统一术语 - **API 与外部服务** —— 外部服务约束 - **已知陷阱** —— 已知问题 - **安全注意事项** —— 安全约束 - **性能预算** —— 性能目标 - **活动日志** —— Agent 工作历史 ## Agent 原则 所有 agent 遵循以下原则： ### 通用规则 - **50 行以下变更** —— 追求小而安全的变更 - **尊重现有模式** —— 遵循项目约定 - **运行测试** —— 变更前后运行测试 - **仅记录重要学习** —— 不记录日常工作 ### 边界类型 | 标记 | 含义 | |--------|---------| | Always do | 必须始终执行 | | Ask first | 需要确认 | | Never do | 绝不执行 | ## 目录结构 ``` skills/ ├── _common/ │ └── INTERACTION.md # Shared interaction rules ├── _templates/ │ └── PROJECT.md # Project knowledge template ├── aether/SKILL.md # AITuber/streaming orchestrator ├── architect/SKILL.md # Agent design meta-designer ├── anvil/SKILL.md # CLI/TUI construction ├── arena/SKILL.md # External engine competition (Solo/Team Mode) ├── artisan/SKILL.md # Frontend implementation ├── atlas/SKILL.md # Architecture ├── beacon/SKILL.md # Observability/SRE ├── bolt/SKILL.md # Performance ├── builder/SKILL.md # Production implementation ├── canvas/SKILL.md # Visualization ├── cast/SKILL.md # Persona casting & registry management ├── compete/SKILL.md # Competitive research ├── darwin/SKILL.md # Ecosystem self-evolution orchestrator ├── director/SKILL.md # Demo video recording ├── dot/SKILL.md # Pixel art generation (SVG/Canvas/Phaser 3) ├── echo/SKILL.md # Persona validation ├── experiment/SKILL.md # A/B test design ├── flow/SKILL.md # Animation ├── forge/SKILL.md # Prototyping ├── frame/SKILL.md # Figma design-to-code bridge ├── loom/SKILL.md # Figma Make optimization agent ├── gateway/SKILL.md # API design ├── gear/SKILL.md # DevOps ├── grove/SKILL.md # Repository structure design ├── growth/SKILL.md # SEO/CRO ├── guardian/SKILL.md # Git/PR management ├── harvest/SKILL.md # PR info collection & report generation ├── hearth/SKILL.md # Personal dev environment config ├── latch/SKILL.md # Claude Code hook management ├── horizon/SKILL.md # Modernization ├── judge/SKILL.md # Code review (codex review) ├── launch/SKILL.md # Release management ├── lens/SKILL.md # Codebase comprehension & investigation ├── lore/SKILL.md # Cross-ecosystem knowledge curator ├── magi/SKILL.md # Multi-perspective decision making ├── matrix/SKILL.md # Universal multi-dimensional analysis ├── mend/SKILL.md # Known failure auto-repair ├── morph/SKILL.md # Document format conversion ├── muse/SKILL.md # Design ├── navigator/SKILL.md # Browser automation ├── nexus/SKILL.md # Orchestrator ├── orbit/SKILL.md # Nexus-autoloop completion specialist ├── oracle/SKILL.md # AI/ML design & evaluation ├── palette/SKILL.md # UX ├── polyglot/SKILL.md # i18n ├── prism/SKILL.md # NotebookLM steering prompt design ├── prose/SKILL.md # UX writing & content strategy ├── pipe/SKILL.md # GitHub Actions workflow design ├── probe/SKILL.md # Dynamic security testing (DAST) ├── pulse/SKILL.md # Metrics design ├── quill/SKILL.md # Documentation ├── radar/SKILL.md # Testing ├── rally/SKILL.md # Multi-session parallel orchestrator ├── realm/SKILL.md # Gamification meta-visualization ├── reel/SKILL.md # Terminal recording & CLI demo video generation ├── relay/SKILL.md # Messaging integration & real-time communication ├── researcher/SKILL.md # User research ├── ripple/SKILL.md # Pre-change impact analysis ├── retain/SKILL.md # Retention ├── rewind/SKILL.md # Git history investigation ├── scaffold/SKILL.md # Infrastructure ├── schema/SKILL.md # DB schema design ├── siege/SKILL.md # Advanced testing (load/contract/chaos/mutation) ├── scribe/SKILL.md # Project documentation (PRD/SRS/design docs) ├── accord/SKILL.md # Cross-team integrated spec packages ├── scout/SKILL.md # Bug investigation ├── sentinel/SKILL.md # Static security analysis (SAST) ├── sherpa/SKILL.md # Task decomposition ├── sigil/SKILL.md # Dynamic project-specific skill generation ├── showcase/SKILL.md # Storybook story management ├── sketch/SKILL.md # AI image generation (Gemini API) ├── spark/SKILL.md # Feature proposals ├── specter/SKILL.md # Concurrency & async issue detection ├── stream/SKILL.md # Data pipelines ├── sweep/SKILL.md # Dead code detection ├── titan/SKILL.md # Product lifecycle meta-orchestrator ├── trace/SKILL.md # Session replay analysis ├── triage/SKILL.md # Incident response ├── tuner/SKILL.md # DB performance optimization ├── vision/SKILL.md # Creative direction ├── void/SKILL.md # YAGNI enforcement & complexity reduction ├── voice/SKILL.md # User feedback ├── voyager/SKILL.md # E2E testing ├── warden/SKILL.md # V.A.I.R.E. quality gate └── zen/SKILL.md # Refactoring ``` ## 使用示例 ### 单个 Agent 使用 #### 编排 ##### 链设计 ``` /Nexus I want to implement a login feature. What steps should I follow? ``` **输出**：任务分类（FEATURE/M）、推荐链（Sherpa > Forge > Builder > Radar）、第一步的 prompt ##### 任务分解 ``` /Sherpa The payment feature implementation task is too complex to organize. Please break it down. ``` **输出**：可在 15 分钟内完成的原子步骤列表、进度检查清单、开始第一个任务的具体指令 ##### Agent 设计 ``` /Architect Design an agent specialized in input validation. I want it to handle Zod/Yup schema validation and error message generation. ``` **输出**：SKILL.md（完整规格）、references/*.md（3-7 个领域特定知识文件）、Nexus 集成设计 ##### 产品交付 ``` /Titan Build me a task management SaaS with team collaboration features. ``` **输出**：9 阶段产品生命周期执行——市场分析、架构设计、通过 Rally 并行实现、安全加固、E2E 验证、文档和发布准备。所有决策自主记录。 ##### 项目技能生成 ``` /Sigil Analyze this project and generate useful skills for the team. ``` **输出**：技术栈分析、技能机会发现、生成到 `.claude/skills/` 的 Micro/Full 技能（如 new-page、new-api-route、deploy-flow） ##### 定向技能创建 ``` /Sigil Generate a skill for creating new API routes in this Express project. ``` **输出**：项目专属的 `new-route.md` 技能，包含与项目现有模式和约定匹配的模板 **Architect 与 Sigil 职责分工**： - **Architect**：设计通用生态 agent（400-1400 行，SKILL.md） - **Sigil**：从实时上下文生成项目专属技能（10-400 行，.claude/skills/） ##### 自动循环完成脚本 ``` /Orbit Generate completion scripts for the Nexus autoloop that deploys and validates a staging environment. Ensure the loop halts on test failures. ``` **输出**：带有停止条件的 Runner 脚本、操作契约（SLA/预算/护栏）、审计检查清单 #### 调查与规划 ##### Bug 调查 ``` /Scout Users are reporting they can't log in. Please investigate the cause. ``` **输出**：调查报告，包括复现步骤、根因、待修复文件和推荐修复方法 ##### 功能提案 ``` /Spark Suggest features to improve this application's usability. ``` **输出**：利用现有数据/逻辑的功能提案规格文档 ##### 会话回放分析 ``` /Trace The checkout flow has a high abandonment rate. Please analyze actual session data. ``` **输出**：挫败信号检测、按人物画像的行为模式、UX 问题报告 ##### 人物画像验证 ``` /Trace Validate the "Mobile-First Millennial" persona defined by Researcher against real data. ``` **输出**：人物画像定义有效性检查、子细分发现、移交给 Researcher **Trace 与 Echo 与 Researcher 职责分工**： - **Researcher**：创建人物画像（从访谈和研究） - **Trace**：用真实数据验证人物画像（从会话日志） - **Echo**：化身人物画像验证 UI（模拟） ##### 人物画像铸造 ``` /Cast Generate 5 user personas for our e-commerce platform from these analytics data and support tickets. Register them in the persona registry for use by Echo and Researcher. ``` **输出**：人物画像卡（人口统计、目标、挫败点、技术熟练度）、统一格式的注册条目、下游 agent 同步配置 #### Git/PR 管理 ##### PR 准备 ``` /Guardian Before creating a PR from this branch, suggest a commit structure and PR strategy. ``` **输出**：变更的信号/噪声分析、提交拆分计划、分支命名建议、PR 描述草稿 ##### 提交拆分 ``` /Guardian I have changes across 47 files. Split them into appropriately granular commits. ``` **输出**：按逻辑单元的提交拆分计划、示例 git add 命令 ##### 分支命名 ``` /Guardian Suggest a branch name for the task "Add OAuth2 to user authentication". ``` **输出**：符合约定的分支名称候选（如 feat/oauth2-integration） **Guardian 与 Judge 与 Zen 职责分工**： - **Guardian**：PR 准备（变更分析、提交结构、分支命名） - **Judge**：PR 审查（Bug 检测、问题识别） - **Zen**：代码修复（重构、质量提升） ##### 周报 ``` /Harvest Summarize this week's PR activity into a report. ``` **输出**：包含 PR 统计、类别分布、贡献者排名和亮点的 Markdown 报告 ##### 发布说明生成 ``` /Harvest Generate release notes from PRs between v1.1.0 and v1.2.0. ``` **输出**：按 Features/Bug Fixes/Improvements/Breaking Changes 分类的 Changelog 格式发布说明 ##### 个人工作报告 ``` /Harvest Create a monthly work report for @username. ``` **输出**：特定用户的详细 PR 活动、类别细分、周趋势、亮点 #### 质量保证 ##### 测试添加 ``` /Radar Check test coverage for this area and add missing tests. ``` **输出**：添加的边界情况测试、边界值测试和错误情况测试 ##### E2E 测试创建 ``` /Voyager Create E2E tests for the flow from login to purchase completion. ``` **输出**：Playwright/Cypress E2E 测试代码（含 Page Object Model 设计、认证状态管理、CI 集成配置） ##### 安全审计 ``` /Sentinel Audit the security of this API. ``` **输出**：漏洞检测（SQL 注入、XSS 等）和修复代码 ##### PR 审查 ``` /Judge Review this PR. Check for bugs and security issues. ``` **输出**：通过 codex review 自动化审查、按严重性排序的问题列表、建议修复 agent ##### 预提交检查 ``` /Judge Review the changes before committing. ``` **输出**：未提交变更审查、Bug/安全问题检测、提交放行/阻止决策 ##### 重构 ``` /Zen This file has poor readability. Please refactor it. ``` **输出**：按职责拆分的可读代码（行为不变） **注意**：审查 agent 职责： - **Judge**：通过 codex review 进行 PR 审查、Bug 检测、AI 幻觉检测（不修改代码） - **Zen**：代码质量**提升**（重构、可读性增强） ##### YAGNI 验证 ``` /Void Is this helper utility really needed? It was added 6 months ago but I'm not sure anyone uses it. ``` **输出**：削减提案，包含保留成本评分、影响半径分析和 REMOVE/SIMPLIFY/DEFER/KEEP 建议 #### 实现 ##### 生产实现 ``` /Builder The prototype works, but please bring it up to production quality. ``` **输出**：添加了类型安全、错误处理和验证的生产代码 **Builder 能力**： - **澄清阶段**：检测规格模糊性，呈现问题或多种提案 - **设计阶段**：TDD（测试优先设计） - **构建阶段**：Event Sourcing / CQRS / Saga 模式支持 - **验证阶段**：N+1 检测、缓存策略、性能优化 - **Forge 交接**：types.ts > Value Object, errors.ts > DomainError, forge-insights.md > Business Rules ##### 原型制作 ``` /Forge Create a prototype of this screen. A working state is fine for now. ``` **输出**：快速构建的使用模拟数据的 UI 组件 ##### 前端实现 ``` /Artisan Bring the user profile prototype created by Forge to production quality. Ensure TypeScript strict mode, proper error handling, and accessibility. ``` **输出**：类型安全、生产质量的 React/Vue/Svelte 组件、自定义 Hooks、状态管理集成 **Artisan 的关键领域**： - **Hooks 设计**：自定义 Hook 创建、正确的 useEffect/useMemo 使用 - **状态管理**：Zustand/Jotai/Redux Toolkit 选择和实现 - **Server Components**：React 19/Next.js App Router 中的服务器/客户端分离 - **表单处理**：React Hook Form + Zod 验证 - **数据获取**：使用 TanStack Query/SWR 的缓存策略 #### 性能 ##### 性能提升 ``` /Bolt This page loads slowly. Please improve it. ``` **输出**：瓶颈识别和优化（记忆化、懒加载、查询改进等） **Bolt 的范围**： - **前端**：减少重渲染、React.memo/useMemo、懒加载、包大小 - **后端**：N+1 检测、DataLoader 引入、连接池、异步处理 ##### DB 性能优化 ``` /Tuner The product listing page query is slow. Analyze with EXPLAIN ANALYZE and optimize. ``` **输出**：执行计划分析、索引建议、查询重写 **Bolt 与 Tuner 职责分工**： - **Bolt**：应用层（如何发出查询、缓存） - **Tuner**：数据库层（如何执行查询、索引） #### UI/UX ##### 创意方向 ``` /Vision I want to redesign the dashboard with a modern look. The current design feels dated, so incorporate current design trends. ``` **输出**：三个设计方向提案、选定方向的风格指南、对 Muse/Palette/Flow/Forge 的委托计划 ##### 设计审查 ``` /Vision Review the current UI design and identify areas for improvement. ``` **输出**：启发式评估结果、优先级改进列表、每个改进的分配 agent ##### UX 改进 ``` /Palette We received feedback that this form has poor usability. Please improve it. ``` **输出**：反馈改进、认知负荷降低、错误显示改进 ##### 设计统一 ``` /Muse The design lacks consistency. Please unify it. ``` **输出**：统一到设计 Token、间距/圆角/阴影调整 ##### UI 动画 ``` /Flow Add animations to this screen to improve interactions. ``` **输出**：添加适当的过渡、悬停效果、加载动画 ##### 人物画像验证 ``` /Echo Validate this UI's usability from an elderly user persona's perspective. ``` **输出**：从指定人物画像视角的 UX 报告，包含困惑点和改进提案 ##### Storybook Story 创建 ``` /Showcase Create Storybook stories for the newly created Button component. ``` **输出**：CSF 3.0 文件（所有变体、交互测试、自动文档） **Showcase 能力**： - **CREATE**：新组件 story 创建 - **MAINTAIN**：现有 story 更新、CSF3 迁移 - **AUDIT**：Story 覆盖率和质量审计 ##### Storybook 覆盖率审计 ``` /Showcase Audit current Storybook coverage. Identify missing stories. ``` **输出**：覆盖率报告、质量评分、改进行动列表 #### 文档 ##### PRD 创建 ``` /Scribe Create a PRD (Product Requirements Document) for the user authentication feature. Include social login and two-factor authentication in scope. ``` **输出**：完整 PRD（概述、用户故事、功能需求、非功能需求、验收标准、边界情况） ##### SRS 创建 ``` /Scribe Create an SRS (Software Requirements Specification) for the payment module. Stripe integration and subscription support are required. ``` **输出**：完整 SRS（功能需求、数据模型、API 规格、非功能需求、可追溯性矩阵） ##### 实现检查清单创建 ``` /Scribe Create an implementation checklist for the search feature. ``` **输出**：实现前检查、分阶段任务、质量保证检查、部署前验证 ##### 测试规格创建 ``` /Scribe Create a test specification for the order flow. Cover normal cases, error cases, and boundary values comprehensively. ``` **输出**：测试用例列表（ID、优先级、步骤、预期结果）、测试数据、可追溯性 **Scribe 与 Quill 职责分工**： - **Scribe**：项目文档（规格、设计文档、检查清单） - **Quill**：代码文档（JSDoc、README、类型定义） ##### 文档添加 ``` /Quill Add documentation to this function. There's feedback that the logic is hard to understand. ``` **输出**：添加的 JSDoc/TSDoc、使用示例、参数描述 #### 可视化 ##### 图表创建 ``` /Canvas Visualize this authentication flow as a diagram. ``` **输出**：Mermaid 格式的时序图、流程图、状态机图等 ##### 从代码逆向工程图表 ``` /Canvas Visualize the processing flow in src/services/payment/ ``` **输出**：通过分析代码生成的流程图或时序图 ##### 对话上下文组织 ``` /Canvas Organize our conversation so far into a mind map. ``` **输出**：组织对话内容的思维导图 ##### ASCII 艺术图表 ``` /Canvas Create an ASCII art diagram of this API's processing flow. ``` **输出**：可在终端和代码注释中显示的 ASCII 格式流程图 ##### AI 图像生成代码 ``` /Sketch Generate Python code to create product thumbnail images using Gemini API. Include batch generation for multiple products. ``` **输出**：集成 Gemini API 的生产就绪 Python 代码、prompt 优化、批处理、成本估算 ##### 像素艺术生成 ``` /Dot Create a 16x16 player character sprite with 4-frame walk animation. Use a 16-color palette and output as SVG with spritesheet metadata. ``` **输出**：SVG 精灵代码、精灵表布局、动画元数据 JSON、调色板定义 **Canvas 与 Sketch 与 Dot 职责分工**： - **Canvas**：图表和示意图（Mermaid、ASCII 艺术、draw.io） - **Sketch**：AI 图像生成代码（Gemini API 的 Python 代码） - **Dot**：通过代码生成像素艺术（SVG/Canvas/Phaser 3/Pillow/CSS 精灵） - **Clay**：AI 3D 模型生成代码（Meshy/Tripo/Hunyuan3D/Rodin/Sloyd/Stability API 的 Python/JS/OpenSCAD） ##### NotebookLM Prompt 设计 ``` /Prism I want to create an engaging podcast-style audio overview of our API documentation using NotebookLM. Help me design the optimal steering prompt. ``` **输出**：优化的转向 prompt、源准备建议、输出格式建议 #### 架构 ##### 架构分析 ``` /Atlas Analyze code dependencies and clarify the impact scope of changes. ``` **输出**：依赖图、问题区域识别、ADR/RFC 改进建议 ##### 现代化 ``` /Horizon Check library versions in use and identify deprecated or vulnerable ones. ``` **输出**：废弃库检测、替代提案、迁移 PoC ##### API 设计 ``` /Gateway Design user management API endpoints. Follow REST API best practices. ``` **输出**：OpenAPI 规格、端点设计、版本策略 ##### API 破坏性变更检测 ``` /Gateway Check if this PR's changes break API backward compatibility. ``` **输出**：破坏性变更列表、受影响客户端、迁移指南 #### 数据 ##### DB Schema 设计 ``` /Schema Design a DB schema for the order management system. Consider relationships between orders, line items, customers, and products. ``` **输出**：ER 图（Mermaid 格式）、DDL、迁移文件、索引设计 **Schema 与 Tuner 职责分工**： - **Schema**：逻辑设计（表结构、关系、规范化） - **Tuner**：物理优化（索引调优、查询改进） ##### 迁移创建 ``` /Schema Create a migration to add a profile image URL to the users table. ``` **输出**：Up/Down 迁移、回滚程序 #### DevOps ##### CLI/TUI 构建 ``` /Anvil Create a command-line tool. Include help display, progress bars, etc. ``` **输出**：带有参数解析、帮助生成、进度条、彩色输出的 CLI ##### CI/CD 改进 ``` /Gear CI execution time is too long. Please reduce it. ``` **输出**：缓存优化、并行化、移除不必要步骤 ##### 基础设施设置 ``` /Scaffold Create Terraform configuration for building a staging environment on AWS. ``` **输出**：Terraform/CloudFormation/Pulumi 配置文件、环境变量模板 ##### 个人开发环境设置 ``` /Hearth Optimize my zsh configuration. It's slow to start up and I want better completions. ``` **输出**：优化的 .zshrc，包含启动分析、懒加载插件和补全配置 ##### Dotfile 管理 ``` /Hearth Set up my neovim configuration with LSP support and lazy.nvim plugin management. ``` **输出**：init.lua 结构、lazy.nvim 设置、LSP 配置、键绑定 **Hearth 与 Gear 与 Scaffold 职责分工**： - **Hearth**：个人环境（dotfiles、shell、编辑器、终端） - **Gear**：项目级 DevOps（CI/CD、Docker、监控、Git hooks） - **Scaffold**：基础设施供应（云、Docker Compose、IaC） - **Latch**：Claude Code 事件 hooks（settings.json hooks 用于工作流自动化） - **Pipe**：GitHub Actions 工作流设计（触发器、安全、性能、PR 自动化） ##### GitHub Actions 工作流设计 ``` /Pipe Design a CI/CD workflow for this monorepo. We need path-based triggers, parallel jobs for each package, and SHA-pinned actions. ``` **输出**：带有路径过滤器、作业依赖图、安全加固权限、缓存策略的 GitHub Actions 工作流 YAML ##### CI 安全加固 ``` /Pipe Audit our GitHub Actions workflows for security issues. Check permissions, action pinning, and secret handling. ``` **输出**：安全审计报告、带有 SHA 固定 action 的修复计划、最小权限配置、OIDC 建议 ##### Claude Code Hook 设置 ``` /Latch Add a hook to prevent writing to .env files and run tests before stopping. ``` **输出**：settings.json 中的 Hook 配置（PreToolUse 用于文件保护、Stop 用于测试强制）、备份创建、重启提醒 ##### Hook 调试 ``` /Latch My PreToolUse hook isn't firing. Help me debug it. ``` **输出**：诊断检查清单、`claude --debug` 分析、手动测试命令、修复建议 ##### 本地开发环境设置 ``` /Scaffold Set up a Docker Compose environment so new developers can start immediately. ``` **输出**：docker-compose.yml、.env.example、设置脚本 #### 通信 ##### Slack Bot 开发 ``` /Relay Build a Slack bot that responds to /remind commands and sends scheduled reminders. Support thread replies and slash commands. ``` **输出**：频道适配器设计、命令解析器规格、webhook 处理器中间件链、事件路由矩阵 ##### 多渠道通知 ``` /Relay Design a notification system that sends alerts to both Slack and Discord. Each platform should display messages in its native format. ``` **输出**：统一消息 Schema、平台特定适配器、扇出路由设计 **Relay 与 Gateway 与 Stream 职责分工**： - **Relay**：消息平台集成（频道适配器、webhook、WebSocket、机器人） - **Gateway**：REST/GraphQL API 设计（OpenAPI 规格、版本控制、端点） - **Stream**：数据管道（ETL/ELT、Kafka、Airflow、批处理） #### 国际化 ##### i18n 实现 ``` /Polyglot Internationalize the application for global expansion. ``` **输出**：硬编码字符串转换为 i18n、日期/货币格式国际化 #### 增长 ##### SEO 改进 ``` /Growth Improve the preview display when sharing on social media. ``` **输出**：添加 OGP 标签、meta 信息、结构化数据 ##### 留存举措 ``` /Retain User retention rates are declining. Suggest retention improvement strategies. ``` **输出**：留存分析框架、重新参与触发器设计、游戏化提案 #### 分析 ##### 指标设计 ``` /Pulse Define KPIs for this service and design tracking events. ``` **输出**：KPI 定义、事件设计、仪表板规格 ##### A/B 测试设计 ``` /Experiment Design an A/B test to verify the effect of changing the CTA button color. ``` **输出**：假设文档、样本量计算、功能开关实现指南 #### 运维 ##### 事故响应 ``` /Triage API responses are slow in production. Please handle initial response. ``` **输出**：影响评估、恢复程序、升级决策 ##### 复盘创建 ``` /Triage Create a postmortem for the recent incident. ``` **输出**：事故时间线、根因、预防措施 #### 调查与规划（附加） ##### 竞争研究 ``` /Compete Analyze competitors A and B and identify differentiation points. ``` **输出**：竞争功能矩阵、SWOT 分析、定位图 ##### 用户研究设计 ``` /Researcher Design user interviews to validate the new feature. ``` **输出**：访谈指南、问题列表、人物画像/旅程图 ##### 反馈分析 ``` /Voice Analyze recent app store reviews and extract insights. ``` **输出**：情感分析、反馈分类、改进优先级列表 #### 安全（附加） ##### 动态安全测试 ``` /Probe Conduct penetration testing on the authentication API. ``` **输出**：OWASP ZAP/Nuclei 扫描结果、漏洞报告、修复优先级 **Sentinel 与 Probe 职责分工**： - **Sentinel**：静态分析（SAST）—— 读取代码检测漏洞 - **Probe**：动态测试（DAST）—— 攻击运行中的应用检测漏洞 #### 终端录制 ##### CLI Demo GIF 创建 ``` /Reel Record a GIF showing installation through basic usage of this CLI tool. I'll embed it in the README. ``` **输出**：VHS .tape 文件、优化 GIF（5MB 以下）、Markdown 嵌入代码 ##### 终端会话录制 ``` /Reel Create a demo video of the interactive setup wizard in action. Include the user selecting options. ``` **输出**：terminalizer 录制、编辑后的 YAML、GIF 输出 **Director 与 Reel 职责分工**： - **Director**：浏览器 demo 视频（Playwright，.webm 输出） - **Reel**：终端 demo 录制（VHS/terminalizer/asciinema，GIF/MP4 输出） #### AITuber/直播 ##### AITuber 管道设置 ``` /Aether Design an AITuber system: YouTube Live chat → LLM response → VOICEVOX TTS → Live2D avatar with lip sync → OBS streaming. ``` **输出**：管道架构、组件配置（Chat 轮询器、LLM 适配器、TTS 设置、虚拟形象控制、OBS WebSocket）、部署指南 ##### 直播自动化 ``` /Aether Set up OBS WebSocket automation for scene switching, BGM control, and chat overlay during AI VTuber streams. ``` **输出**：OBS WebSocket 配置、场景切换逻辑、事件驱动自动化脚本 ### 多 Agent 协作 #### 新功能开发（自动执行） ``` /Nexus I want to add a user profile editing feature - Edit name, email, and avatar image - With validation - Show toast on successful save ## NEXUS_AUTORUN ``` **执行链**：Spark（规格）> Sherpa（任务分解）> Forge（原型）> Builder（生产实现）> Radar（测试）> Quill（文档） #### Bug 修复（复杂案例） ``` /Nexus Investigate and fix a payment error that only occurs in production. It doesn't reproduce locally. ## NEXUS_AUTORUN ``` **执行链**：Scout（调查）> Sherpa（任务分解）> Builder（修复）> Radar（回归测试）> Sentinel（安全验证） #### 大规模重构 ``` /Nexus The authentication module has become spaghetti code. I want to refactor it to follow Clean Architecture. ``` **执行链**：Atlas（架构设计）> Sherpa（分阶段计划）> Zen（重构）> Radar（测试） #### UI 功能添加 ``` /Nexus Add a review submission feature to the product detail page. I want users to be able to input star ratings and comments. ``` **执行链**：Spark（规格）> Forge（UI 原型）> Muse（设计调整）> Builder（实现）> Radar（测试） ### 逐步执行（手动控制） #### 渐进式功能开发 ``` /Nexus I want to add a search feature. ``` #### AUTORUN 模式（自动执行 - 推荐） ``` ## NEXUS_AUTORUN_FULL I want to add a search feature. ``` Nexus 自动执行链： ``` ## Nexus 执行：添加搜索功能 - Chain: **Spark** > **Sherpa** > **Builder** > **Radar** - Mode: AUTORUN_FULL ### 执行步骤 1/4：Spark _AGENT_CONTEXT: Role: Spark Task: Create search feature specification [Creating specification as Spark...] _STEP_COMPLETE: Agent: Spark Status: SUCCESS Next: Sherpa ### 执行步骤 2/4：Sherpa [Automatically proceeding to next step...] ``` **无需复制粘贴** —— 自动执行至最终交付。 #### GUIDED 模式（手动移交） 手动调用每个 agent 时： ``` ## NEXUS_GUIDED I want to add a search feature. ``` Nexus 设计链并呈现下一步： ``` ## Nexus 计划：添加搜索功能 - Chain: **Spark** > **Sherpa** > **Builder** > **Radar** - Current step: 1/4 ### 下一步：Spark Invoke **Spark** with the following context: [Context information] ``` ### 实践中的任务分解 #### 将大任务拆分为小步骤 ``` /Sherpa I want to implement an e-commerce checkout flow. ``` **输出**： ``` ## Sherpa 指南 **Current Objective:** Checkout flow implementation **Progress:** 0/8 steps completed ### NOW：为购物车内容创建类型定义 Define CartItem and CartSummary interfaces. *(Shall I invoke Builder?)* ### 即将到来的路径： - [ ] Create cart API endpoint - [ ] Shipping address input form - [ ] Payment method selection UI - [ ] Order confirmation screen - [ ] Order completion processing - [ ] Error handling - [ ] Add tests **Status:** On Track ``` ## 自定义 ### 添加新 Agent 1. 创建 `skills/[AgentName]/SKILL.md` 2. 在 frontmatter 中定义 `name` 和 `description` 3. 指定边界（Always do / Ask first / Never do） 4. 添加 AUTORUN 支持和 Nexus Hub Mode 部分 ### 修改 Agent 直接编辑每个 `SKILL.md`。格式： ``` --- name: AgentName description: Agent description --- [Detailed agent instructions] ``` ## 许可证 MIT

标签：Agent 编排, AI 智能体, AI 辅助开发, Bug 修复, Claude Code, Codex CLI, DNS解析, Gemini CLI, LLM 应用, PyRIT, TLS抓取, UI/UX 设计, 人工智能, 代码生成, 任务分解, 后端开发, 基础设施, 多智能体系统, 工作流自动化, 开源项目, 提示词工程, 渗透测试工具, 特征检测, 用户模式Hook绕过, 研发效能, 策略决策点, 自动化编程, 请求拦截, 软件安全, 软件开发