diff --git a/.gitignore b/.gitignore index 7abad05..eb0bcf8 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,3 @@ -# 转换输出目录（由 scripts/convert.sh 生成） -integrations/ +# integrations/ 已移除——预转换文件现在可随仓库提交，方便 curl 一键安装 .claude/ openspec/.DS_Store diff --git a/README.md b/README.md index 5dd7a87..6bfb771 100644 --- a/README.md +++ b/README.md @@ -1,108 +1,59 @@ -# agency-agents 中文版（AI 智能体专家团队） +# agency-agents-yhz — AI 智能体专家团队 -🌐 **简体中文** | [繁體中文](README.zh-TW.md) | [English (upstream)](https://github.com/msitarzewski/agency-agents) +> **180+ 个即插即用的 AI 专家人格，一行命令装好，自然语言激活。** -> **你的 AI 梦之队** — 从前端开发到区块链安全，从小红书运营到抖音策略，每个智能体都是一位拥有独特个性、专业流程和可交付成果的专家。 - -Chinese community edition of [agency-agents](https://github.com/msitarzewski/agency-agents), including full translations and China-platform specific AI agents (Xiaohongshu, Douyin, WeChat, Bilibili, etc.). - -[![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/agency-agents-zh?style=social)](https://github.com/jnMetaCode/agency-agents-zh) +[![GitHub stars](https://img.shields.io/github/stars/Yhazrin/agency-agents-yhz?style=social)](https://github.com/Yhazrin/agency-agents-yhz) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com) -[![QQ群](https://img.shields.io/badge/QQ群-833585047-blue?logo=tencentqq)](https://qm.qq.com/q/x8kyqzlfDc) -### 📊 项目规模 - -| 🤖 AI 智能体 | 🌏 英文版翻译 | 🇨🇳 中国市场原创 | 🧠 支持工具 | -|:---:|:---:|:---:|:---:| -| **186** | **142** | **44** | **14 种** | +| 🤖 智能体总数 | 🇨🇳 中国原创 | 🌏 翻译自上游 | 🧠 支持工具 | 📦 工作流模板 | +|:---:|:---:|:---:|:---:|:---:| +| **186** | **45** | **141** | **12 种** | **7 个** | --- -## 这是什么？ - -**186 个即插即用的 AI 专家人格**——每个都有独特的专业技能、沟通风格和可落地的工作流，不是通用模板。 - -### 🤝 多智能体协作 - -单个角色很强，但多个角色**协作**更强。[Agency Orchestrator](https://github.com/jnMetaCode/agency-orchestrator) 是配套的多智能体编排引擎——用 YAML 定义工作流，自动调度角色协作： +## 一分钟上手 ```bash -npm install agency-orchestrator -npx ao run workflows/story-creation.yaml --input premise='你的创意' -``` - +curl -fsSL https://raw.githubusercontent.com/Yhazrin/agency-agents-yhz/main/setup.sh | bash ``` -叙事学家 ──→ 心理学家 ──→ 内容创作者 - └→ 叙事设计师 ──┘ - (自动并行) -``` - -支持 DeepSeek / Claude / OpenAI / Ollama，零代码，写 YAML 就能编排 186 个角色。[了解更多 →](https://github.com/jnMetaCode/agency-orchestrator) - ---- -## 快速开始 +脚本会自动检测你装了哪些 AI 工具 → 转换格式 → 安装到位 → 打开引导页。 -### 方式一：一键安装到你的 AI 工具 +装完之后，用自然语言激活： -支持 **14 种主流 AI 编程工具**，一条命令搞定： - -```bash -# 自动检测已安装的工具，一键安装 -./scripts/install.sh - -# 或指定安装到特定工具 -./scripts/install.sh --tool claude-code # Claude Code -./scripts/install.sh --tool copilot # GitHub Copilot -./scripts/install.sh --tool cursor # Cursor -./scripts/install.sh --tool kiro # Kiro (Amazon) -./scripts/install.sh --tool trae # Trae -./scripts/install.sh --tool openclaw # OpenClaw -./scripts/install.sh --tool opencode # OpenCode -./scripts/install.sh --tool aider # Aider -./scripts/install.sh --tool windsurf # Windsurf -./scripts/install.sh --tool antigravity # Antigravity -./scripts/install.sh --tool gemini-cli # Gemini CLI -./scripts/install.sh --tool qwen # Qwen Code -./scripts/install.sh --tool codex # Codex CLI -./scripts/install.sh --tool deerflow # DeerFlow 2.0 (ByteDance) ``` - -> Claude Code 和 GitHub Copilot 可直接安装；其他工具需先运行 `./scripts/convert.sh` 转换格式。 - -### 🔥 OpenClaw 用户快速上手 - -OpenClaw 需要先转换格式再安装（上方方式一仅安装，这里是完整两步）： - -```bash -./scripts/convert.sh --tool openclaw # 第一步：转换为 SOUL.md 格式 -./scripts/install.sh --tool openclaw # 第二步：安装到 ~/.openclaw/ +激活前端开发者模式，帮我审查这个 React 组件。 +作为小红书运营专家，帮我写一篇种草笔记。 +用代码审查员智能体，检查一下这个 PR。 ``` -每个智能体会生成三个文件：`SOUL.md`（身份人设）+ `AGENTS.md`（业务能力）+ `IDENTITY.md`（简介），支持多智能体协作编排。 - -### 方式二：手动复制 +> 手动安装或查看各工具配置，见 **[快速上手](docs/QUICKSTART.md)** · **[工具集成指南](docs/TOOLS-GUIDE.md)** · **[速查表](docs/CHEATSHEET.md)** -```bash -# Claude Code / GitHub Copilot（直接复制即可） -cp -r marketing/*.md ~/.claude/agents/ +--- -# 在 Claude Code 中激活： -# "激活前端开发者模式，帮我构建一个 React 组件" -``` +## 这个 fork 做了什么 -### 方式三：作为提示词参考 +基于 [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents)（英文原版）和 [jnMetaCode/agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)（中文社区版），本 fork 重点改进上手体验： -浏览下方智能体列表，复制/改编你需要的内容！ +| 功能 | 说明 | +|------|------| +| **一行 curl 安装** | 自动检测工具、转换格式、安装，打开 Web 引导 | +| **12 种工具支持** | Claude Code、Copilot、Cursor、Trae、OpenClaw、OpenCode、Aider、Windsurf、Gemini CLI、Antigravity、Qwen Code、Codex | +| **Web 引导页** | 安装后自动打开 `guide.html`，深色/浅色自适应 | +| **工作流模板** | 7 个实战工作流（代码审查、小红书推广、产品 MVP 等） | +| **多智能体协作** | 预定义组合工作流（`workflows/`），多人协作一气呵成 | +| **智能体搜索** | `search-agents.sh "关键词"` 快速找到你要的智能体 | +| **上游同步** | `sync-upstream.sh` 自动拉取上游新增的英文智能体 | +| **速查表** | `docs/CHEATSHEET.md` — 最常用 10 个智能体 + 复制即用 prompt | --- ## 智能体阵容 -### 🛠️ 工程部 +> ⭐ = 本项目原创，更贴合国内实操。其余为上游英文版翻译。 -构建未来，一个 commit 一个脚印。 +
+🛠️ 工程部（28 个） | 智能体 | 专长 | 适用场景 | |--------|------|----------| @@ -133,650 +84,127 @@ cp -r marketing/*.md ~/.claude/agents/ | [AI 数据修复工程师](engineering/engineering-ai-data-remediation-engineer.md) | 自愈管道、SLM 语义聚类、零数据丢失 | 大规模数据异常修复 | | [飞书集成开发工程师](engineering/engineering-feishu-integration-developer.md) ⭐ | 飞书机器人、审批流、多维表格 | 飞书生态集成开发 | | [钉钉集成开发工程师](engineering/engineering-dingtalk-integration-developer.md) ⭐ | 钉钉机器人、酷应用、连接器 | 钉钉生态集成开发 | - -### 🎨 设计部 - -让产品好看、好用、有惊喜。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [UI 设计师](design/design-ui-designer.md) | 视觉设计、组件库、设计系统 | 界面设计、品牌一致性 | -| [UX 研究员](design/design-ux-researcher.md) | 用户测试、行为分析 | 用户研究、可用性测试 | -| [UX 架构师](design/design-ux-architect.md) | 信息架构、交互设计、导航系统 | 复杂产品的 UX 架构 | -| [品牌守护者](design/design-brand-guardian.md) | 品牌标识、一致性、定位 | 品牌策略、视觉规范 | -| [图像提示词工程师](design/design-image-prompt-engineer.md) | AI 图像生成、提示词优化 | Midjourney/DALL-E 出图 | -| [视觉叙事师](design/design-visual-storyteller.md) | 数据可视化、视觉叙事 | 信息图、演示文稿 | -| [趣味注入师](design/design-whimsy-injector.md) | 微交互、彩蛋、趣味元素 | 产品细节体验提升 | -| [包容性视觉专家](design/design-inclusive-visuals-specialist.md) | 多元化视觉、无障碍设计 | 包容性设计、全球化视觉 | - -### 📢 营销部 - -一个真实互动一个粉丝地增长。 - -**国内平台：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [小红书运营](marketing/marketing-xiaohongshu-operator.md) ⭐ | 种草笔记、达人合作、爆款内容 | 小红书获客、品牌种草 | -| [抖音策略师](marketing/marketing-douyin-strategist.md) ⭐ | 短视频策划、算法优化、直播带货 | 抖音增长、短视频营销 | -| [微信公众号运营](marketing/marketing-wechat-operator.md) ⭐ | 公众号内容、社群运营、裂变增长 | 微信生态营销 | -| [B站内容策略师](marketing/marketing-bilibili-strategist.md) ⭐ | UP主运营、弹幕文化、中长视频 | B站内容增长、品牌合作 | -| [快手策略师](marketing/marketing-kuaishou-strategist.md) ⭐ | 下沉市场、老铁文化、直播电商 | 快手运营、社区信任 | -| [中国电商运营师](marketing/marketing-china-ecommerce-operator.md) | 淘宝/拼多多/京东、广告投放、大促作战 | 电商全链路深度运营 | -| [电商运营师](marketing/marketing-ecommerce-operator.md) ⭐ | 淘宝/拼多多/京东、直播带货、大促 | 电商全平台运营（简洁版） | -| [百度 SEO 专家](marketing/marketing-baidu-seo-specialist.md) ⭐ | 百度优化、百科/知道/贴吧生态 | 百度搜索营销 | -| [私域流量运营师](marketing/marketing-private-domain-operator.md) ⭐ | 企微SCRM、社群运营、用户生命周期 | 私域体系搭建、复购增长 | -| [直播电商主播教练](marketing/marketing-livestream-commerce-coach.md) ⭐ | 直播话术、选品排品、千川投放 | 直播带货、主播孵化 | -| [跨境电商运营专家](marketing/marketing-cross-border-ecommerce.md) ⭐ | Amazon/Shopee/Lazada、海外仓、品牌出海 | 跨境电商全链路运营 | -| [短视频剪辑指导师](marketing/marketing-short-video-editing-coach.md) ⭐ | 剪映/PR/达芬奇、调色、音频、特效 | 短视频剪辑技术指导 | -| [微博运营策略师](marketing/marketing-weibo-strategist.md) ⭐ | 热搜运营、超话、舆情公关、粉丝经济 | 微博全链路运营 | -| [播客内容策略师](marketing/marketing-podcast-strategist.md) ⭐ | 小宇宙/喜马拉雅、音频制作、商业化 | 播客内容创作与增长 | -| [微信视频号运营策略师](marketing/marketing-weixin-channels-strategist.md) ⭐ | 视频号直播、社交裂变、私域闭环 | 视频号运营与变现 | -| [知识付费产品策划师](marketing/marketing-knowledge-commerce-strategist.md) ⭐ | 得到/知识星球/小鹅通、内容定价 | 知识付费产品运营 | -| [小红书专家](marketing/marketing-xiaohongshu-specialist.md) | 生活方式内容、趋势策略 | 小红书品牌建设 | -| [微信公众号管理](marketing/marketing-wechat-official-account.md) | 订阅者运营、内容营销 | 微信公众号增长 | -| [知乎策略师](marketing/marketing-zhihu-strategist.md) | 知识型内容、思想领袖建设 | 知乎品牌权威 | - -> ⭐ 标记的是本项目原创，更贴合国内实操。其余为上游英文版翻译。 - -**出海营销：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [TikTok 策略师](marketing/marketing-tiktok-strategist.md) | 病毒式内容、算法优化 | 出海短视频营销 | -| [Twitter 互动官](marketing/marketing-twitter-engager.md) | 实时互动、思想领袖 | 出海品牌社交 | -| [Instagram 策展师](marketing/marketing-instagram-curator.md) | 视觉叙事、社区运营 | 出海视觉营销 | -| [Reddit 社区运营](marketing/marketing-reddit-community-builder.md) | 社区文化、真实互动 | 出海社区营销 | -| [应用商店优化师](marketing/marketing-app-store-optimizer.md) | ASO、转化优化 | App 出海推广 | - -**通用：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [增长黑客](marketing/marketing-growth-hacker.md) | 快速获客、病毒循环、实验 | 用户增长、转化优化 | -| [内容创作者](marketing/marketing-content-creator.md) | 多平台内容、编辑日历 | 内容策略、品牌故事 | -| [社交媒体策略师](marketing/marketing-social-media-strategist.md) | 跨平台策略、整合营销 | 全渠道社交运营 | -| [SEO 专家](marketing/marketing-seo-specialist.md) | 搜索引擎优化、技术 SEO | Google SEO、内容优化 | -| [轮播图增长引擎](marketing/marketing-carousel-growth-engine.md) | 轮播图内容、自动化投放 | 社交媒体轮播素材 | -| [LinkedIn 内容创作专家](marketing/marketing-linkedin-content-creator.md) | LinkedIn 职场内容、B2B 获客 | LinkedIn 品牌建设 | -| [图书联合作者](marketing/marketing-book-co-author.md) | 思想领袖力图书、代笔协作 | 图书策划与撰写 | - -### 💰 付费媒体部 - -精准投放，每一分预算都花在刀刃上。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [付费媒体审计师](paid-media/paid-media-auditor.md) | 广告账户审计、预算优化 | 广告效果诊断、降本增效 | -| [广告创意策略师](paid-media/paid-media-creative-strategist.md) | 广告素材策划、A/B 测试 | 广告创意优化 | -| [社交广告策略师](paid-media/paid-media-paid-social-strategist.md) | 社交平台广告投放 | Meta/TikTok/LinkedIn 广告 | -| [PPC 竞价策略师](paid-media/paid-media-ppc-strategist.md) | 搜索竞价、关键词管理 | Google Ads、百度推广 | -| [程序化广告采买专家](paid-media/paid-media-programmatic-buyer.md) | DSP、RTB、程序化购买 | 程序化广告投放 | -| [搜索词分析师](paid-media/paid-media-search-query-analyst.md) | 搜索词挖掘、否词优化 | 搜索广告精细化运营 | -| [追踪与归因专家](paid-media/paid-media-tracking-specialist.md) | 转化追踪、归因模型 | 广告效果衡量、数据打通 | - -### 💼 销售部 - -从线索到成交，让每一单都有章法。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [客户拓展策略师](sales/sales-account-strategist.md) | 大客户拓展、ABM 策略 | 重点客户攻关 | -| [销售教练](sales/sales-coach.md) | 销售辅导、技能提升 | 团队销售能力建设 | -| [赢单策略师](sales/sales-deal-strategist.md) | 成交策略、MEDDPICC | 复杂销售推进 | -| [Discovery 教练](sales/sales-discovery-coach.md) | 需求挖掘、客户洞察 | 销售前期沟通 | -| [售前工程师](sales/sales-engineer.md) | 技术方案、Demo 演示 | 技术售前支持 | -| [Outbound 策略师](sales/sales-outbound-strategist.md) | 外呼策略、Cold outreach | 新客户开拓 | -| [Pipeline 分析师](sales/sales-pipeline-analyst.md) | 销售漏斗、预测分析 | 销售数据分析、预测 | -| [投标策略师](sales/sales-proposal-strategist.md) | 投标方案、提案撰写 | 招投标、方案竞标 | - -### 🏦 金融部 - -让每一笔钱都清清楚楚。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [财务预测分析师](finance/finance-financial-forecaster.md) ⭐ | 收入预测、场景建模、现金流 | SaaS 财务规划、融资对接 | -| [发票管理专家](finance/finance-invoice-manager.md) ⭐ | 增值税发票、金税系统、三单匹配 | 发票全生命周期管理 | -| [金融风控分析师](finance/finance-fraud-detector.md) ⭐ | 交易风控、反洗钱、电信诈骗 | 支付风控、合规审查 | - -### 👔 人力资源部 - -找对人、用好人、留住人。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [招聘专家](hr/hr-recruiter.md) ⭐ | Boss直聘/猎聘、校招社招、背调 | 招聘全流程管理 | -| [绩效管理专家](hr/hr-performance-reviewer.md) ⭐ | OKR/KPI、361分布、晋升答辩 | 绩效体系搭建与评估 | - -### ⚖️ 法务部 - -合规是底线，风控是生命线。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [合同审查专家](legal/legal-contract-reviewer.md) ⭐ | 民法典合同编、电子签章、风险评估 | 合同审查与风控 | -| [制度文件撰写专家](legal/legal-policy-writer.md) ⭐ | PIPL/数据安全法、隐私政策 | 合规制度与政策撰写 | - -### 🚚 供应链部 - -从工厂到用户，每一环都不掉链子。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [库存预测专家](supply-chain/supply-chain-inventory-forecaster.md) ⭐ | 需求预测、安全库存、618/双11备货 | 库存管理与补货优化 | -| [供应商评估专家](supply-chain/supply-chain-vendor-evaluator.md) ⭐ | 1688供应商、验厂、国标质检 | 供应商准入与分级管理 | -| [物流路线优化师](supply-chain/supply-chain-route-optimizer.md) ⭐ | 顺丰/通达系、冷链、跨境物流 | 物流成本优化与路线规划 | - -### 📦 产品部 - -在正确的时间做正确的事。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [Sprint 排序师](product/product-sprint-prioritizer.md) | 敏捷规划、功能优先级 | Sprint 规划、资源分配 | -| [趋势研究员](product/product-trend-researcher.md) | 市场情报、竞品分析 | 市场调研、机会评估 | -| [反馈分析师](product/product-feedback-synthesizer.md) | 用户反馈分析、洞察提取 | 反馈分析、产品优先级 | -| [行为助推引擎](product/product-behavioral-nudge-engine.md) | 行为心理学、用户引导 | 用户行为设计、转化提升 | -| [产品经理](product/product-manager.md) | 产品全生命周期、PRD、路线图 | 产品策略与交付管理 | - -### 📋 项目管理部 - -让项目按时按质交付。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [高级项目经理](project-management/project-manager-senior.md) | 需求拆解、范围管控 | 大型项目管理 | -| [项目牧羊人](project-management/project-management-project-shepherd.md) | 跨团队协调、进度跟踪 | 多团队项目协调 | -| [实验追踪员](project-management/project-management-experiment-tracker.md) | A/B 测试、实验管理 | 数据驱动决策 | -| [工作室制片人](project-management/project-management-studio-producer.md) | 创意项目管理、资源调度 | 内容/创意项目 | -| [工作室运营](project-management/project-management-studio-operations.md) | 工作室日常运营管理 | 团队运营效率 | -| [Jira 工作流管家](project-management/project-management-jira-workflow-steward.md) | Jira 配置、工作流优化 | Jira 项目管理 | - -### 🧪 测试部 - -打破一切，让用户不必承受。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [证据收集者](testing/testing-evidence-collector.md) | 截图 QA、视觉验证 | UI 测试、Bug 文档 | -| [现实检验者](testing/testing-reality-checker.md) | 证据驱动认证、质量关卡 | 生产就绪评估 | -| [API 测试员](testing/testing-api-tester.md) | API 验证、集成测试 | 接口测试、端点验证 | -| [性能基准师](testing/testing-performance-benchmarker.md) | 性能测试、优化 | 压测、性能调优 | -| [无障碍审核员](testing/testing-accessibility-auditor.md) | WCAG 审核、辅助技术测试 | 无障碍合规、包容性设计 | -| [测试结果分析师](testing/testing-test-results-analyzer.md) | 测试数据分析、质量度量 | 质量趋势、发布决策 | -| [工具评估师](testing/testing-tool-evaluator.md) | 工具选型、功能对比 | 技术选型、工具采购 | -| [工作流优化师](testing/testing-workflow-optimizer.md) | 流程分析、自动化 | 效率提升、流程改进 | -| [嵌入式测试工程师](testing/testing-embedded-qa-engineer.md) ⭐ | HIL 测试、固件自动化测试、EMC 测试 | 嵌入式质量保障、量产测试 | - -### 🤝 支持部 - -运营的中流砥柱。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [客服响应者](support/support-support-responder.md) | 客户服务、工单处理 | 客户支持、用户体验 | -| [数据分析师](support/support-analytics-reporter.md) | 数据分析、仪表盘 | 商业智能、KPI 追踪 | -| [法务合规员](support/support-legal-compliance-checker.md) | 合规审查、法规检查 | 法律合规、风险管理 | -| [高管摘要师](support/support-executive-summary-generator.md) | 业务摘要、战略沟通 | 高管汇报、决策支持 | -| [财务追踪员](support/support-finance-tracker.md) | 财务分析、预算管理 | 财务规划、成本管控 | -| [基础设施运维师](support/support-infrastructure-maintainer.md) | 系统运维、可靠性工程 | 基础设施管理、故障排查 | -| [招聘运营专家](support/support-recruitment-specialist.md) ⭐ | Boss直聘/猎聘、劳动法、校招社招 | 招聘全流程与HR合规 | -| [供应链采购策略师](support/support-supply-chain-strategist.md) ⭐ | 1688采购、质检、供应商管理、ERP | 供应链与采购管理 | - -### 🔬 专项部 - -不走寻常路的专家。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [智能体编排者](specialized/agents-orchestrator.md) | 多智能体协调、工作流管理 | 复杂项目的多智能体协作 | -| [提示词工程师](specialized/prompt-engineer.md) ⭐ | LLM 提示词设计、优化、评测 | 提示词开发、AI 应用优化 | -| [身份信任架构师](specialized/agentic-identity-trust.md) | AI 身份验证、信任框架 | AI 系统安全与信任 | -| [数据整合师](specialized/data-consolidation-agent.md) | 多源数据整合、仪表盘 | 数据汇总与可视化 | -| [LSP 索引工程师](specialized/lsp-index-engineer.md) | 代码智能、语义索引 | 代码导航、IDE 集成 | -| [报告分发师](specialized/report-distribution-agent.md) | 报告分发、多渠道推送 | 自动化报告分发 | -| [销售数据提取师](specialized/sales-data-extraction-agent.md) | 销售数据采集、结构化 | CRM 数据处理 | -| [合规审计师](specialized/compliance-auditor.md) | SOC 2/ISO 27001/HIPAA 合规 | 合规审计、安全认证 | -| [应付账款智能体](specialized/accounts-payable-agent.md) | 发票处理、付款自动化 | 财务流程自动化 | -| [身份图谱操作员](specialized/identity-graph-operator.md) | 身份解析、多源匹配 | 用户身份治理 | -| [文化智能策略师](specialized/specialized-cultural-intelligence-strategist.md) | 文化洞察、跨文化设计 | 全球化产品、本地化策略 | -| [开发者布道师](specialized/specialized-developer-advocate.md) | 开发者关系、DX 工程 | 开发者社区、技术推广 | -| [模型 QA 专家](specialized/specialized-model-qa.md) | ML 模型审计、质量验证 | 模型上线前检查 | -| [ZK 管家](specialized/zk-steward.md) | Zettelkasten 知识管理 | 知识库构建、笔记系统 | -| [区块链安全审计师](specialized/blockchain-security-auditor.md) | 智能合约审计、漏洞检测 | 合约安全、DeFi 审计 | -| [留学规划顾问](specialized/study-abroad-advisor.md) ⭐ | 多国申请策略、选校定位 | 留学规划、文书指导 | -| [政务数字化售前顾问](specialized/government-digital-presales-consultant.md) ⭐ | 方案设计、标书、等保/信创 | 政务ToG项目售前 | -| [企业培训课程设计师](specialized/corporate-training-designer.md) ⭐ | ADDIE/SAM、企业学习平台、TTT | 培训体系搭建与课程开发 | -| [MCP 构建器](specialized/specialized-mcp-builder.md) | MCP 服务器、工具设计、API 集成 | MCP 开发、AI 工具扩展 | -| [文档生成器](specialized/specialized-document-generator.md) | PDF/PPTX/DOCX/XLSX 生成 | 程序化文档创建 | -| [工作流架构师](specialized/specialized-workflow-architect.md) | 工作流树设计、交接契约、故障恢复 | 系统流程规格化 | -| [自动化治理架构师](specialized/automation-governance-architect.md) | 自动化审计、n8n 工作流治理、风险评估 | 业务自动化决策 | -| [Salesforce 架构师](specialized/specialized-salesforce-architect.md) | Salesforce 多云设计、集成、数据模型 | 企业级 Salesforce 架构 | -| [医疗健康营销合规师](specialized/healthcare-marketing-compliance.md) ⭐ | 医疗广告法、NMPA、互联网医疗 | 医疗健康营销合规 | -| [高考志愿填报顾问](specialized/gaokao-college-advisor.md) ⭐ | 平行志愿、位次法、冲稳保策略 | 高考志愿填报规划 | -| [动态定价策略师](specialized/specialized-pricing-optimizer.md) ⭐ | 淘宝/京东/拼多多定价、大促机制 | 电商定价与促销策略 | -| [AI 治理政策专家](specialized/specialized-ai-policy-writer.md) ⭐ | 算法备案、生成式AI管理、伦理审查 | AI 合规与治理框架 | -| [企业风险评估师](specialized/specialized-risk-assessor.md) ⭐ | COSO本土化、国企风控、ESG | 企业风险管理与审计 | -| [会议效率专家](specialized/specialized-meeting-assistant.md) ⭐ | 飞书/钉钉/腾讯会议、OKR周会 | 会议管理与纪要输出 | - -### 🥽 空间计算部 - -构建下一代空间交互体验。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [visionOS 空间工程师](spatial-computing/visionos-spatial-engineer.md) | visionOS、SwiftUI 空间 UI | Apple Vision Pro 开发 | -| [macOS Metal 空间工程师](spatial-computing/macos-spatial-metal-engineer.md) | Metal、GPU 渲染 | macOS 高性能图形 | -| [XR 界面架构师](spatial-computing/xr-interface-architect.md) | 空间 UI 架构、交互设计 | XR 应用界面设计 | -| [XR 沉浸式开发者](spatial-computing/xr-immersive-developer.md) | WebXR、沉浸式体验 | VR/AR 应用开发 | -| [XR 座舱交互专家](spatial-computing/xr-cockpit-interaction-specialist.md) | 座舱 UI、多模态交互 | 汽车/航空 XR 交互 | -| [终端集成专家](spatial-computing/terminal-integration-specialist.md) | 终端模拟、系统集成 | 空间计算终端工具 | - -### 🎮 游戏开发部 - -从独立游戏到 3A 大作，全引擎覆盖。 - -**通用：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [游戏设计师](game-development/game-designer.md) | 游戏机制、系统设计、平衡性 | 游戏核心玩法设计 | -| [关卡设计师](game-development/level-designer.md) | 关卡布局、节奏控制、空间叙事 | 关卡设计、场景构建 | -| [叙事设计师](game-development/narrative-designer.md) | 剧情设计、对话系统、世界观 | 游戏剧情、互动叙事 | -| [技术美术](game-development/technical-artist.md) | Shader、渲染管线、美术工具 | 画面效果、性能优化 | -| [游戏音频工程师](game-development/game-audio-engineer.md) | 音效设计、音频引擎、空间音频 | 游戏音效、配乐 | - -**Unity：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [Unity 架构师](game-development/unity/unity-architect.md) | Unity 架构、ECS、性能优化 | Unity 项目架构 | -| [Unity 编辑器工具开发者](game-development/unity/unity-editor-tool-developer.md) | 编辑器扩展、自定义工具 | Unity 工具链开发 | -| [Unity 多人游戏工程师](game-development/unity/unity-multiplayer-engineer.md) | Netcode、同步、网络架构 | Unity 联机游戏 | -| [Unity Shader Graph 美术师](game-development/unity/unity-shader-graph-artist.md) | Shader Graph、URP/HDRP | Unity 视觉效果 | - -**Unreal Engine：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [Unreal 多人游戏架构师](game-development/unreal-engine/unreal-multiplayer-architect.md) | Replication、网络同步 | UE 联机架构 | -| [Unreal 系统工程师](game-development/unreal-engine/unreal-systems-engineer.md) | Gameplay 框架、C++ 系统 | UE 核心系统开发 | -| [Unreal 技术美术](game-development/unreal-engine/unreal-technical-artist.md) | 材质、Niagara、渲染管线 | UE 画面与性能 | -| [Unreal 世界构建师](game-development/unreal-engine/unreal-world-builder.md) | 开放世界、地形、关卡串流 | UE 场景构建 | - -**Blender：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [Blender 插件工程师](game-development/blender/blender-addon-engineer.md) | Python 插件、资源验证、导出自动化 | Blender 管线工具开发 | - -**Godot：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [Godot 游戏脚本开发者](game-development/godot/godot-gameplay-scripter.md) | GDScript、场景树、信号系统 | Godot 游戏逻辑 | -| [Godot 多人游戏工程师](game-development/godot/godot-multiplayer-engineer.md) | MultiplayerAPI、网络同步 | Godot 联机游戏 | -| [Godot Shader 开发者](game-development/godot/godot-shader-developer.md) | Godot Shader Language、视觉效果 | Godot 画面效果 | - -**Roblox Studio：** - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [Roblox 虚拟形象创作者](game-development/roblox-studio/roblox-avatar-creator.md) | 虚拟形象、UGC 资产 | Roblox 角色设计 | -| [Roblox 体验设计师](game-development/roblox-studio/roblox-experience-designer.md) | 体验设计、游戏循环 | Roblox 游戏设计 | -| [Roblox 系统脚本工程师](game-development/roblox-studio/roblox-systems-scripter.md) | Luau 脚本、数据存储 | Roblox 游戏开发 | - -### 📖 学术部 - -为叙事设计、世界构建和文化研究提供学术级支撑。 - -| 智能体 | 专长 | 适用场景 | -|--------|------|----------| -| [人类学家](academic/academic-anthropologist.md) | 文化体系、仪式、民族志 | 世界观设计、文化构建 | -| [地理学家](academic/academic-geographer.md) | 自然与人文地理、空间分析 | 地图构建、场景设计 | -| [历史学家](academic/academic-historian.md) | 历史分析、史料考证 | 历史题材验证、年代设定 | -| [叙事学家](academic/academic-narratologist.md) | 叙事理论、故事结构 | 剧情设计、角色弧线 | -| [心理学家](academic/academic-psychologist.md) | 行为心理、人格理论 | 角色心理塑造、动机设计 | -| [学习规划师](academic/academic-study-planner.md) ⭐ | 考研/考公/法考备考、学习方法论 | 个性化学习计划与备考规划 | - -### 🎯 战略部 - -从发现到运营的全流程战略指导。详见 [strategy/](strategy/) 目录。 - -| 文档 | 内容 | -|------|------| -| [高管简报](strategy/EXECUTIVE-BRIEF.md) | NEXUS 战略概览 | -| [快速上手](strategy/QUICKSTART.md) | 5 分钟上手指南 | -| [完整战略](strategy/nexus-strategy.md) | 运营纲领全文 | -| [智能体激活提示词](strategy/coordination/agent-activation-prompts.md) | 各智能体的激活指令 | -| [交接模板](strategy/coordination/handoff-templates.md) | 智能体间的交接规范 | -| Phase 0-6 Playbooks | [发现](strategy/playbooks/phase-0-discovery.md) · [策略](strategy/playbooks/phase-1-strategy.md) · [基础](strategy/playbooks/phase-2-foundation.md) · [构建](strategy/playbooks/phase-3-build.md) · [加固](strategy/playbooks/phase-4-hardening.md) · [上线](strategy/playbooks/phase-5-launch.md) · [运营](strategy/playbooks/phase-6-operate.md) | -| 场景 Runbook | [创业 MVP](strategy/runbooks/scenario-startup-mvp.md) · [企业功能](strategy/runbooks/scenario-enterprise-feature.md) · [事故响应](strategy/runbooks/scenario-incident-response.md) · [营销活动](strategy/runbooks/scenario-marketing-campaign.md) | - ---- - -## 工具集成 - -支持 **14 种主流 AI 编程工具**，通过 `scripts/` 目录下的脚本实现格式转换和一键安装。 - -### 支持的工具 - -| 工具 | 安装位置 | 类型 | -|------|----------|------| -| **Claude Code** | `~/.claude/agents/` | 全局，直接复制 | -| **GitHub Copilot** | `~/.github/agents/` + `~/.copilot/agents/` | 全局，直接复制 | -| **Kiro** (Amazon) | `~/.kiro/agents/` | 全局，需转换 | -| **OpenClaw** | `~/.openclaw/agency-agents/` | 全局，需转换 | -| **Antigravity** | `~/.gemini/antigravity/skills/` | 全局，需转换 | -| **Gemini CLI** | `~/.gemini/extensions/agency-agents/` | 全局，需转换 | -| **Qwen Code** | `.qwen/agents/` | 项目级，需转换 | -| **Cursor** | `.cursor/rules/` | 项目级，需转换 | -| **Trae** | `.trae/rules/` | 项目级，需转换 | -| **OpenCode** | `.opencode/agents/` | 项目级，需转换 | -| **Aider** | `CONVENTIONS.md` | 项目级，需转换 | -| **Windsurf** | `.windsurfrules` | 项目级，需转换 | -| **Codex CLI** | `.codex/agents/` | 项目级，需转换 | -| **DeerFlow 2.0** (字节跳动) | `skills/custom/` | 项目级，需转换 | - -### 使用方法 - -```bash -# 第一步：转换格式（Claude Code 和 GitHub Copilot 可跳过此步） -./scripts/convert.sh # 转换为所有工具格式 -./scripts/convert.sh --tool cursor # 只转换 Cursor 格式 - -# 第二步：安装到本地 -./scripts/install.sh # 自动检测并安装 -./scripts/install.sh --tool cursor # 安装到指定工具 - -# 检查智能体文件格式 -./scripts/lint-agents.sh -``` - -### 各工具安装说明 - -
-Claude Code - -智能体直接从仓库复制到 `~/.claude/agents/`，无需转换。 - -```bash -./scripts/install.sh --tool claude-code -``` - -在 Claude Code 中激活： -``` -激活前端开发者模式，帮我审查这个组件。 -``` -
- -
-GitHub Copilot - -智能体直接从仓库复制到 `~/.github/agents/` 和 `~/.copilot/agents/`，无需转换。 - -```bash -./scripts/install.sh --tool copilot -``` - -在 GitHub Copilot 中激活： -``` -使用前端开发者智能体帮我审查这个组件。 -``` -
- -
-OpenClaw - -OpenClaw 会将每个智能体拆分为三个文件： -- `SOUL.md` — 身份、记忆、沟通风格、关键规则 -- `AGENTS.md` — 核心使命、技术交付物、工作流程 -- `IDENTITY.md` — 名称与简介 - -```bash -./scripts/convert.sh --tool openclaw -./scripts/install.sh --tool openclaw - -# 安装后重启 OpenClaw 网关 -openclaw gateway restart -``` -
- -
-Antigravity (Gemini) - -转换为 Antigravity skill 格式并安装到 `~/.gemini/antigravity/skills/`。 - -```bash -./scripts/convert.sh --tool antigravity -./scripts/install.sh --tool antigravity -```
-Gemini CLI +🎨 设计部（8 个） -转换为 Gemini CLI 扩展格式并安装到 `~/.gemini/extensions/agency-agents/`。 +UI 设计师、UX 研究员、UX 架构师、品牌守护者、图像提示词工程师、视觉叙事师、趣味注入师、包容性视觉专家 -```bash -./scripts/convert.sh --tool gemini-cli -./scripts/install.sh --tool gemini-cli -``` +> 详见 [design/](design/) 目录。
-Qwen Code +📢 营销部（31 个） -转换为 Qwen Code SubAgent 格式并安装到项目目录 `.qwen/agents/`。 +**国内平台：** 小红书运营⭐、抖音策略师⭐、微信公众号运营⭐、B站内容策略师⭐、快手策略师⭐、中国电商运营师、电商运营师⭐、百度 SEO 专家⭐、私域流量运营师⭐、直播电商主播教练⭐、跨境电商运营专家⭐、短视频剪辑指导师⭐、微博运营策略师⭐、播客内容策略师⭐、微信视频号运营策略师⭐、知识付费产品策划师⭐、小红书专家、微信公众号管理、知乎策略师 -```bash -./scripts/convert.sh --tool qwen -cd /your/project -/path/to/agency-agents-zh/scripts/install.sh --tool qwen -``` +**出海营销：** TikTok 策略师、Twitter 互动官、Instagram 策展师、Reddit 社区运营、应用商店优化师 -在 Qwen Code 中激活： -``` -使用前端开发者智能体帮我审查这个组件。 -``` +**通用：** 增长黑客、内容创作者、社交媒体策略师、SEO 专家、轮播图增长引擎、LinkedIn 内容创作专家、图书联合作者 -> 提示：安装后在 Qwen Code 中运行 `/agents manage` 刷新，或重启会话。 +> 详见 [marketing/](marketing/) 目录。
-Cursor - -每个智能体会变成一个 `.mdc` 规则文件，安装到项目目录 `.cursor/rules/`。 - -Cursor 使用 **"智能匹配"模式**（`alwaysApply: false`）：AI 根据每个规则的 `description` 字段自动判断是否相关，相关时自动引用完整内容。 - -**安装：** -```bash -# 第一步：转换格式（在仓库目录运行） -./scripts/convert.sh --tool cursor - -# 第二步：安装到项目（在你的项目目录运行） -cd /your/project -/path/to/agency-agents-zh/scripts/install.sh --tool cursor -``` - -**⚠️ 重要：建议精选安装** - -全部安装 186 个规则会导致 Cursor 需要扫描大量 description 来判断相关性，**可能影响匹配准确度**。推荐做法： - -```bash -# 方法一：全量安装后删除不需要的 -/path/to/agency-agents-zh/scripts/install.sh --tool cursor -# 然后手动删除 .cursor/rules/ 中不需要的 .mdc 文件，保留 10-20 个常用的 - -# 方法二：只复制你需要的智能体（转换后） -./scripts/convert.sh --tool cursor -mkdir -p /your/project/.cursor/rules -cp integrations/cursor/rules/engineering-frontend-developer.mdc /your/project/.cursor/rules/ -cp integrations/cursor/rules/engineering-code-reviewer.mdc /your/project/.cursor/rules/ -# ... 按需复制 -``` +💰 付费媒体部（7 个） -**安装后如何使用：** +付费媒体审计师、广告创意策略师、社交广告策略师、PPC 竞价策略师、程序化广告采买专家、搜索词分析师、追踪与归因专家 -1. 安装后 `.cursor/rules/` 中的 `.mdc` 文件会自动被 Cursor 识别 -2. 在 Chat 或 Composer 中正常提问，Cursor **自动匹配**相关智能体： - ``` - 帮我审查这个组件的性能问题 → 自动匹配前端开发者 - 这段代码有安全漏洞吗 → 自动匹配安全审计员 - ``` -3. 也可以在 **Cursor Settings**（`Cmd+,`）→ **Rules** → **Project Rules** 中查看所有规则 -4. 还可以在 Chat 中用 `@规则名` 手动指定引用某个智能体 - -> **排查**：如果看不到规则，确认 `.cursor/rules/` 在项目根目录、文件扩展名是 `.mdc`、已重新打开项目。 +> 详见 [paid-media/](paid-media/) 目录。
-Trae +💼 销售部（8 个） -转换为 Trae rule 文件并安装到项目目录 `.trae/rules/`。格式与 Cursor 类似。 +客户拓展策略师、销售教练、赢单策略师、Discovery 教练、售前工程师、Outbound 策略师、Pipeline 分析师、投标策略师 -```bash -./scripts/convert.sh --tool trae -cd /your/project -/path/to/agency-agents-zh/scripts/install.sh --tool trae -``` +> 详见 [sales/](sales/) 目录。
-OpenCode - -转换为 OpenCode agent 文件并安装到项目目录 `.opencode/agents/`。 +🏦 金融部（3 个）⭐ · 👔 人力资源部（2 个）⭐ · ⚖️ 法务部（2 个）⭐ · 🚚 供应链部（3 个）⭐ -```bash -./scripts/convert.sh --tool opencode -cd /your/project -/path/to/agency-agents-zh/scripts/install.sh --tool opencode -``` +- **金融：** 财务预测分析师、发票管理专家、金融风控分析师 → [finance/](finance/) +- **HR：** 招聘专家、绩效管理专家 → [hr/](hr/) +- **法务：** 合同审查专家、制度文件撰写专家 → [legal/](legal/) +- **供应链：** 库存预测专家、供应商评估专家、物流路线优化师 → [supply-chain/](supply-chain/)
-Aider - -所有智能体编译为单个 `CONVENTIONS.md` 文件，Aider 会自动读取。 - -```bash -./scripts/convert.sh --tool aider -cd /your/project -/path/to/agency-agents-zh/scripts/install.sh --tool aider -``` +📦 产品部（5 个） · 📋 项目管理部（6 个） · 🧪 测试部（9 个） -在 Aider 会话中激活： -``` -使用前端开发者智能体帮我重构这个组件。 -``` +- **产品：** Sprint 排序师、趋势研究员、反馈分析师、行为助推引擎、产品经理 → [product/](product/) +- **项目管理：** 高级项目经理、项目牧羊人、实验追踪员、工作室制片人、工作室运营、Jira 工作流管家 → [project-management/](project-management/) +- **测试：** 证据收集者、现实检验者、API 测试员、性能基准师、无障碍审核员、测试结果分析师、工具评估师、工作流优化师、嵌入式测试工程师⭐ → [testing/](testing/)
-Windsurf +🤝 支持部（8 个） · 🔬 专项部（30 个） · 🥽 空间计算部（6 个） -所有智能体编译为单个 `.windsurfrules` 文件。 - -```bash -./scripts/convert.sh --tool windsurf -cd /your/project -/path/to/agency-agents-zh/scripts/install.sh --tool windsurf -``` +- **支持：** 客服响应者、数据分析师、法务合规员、高管摘要师、财务追踪员、基础设施运维师、招聘运营专家⭐、供应链采购策略师⭐ → [support/](support/) +- **专项：** 智能体编排者、提示词工程师⭐、身份信任架构师、MCP 构建器、工作流架构师、Salesforce 架构师 等 30 个 → [specialized/](specialized/) +- **空间计算：** visionOS 空间工程师、macOS Metal 空间工程师、XR 界面架构师 等 6 个 → [spatial-computing/](spatial-computing/)
-Codex CLI - -转换为 OpenAI Codex CLI agent 文件（TOML 格式）并安装到项目目录 `.codex/agents/`。 - -```bash -./scripts/convert.sh --tool codex -cd /your/project -/path/to/agency-agents-zh/scripts/install.sh --tool codex -``` +🎮 游戏开发部（17 个） · 📖 学术部（6 个） -在 Codex 中使用时，智能体会作为 subagent 被调用。也可以在 `AGENTS.md` 中引用。 +- **游戏开发：** 通用 5 个 + Unity 4 个 + Unreal 4 个 + Blender 1 个 + Godot 3 个 + Roblox 3 个 → [game-development/](game-development/) +- **学术：** 人类学家、地理学家、历史学家、叙事学家、心理学家、学习规划师⭐ → [academic/](academic/)
-
-Kiro (Amazon) - -Amazon 的 Spec 驱动 AI IDE，基于 Claude 模型。每个智能体转换为 JSON 配置 + 提示词文件，安装到 `~/.kiro/agents/`（全局）。 - -```bash -./scripts/convert.sh --tool kiro -./scripts/install.sh --tool kiro -``` - -在 Kiro 中切换智能体： -``` -/agent swap -``` - -或启动时直接指定： -```bash -kiro-cli --agent engineering-frontend-developer -``` -
+> 完整列表见 [AGENT-LIST.md](AGENT-LIST.md)，战略相关见 [strategy/](strategy/)。 -
-DeerFlow 2.0 (字节跳动) +--- -字节跳动的开源 SuperAgent 框架，支持子代理、沙箱、持久记忆。每个智能体转换为 `SKILL.md` 技能文件。 +## 实战工作流 -```bash -./scripts/convert.sh --tool deerflow -./scripts/install.sh --tool deerflow -``` +不只是单个智能体——预定义的多智能体协作流程： -默认安装到当前目录的 `skills/custom/`。可通过环境变量自定义路径： +| 场景 | 用到的智能体 | 链接 | +|------|------------|------| +| **代码审查** | 代码审查员 + 安全工程师 + 性能基准师 | [查看](examples/workflow-code-review.md) | +| **小红书品牌推广** | 小红书运营 + 内容创作者 + 品牌守护者 + 数据分析师 + 增长黑客 | [查看](examples/workflow-xiaohongshu-launch.md) | +| **出海产品 MVP** | 前端开发者 + 后端架构师 + 快速原型师 + 增长黑客 + 现实检验者 | [查看](examples/workflow-startup-mvp.md) | +| **产品发布全流程** | 产品经理 → 前端 → 后端 → 测试 → 营销 | [查看](workflows/product-launch.md) | +| **营销活动** | 营销策略师 → 内容创作者 → 数据分析师 → 增长黑客 | [查看](workflows/marketing-campaign.md) | -```bash -DEERFLOW_SKILLS_DIR=/path/to/deerflow/skills/custom ./scripts/install.sh --tool deerflow -``` +> 更多工作流见 [examples/](examples/) 和 [workflows/](workflows/) 目录。 -安装后在 DeerFlow 的任务中，相关技能会自动加载。 -
+--- -### 修改智能体后重新生成 +## 搜索智能体 -添加新智能体或编辑现有智能体后，重新生成集成文件： +180+ 个太多了找不到？用搜索脚本： ```bash -./scripts/convert.sh # 重新生成所有工具 -./scripts/convert.sh --tool cursor # 只重新生成指定工具 +./scripts/search-agents.sh "小红书" +./scripts/search-agents.sh "安全" +./scripts/search-agents.sh "React" ``` --- -## 🇨🇳 中国市场原创智能体 +## 工具集成 -除翻译外，本项目包含 **41 个原创智能体**，专为中国平台和业务场景打造。覆盖小红书、抖音、微信、B站、快手、飞书、百度等平台，以及跨境电商、政务ToG、医疗合规等垂直领域。 +支持 **12 种 AI 编程工具**：Claude Code、GitHub Copilot、Cursor、Trae、OpenClaw、OpenCode、Aider、Windsurf、Gemini CLI、Antigravity、Qwen Code、Codex CLI。 -> 在上方智能体阵容中标有 ⭐ 的即为原创智能体。 +详细安装说明见 **[工具集成指南](docs/TOOLS-GUIDE.md)**。 --- -## 实战案例 - -### 场景一：出海产品 MVP - -**你的团队**： -1. **前端开发者** — 构建 React 应用 -2. **后端架构师** — 设计 API 和数据库 -3. **增长黑客** — 规划用户获取 -4. **快速原型师** — 快速迭代 -5. **现实检验者** — 上线前质量把关 +## 实用脚本 -### 场景二：[小红书品牌推广](examples/workflow-xiaohongshu-launch.md)（完整流程） - -**你的团队**： -1. **小红书运营** — 种草内容策略和达人合作 -2. **内容创作者** — 产出种草笔记 -3. **品牌守护者** — 品牌调性把关 -4. **数据分析师** — 追踪投放数据、出复盘报告 -5. **增长黑客** — 设计转化和裂变路径 +| 脚本 | 用途 | +|------|------| +| `setup.sh` | 一键安装（curl 用） | +| `scripts/install.sh` | 安装到指定工具 | +| `scripts/convert.sh` | 转换智能体格式 | +| `scripts/search-agents.sh` | 按关键词搜索智能体 | +| `scripts/create-agent.sh` | 交互式创建自定义智能体 | +| `scripts/sync-upstream.sh` | 同步上游新增智能体 | +| `scripts/lint-agents.sh` | 校验智能体文件格式 | --- @@ -786,45 +214,19 @@ DEERFLOW_SKILLS_DIR=/path/to/deerflow/skills/custom ./scripts/install.sh --tool --- -## 社区交流 - -加入 QQ 群，和其他 AI 智能体实践者一起交流： - -| 群名 | 群号 | 加入方式 | -|------|------|---------| -| AI Agent 中文实践群 | **833585047** | [点击加入](https://qm.qq.com/q/x8kyqzlfDc) | - ---- - -## 姊妹项目 - -| 项目 | 说明 | -|------|------| -| [agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) | 多智能体编排引擎 — 用 YAML 编排 186 个角色协作，支持 DeepSeek/Claude/OpenAI/Ollama，零代码 | -| [superpowers-zh](https://github.com/jnMetaCode/superpowers-zh) | AI 编程超能力 · 中文版 — 20 个 skills，让你的 AI 编程助手真正会干活 | -| [shellward](https://github.com/jnMetaCode/shellward) | AI 智能体安全中间件 — 注入检测、数据防泄露、命令安全、零依赖、MCP Server | - ---- - ## 致谢 - 原始英文版：[msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents)（MIT 协议） -- 感谢原作者 [@msitarzewski](https://github.com/msitarzewski) 创建了这个优秀的项目 +- 中文社区版：[jnMetaCode/agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh) --- -## 许可证 - -MIT License — 自由使用，商业或个人均可。 - ---- +MIT License
-**AI 智能体专家团队：你的 AI 梦之队** - -[Star 本项目](https://github.com/jnMetaCode/agency-agents-zh) · [提交 Issue](https://github.com/jnMetaCode/agency-agents-zh/issues) · [贡献代码](https://github.com/jnMetaCode/agency-agents-zh/pulls) +**agency-agents-yhz：你的 AI 梦之队** -基于 [agency-agents](https://github.com/msitarzewski/agency-agents) 翻译并本土化 +[Star 本项目](https://github.com/Yhazrin/agency-agents-yhz) · [提交 Issue](https://github.com/Yhazrin/agency-agents-yhz/issues) · [贡献代码](https://github.com/Yhazrin/agency-agents-yhz/pulls)
diff --git a/docs/CHEATSHEET.md b/docs/CHEATSHEET.md new file mode 100644 index 0000000..1280b0d --- /dev/null +++ b/docs/CHEATSHEET.md @@ -0,0 +1,117 @@ +# 智能体速查表 + +一页纸速查：最常用的 10 个智能体 + 直接可用的 prompt。复制粘贴，立即生效。 + +--- + +## 使用方式 + +在你的 AI 工具中直接发送以下 prompt，AI 会以对应专家的身份工作。 + +--- + +### 1. 前端开发者 + +``` +作为前端开发者，帮我审查以下 React 组件的代码质量、性能问题和可访问性： + +[粘贴代码] +``` + +### 2. 后端架构师 + +``` +作为后端架构师，帮我设计一个 [描述功能] 的 API 接口，包括数据模型、端点设计和错误处理策略。 +``` + +### 3. 代码审查员 + +``` +作为代码审查员，对以下代码进行全面审查，重点关注：错误处理、安全性、命名规范、性能。 + +[粘贴代码] +``` + +### 4. 小红书运营 + +``` +作为小红书运营专家，为 [产品/品牌] 篇种草笔记，要求： +- 目标人群：[描述] +- 核心卖点：[列出] +- 风格：[真实分享/测评/教程] +``` + +### 5. 数据分析师 + +``` +作为数据分析师，分析以下数据并给出可执行的业务建议： + +[粘贴数据或描述数据集] + +重点关注：趋势、异常值、转化漏斗。 +``` + +### 6. UI 设计师 + +``` +作为 UI 设计师，为 [页面/功能] 设计一套 UI 方案，包括： +- 布局结构 +- 配色方案 +- 组件规范 +- 响应式适配策略 +``` + +### 7. 产品经理 + +``` +作为产品经理，为 [功能名称] 撰写 PRD，包括： +- 用户故事 +- 验收标准 +- 优先级评估 +- 技术依赖 +``` + +### 8. 安全工程师 + +``` +作为安全工程师，对以下 [代码/架构/API] 进行安全审计，检查 OWASP Top 10 漏洞： + +[粘贴代码或描述系统] +``` + +### 9. DevOps 自动化师 + +``` +作为 DevOps 自动化师，帮我为 [项目类型] 设计 CI/CD 流水线，包括： +- 构建步骤 +- 测试策略 +- 部署流程 +- 回滚方案 +``` + +### 10. 内容创作者 + +``` +作为内容创作者，为 [品牌/产品] 制定一个月的内容日历，覆盖 [平台列表]，每周发布 [N] 篇内容。 +目标：[品牌曝光/获客/留存] +``` + +--- + +## 更多智能体 + +完整列表（180 个）： + +```bash +# 搜索智能体 +./scripts/search-agents.sh "关键词" + +# 按部门浏览 +ls engineering/ # 工程（28 个） +ls marketing/ # 营销（31 个） +ls design/ # 设计（8 个） +ls testing/ # 测试（9 个） +ls sales/ # 销售（8 个） +``` + +或查看 [使用指南](../guide.html) 和 [快速上手](QUICKSTART.md)。 diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md new file mode 100644 index 0000000..d7e9aa0 --- /dev/null +++ b/docs/QUICKSTART.md @@ -0,0 +1,117 @@ +# 快速上手 + +3 分钟内让你的 AI 工具拥有 180 个专业智能体。 + +--- + +## 路径 A：一键安装（推荐，1 分钟） + +一行命令，自动检测工具、转换格式、安装完成。 + +**macOS / Linux：** + +```bash +curl -fsSL https://raw.githubusercontent.com/Yhazrin/agency-agents-yhz/main/setup.sh | bash +``` + +**Windows (PowerShell)：** + +```powershell +# 先安装 Git for Windows，然后在 Git Bash 中运行： +curl -fsSL https://raw.githubusercontent.com/Yhazrin/agency-agents-yhz/main/setup.sh | bash +``` + +脚本会自动： +1. 检测你已安装的 AI 工具（Claude Code、Cursor、Copilot 等） +2. 转换智能体格式 +3. 安装到对应工具的目录 +4. 打开使用引导 + +--- + +## 路径 B：手动安装（开发者，2 分钟） + +适合想了解内部流程或需要自定义安装的开发者。 + +```bash +# 1. 克隆仓库 +git clone https://github.com/Yhazrin/agency-agents-yhz.git +cd agency-agents-yhz + +# 2. 转换格式（Claude Code / Copilot 可跳过） +./scripts/convert.sh + +# 3. 安装（自动检测已安装的工具） +./scripts/install.sh + +# 或安装到指定工具 +./scripts/install.sh --tool claude-code +``` + +支持的工具：`claude-code`、`copilot`、`cursor`、`trae`、`opencode`、`openclaw`、`aider`、`windsurf`、`antigravity`、`gemini-cli`、`qwen` + +--- + +## 路径 C：手动复制（非技术用户，5 分钟） + +不需要命令行，直接在 GitHub 上操作。 + +1. 打开 [智能体列表](https://github.com/Yhazrin/agency-agents-yhz) +2. 进入你想用的部门目录（如 `engineering/`、`marketing/`） +3. 打开智能体 `.md` 文件，复制全部内容 +4. 粘贴到你的 AI 工具中作为系统提示词或上下文 + +例如，在 Claude Code 中： +``` +请参考以下专家人格帮我工作： + +[粘贴智能体内容] +``` + +--- + +## 安装后怎么用？ + +安装完成后，在你的 AI 工具中通过自然语言激活智能体： + +``` +激活前端开发者模式，帮我审查这个 React 组件。 +``` + +``` +作为小红书运营专家，帮我写一篇种草笔记。 +``` + +``` +使用代码审查员智能体，检查这个 PR 的安全问题。 +``` + +## 找不到想要的智能体？ + +```bash +# 搜索智能体（支持中英文关键词） +./scripts/search-agents.sh "安全" +./scripts/search-agents.sh "React" +``` + +## 常见问题 + +**Q：安装后智能体没有生效？** +- Claude Code：重启 Claude Code 会话 +- Cursor：重启 Cursor 或重新打开项目 +- 其他工具：检查安装目录是否正确 + +**Q：如何更新智能体？** +```bash +cd agency-agents-yhz +git pull +./scripts/convert.sh +./scripts/install.sh +``` + +**Q：如何只安装部分智能体？** +手动复制你需要的 `.md` 文件到对应目录即可。 + +--- + +更多工具详细配置请参阅 [工具集成指南](TOOLS-GUIDE.md)。 diff --git a/docs/TOOLS-GUIDE.md b/docs/TOOLS-GUIDE.md new file mode 100644 index 0000000..44a095b --- /dev/null +++ b/docs/TOOLS-GUIDE.md @@ -0,0 +1,205 @@ +# 工具集成指南 + +本项目支持 **11 种 AI 编程工具**。本文档提供每种工具的详细安装和配置说明。 + +--- + +## 快速参考 + +| 工具 | 安装位置 | 类型 | +|------|----------|------| +| **Claude Code** | `~/.claude/agents/` | 全局，直接复制 | +| **GitHub Copilot** | `~/.github/agents/` + `~/.copilot/agents/` | 全局，直接复制 | +| **OpenClaw** | `~/.openclaw/agency-agents/` | 全局，需转换 | +| **Antigravity** | `~/.gemini/antigravity/skills/` | 全局，需转换 | +| **Gemini CLI** | `~/.gemini/extensions/agency-agents/` | 全局，需转换 | +| **Qwen Code** | `.qwen/agents/` | 项目级，需转换 | +| **Cursor** | `.cursor/rules/` | 项目级，需转换 | +| **Trae** | `.trae/rules/` | 项目级，需转换 | +| **OpenCode** | `.opencode/agents/` | 项目级，需转换 | +| **Aider** | `CONVENTIONS.md` | 项目级，需转换 | +| **Windsurf** | `.windsurfrules` | 项目级，需转换 | + +## 通用命令 + +```bash +# 转换格式（Claude Code 和 Copilot 可跳过） +./scripts/convert.sh # 所有工具 +./scripts/convert.sh --tool cursor # 仅指定工具 + +# 安装（自动检测或指定工具） +./scripts/install.sh # 自动检测 +./scripts/install.sh --tool claude-code # 指定工具 + +# 检查智能体文件格式 +./scripts/lint-agents.sh + +# 搜索智能体 +./scripts/search-agents.sh "关键词" +``` + +--- + +## Claude Code + +智能体直接从仓库复制到 `~/.claude/agents/`，无需转换。 + +```bash +./scripts/install.sh --tool claude-code +``` + +**激活方式**： +``` +激活前端开发者模式，帮我审查这个组件。 +``` + +**验证**：检查 `~/.claude/agents/` 目录下是否有 `.md` 文件。 + +--- + +## GitHub Copilot + +智能体直接复制到两个目录：`~/.github/agents/` 和 `~/.copilot/agents/`。 + +```bash +./scripts/install.sh --tool copilot +``` + +**激活方式**： +``` +使用前端开发者智能体帮我审查这个组件。 +``` + +--- + +## OpenClaw + +OpenClaw 将每个智能体拆分为三个文件： +- `SOUL.md` — 身份、记忆、沟通风格、关键规则 +- `AGENTS.md` — 核心使命、技术交付物、工作流程 +- `IDENTITY.md` — 名称与简介 + +```bash +./scripts/convert.sh --tool openclaw +./scripts/install.sh --tool openclaw + +# 安装后重启网关 +openclaw gateway restart +``` + +**激活方式**：OpenClaw 支持多智能体协作编排，详见 OpenClaw 文档。 + +--- + +## Antigravity (Gemini) + +转换为 Antigravity skill 格式并安装到 `~/.gemini/antigravity/skills/`。 + +```bash +./scripts/convert.sh --tool antigravity +./scripts/install.sh --tool antigravity +``` + +--- + +## Gemini CLI + +转换为 Gemini CLI 扩展格式并安装到 `~/.gemini/extensions/agency-agents/`。 + +```bash +./scripts/convert.sh --tool gemini-cli +./scripts/install.sh --tool gemini-cli +``` + +--- + +## Qwen Code + +转换为 Qwen Code SubAgent 格式并安装到项目目录 `.qwen/agents/`。 + +```bash +./scripts/convert.sh --tool qwen +cd /your/project +/path/to/agency-agents-yhz/scripts/install.sh --tool qwen +``` + +**激活方式**： +``` +使用前端开发者智能体帮我审查这个组件。 +``` + +> 提示：安装后在 Qwen Code 中运行 `/agents manage` 刷新，或重启会话。 + +--- + +## Cursor + +转换为 Cursor rule 文件（`.mdc`）并安装到项目目录 `.cursor/rules/`。 + +```bash +./scripts/convert.sh --tool cursor +cd /your/project +/path/to/agency-agents-yhz/scripts/install.sh --tool cursor +``` + +--- + +## Trae + +转换为 Trae rule 文件并安装到项目目录 `.trae/rules/`。格式与 Cursor 类似。 + +```bash +./scripts/convert.sh --tool trae +cd /your/project +/path/to/agency-agents-yhz/scripts/install.sh --tool trae +``` + +--- + +## OpenCode + +转换为 OpenCode agent 文件并安装到项目目录 `.opencode/agents/`。 + +```bash +./scripts/convert.sh --tool opencode +cd /your/project +/path/to/agency-agents-yhz/scripts/install.sh --tool opencode +``` + +--- + +## Aider + +所有智能体编译为单个 `CONVENTIONS.md` 文件，Aider 会自动读取。 + +```bash +./scripts/convert.sh --tool aider +cd /your/project +/path/to/agency-agents-yhz/scripts/install.sh --tool aider +``` + +**激活方式**： +``` +使用前端开发者智能体帮我重构这个组件。 +``` + +--- + +## Windsurf + +所有智能体编译为单个 `.windsurfrules` 文件。 + +```bash +./scripts/convert.sh --tool windsurf +cd /your/project +/path/to/agency-agents-yhz/scripts/install.sh --tool windsurf +``` + +--- + +## 修改智能体后重新生成 + +```bash +./scripts/convert.sh # 重新生成所有工具 +./scripts/convert.sh --tool cursor # 只重新生成指定工具 +``` diff --git a/examples/README.md b/examples/README.md index 9887f84..d3c9086 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1,48 +1,19 @@ -# Examples +# 工作流示例 -This directory contains example outputs demonstrating how the agency's agents can be orchestrated together to tackle real-world tasks. +展示如何用多个智能体协作完成真实任务。每个示例包含：用到的智能体、每步的 prompt 模板、预期产出。 -## Why This Exists +## 示例列表 -The agency-agents repo defines dozens of specialized agents across engineering, design, marketing, product, support, spatial computing, and project management. But agent definitions alone don't show what happens when you **deploy them all at once** on a single mission. +| 示例 | 场景 | 智能体数 | 链接 | +|------|------|---------|------| +| 多智能体产品发现 | 8 个智能体并行完成产品发现全流程 | 8 | [查看](nexus-spatial-discovery.md) | +| 代码审查工作流 | PR 提交后的自动化代码审查 | 3 | [查看](workflow-code-review.md) | -These examples answer the question: *"What does it actually look like when the full agency collaborates?"* +## 如何使用这些示例 -## Contents +1. 打开你的 AI 工具（Claude Code、Cursor 等） +2. 复制示例中的 prompt，填入你的具体信息 +3. 按步骤执行，每步的输出就是下一步的输入 +4. 根据实际情况调整 prompt -### [nexus-spatial-discovery.md](./nexus-spatial-discovery.md) - -**What:** A complete product discovery exercise where 8 agents worked in parallel to evaluate a software opportunity and produce a unified plan. - -**The scenario:** Web research identified an opportunity at the intersection of AI agent orchestration and spatial computing. The entire agency was then deployed simultaneously to produce: - -- Market validation and competitive analysis -- Technical architecture (8-service system design with full SQL schema) -- Brand strategy and visual identity -- Go-to-market and growth plan -- Customer support operations blueprint -- UX research plan with personas and journey maps -- 35-week project execution plan with 65 sprint tickets -- Spatial interface architecture specification - -**Agents used:** -| Agent | Role | -|-------|------| -| Product Trend Researcher | Market validation, competitive landscape | -| Backend Architect | System architecture, data model, API design | -| Brand Guardian | Positioning, visual identity, naming | -| Growth Hacker | GTM strategy, pricing, launch plan | -| Support Responder | Support tiers, onboarding, community | -| UX Researcher | Personas, journey maps, design principles | -| Project Shepherd | Phase plan, sprints, risk register | -| XR Interface Architect | Spatial UI specification | - -**Key takeaway:** All 8 agents ran in parallel and produced coherent, cross-referencing plans without coordination overhead. The output demonstrates the agency's ability to go from "find an opportunity" to "here's the full blueprint" in a single session. - -## Adding New Examples - -If you run an interesting multi-agent exercise, consider adding it here. Good examples show: - -- Multiple agents collaborating on a shared objective -- The breadth of the agency's capabilities -- Real-world applicability of the agent definitions +> 提示：不需要严格按顺序执行。你可以根据项目需要跳过某些步骤或调整顺序。 diff --git a/examples/workflow-code-review.md b/examples/workflow-code-review.md new file mode 100644 index 0000000..cc0c5be --- /dev/null +++ b/examples/workflow-code-review.md @@ -0,0 +1,137 @@ +# 多智能体工作流：代码审查 + +> 用 3 个智能体配合，对一个 PR 进行全面的代码审查。 + +## 场景 + +你的团队提交了一个 PR，需要在合并前进行全面审查。审查不仅关注代码正确性，还包括安全性、性能和可维护性。 + +## 智能体团队 + +| 智能体 | 在这个流程中的角色 | +|--------|-------------------| +| 代码审查员 | 逐行审查代码质量和潜在问题 | +| 安全工程师 | 检查安全漏洞和风险点 | +| 性能基准师 | 评估性能影响和优化建议 | + +## 工作流 + +### 第一阶段：代码质量审查 + +**第 1 步 — 激活代码审查员** + +``` +激活代码审查员。 + +请审查以下代码变更： + +```diff +[粘贴你的 git diff 输出] +``` + +重点关注： +1. 代码风格和可读性 +2. 错误处理是否完善 +3. 是否有逻辑漏洞 +4. 命名是否清晰 +5. 是否有重复代码可以抽象 + +请输出结构化的审查报告，按严重程度标注每个问题。 +``` + +**预期产出**：一份代码审查报告，包含问题清单和修改建议。 + +### 第二阶段：安全审查 + +**第 2 步 — 激活安全工程师** + +``` +激活安全工程师。 + +请对以下代码变更进行安全审查： + +```diff +[粘贴你的 git diff 输出] +``` + +重点关注： +1. 输入验证（SQL 注入、XSS、命令注入） +2. 认证和授权检查 +3. 敏感数据泄露（日志、错误信息） +4. 依赖项安全 +5. 文件上传/下载安全 + +请输出安全审查报告，标注风险等级（高/中/低）。 +``` + +**预期产出**：一份安全审查报告，包含风险点和修复建议。 + +### 第三阶段：性能评估 + +**第 3 步 — 激活性能基准师** + +``` +激活性能基准师。 + +请评估以下代码变更的性能影响： + +```diff +[粘贴你的 git diff 输出] +``` + +重点关注： +1. 时间复杂度（是否有 O(n²) 可以优化为 O(n)） +2. 数据库查询（N+1 问题、缺少索引） +3. 内存使用（大对象、循环引用） +4. 网络请求（串行是否可以并行） +5. 缓存策略 + +请输出性能评估报告，包含潜在瓶颈和优化建议。 +``` + +**预期产出**：一份性能评估报告，包含瓶颈分析和优化建议。 + +### 第四阶段：汇总 + +**第 4 步 — 手动汇总三个报告** + +将三个审查报告合并为一份 PR 审查总结： + +```markdown +## PR 审查总结 + +### 代码质量 +[来自代码审查员的发现] + +### 安全 +[来自安全工程师的发现] + +### 性能 +[来自性能基准师的发现] + +### 总体建议 +- [ ] 必须修复：[列出阻塞合并的问题] +- [ ] 建议修复：[列出非阻塞但推荐修复的问题] +- [ ] 未来优化：[列出可以后续处理的优化] +``` + +## 关键交接点 + +| 从 | 到 | 交接内容 | +|----|-----|---------| +| 代码审查员 | 汇总 | 代码质量问题清单 | +| 安全工程师 | 汇总 | 安全风险清单 | +| 性能基准师 | 汇总 | 性能瓶颈清单 | + +## 预期产出 + +- 1 份代码质量审查报告 +- 1 份安全审查报告 +- 1 份性能评估报告 +- 1 份合并后的 PR 审查总结 + +## 适用场景 + +- Pull Request 合并前的全面审查 +- 重大功能变更的多维度评估 +- 定期的代码质量审计 diff --git a/guide.html b/guide.html new file mode 100644 index 0000000..d79a45a --- /dev/null +++ b/guide.html @@ -0,0 +1,309 @@ + + + + + +agency-agents-yhz 使用指南 + + + + +
+

agency-agents-yhz

+

180 个即插即用的 AI 专家人格，支持 11 种 AI 编程工具

+
+ 180 智能体 + 11 工具 + 45 原创 +
+
+ +

已安装的工具

+

以下是本项目支持的所有 AI 工具。安装脚本会自动检测你已安装的工具。

+ +
+

Claude Code

直接复制到 ~/.claude/agents/

+

GitHub Copilot

复制到 ~/.github/agents/

+

Cursor

转换为 .cursor/rules/

+

Trae

转换为 .trae/rules/

+

OpenClaw

SOUL.md 格式

+

OpenCode

.opencode/agents/

+

Aider

单文件 CONVENTIONS.md

+

Windsurf

单文件 .windsurfrules

+

Gemini CLI

扩展格式

+

Antigravity

Skill 格式

+

Qwen Code

SubAgent 格式

+
+ +

怎么用？

+

安装完成后，在你的 AI 工具中通过自然语言激活智能体。不需要特殊语法，直接说就行。

+ +
+ 1 + 打开你的 AI 工具（Claude Code、Cursor 等） +
+
+ 2 + 用自然语言激活智能体，例如： +
+ +
激活前端开发者模式，帮我审查这个 React 组件。
+
+作为小红书运营专家，帮我写一篇种草笔记。
+
+使用代码审查员智能体，检查这个 PR 的安全问题。
+
+请以数据分析师的身份，分析这些销售数据。
+ +
+ 3 + AI 会以该专家的身份和风格回复你，按照预设的专业流程工作 +
+ +

热门智能体

+ + + + + + + + + +
部门热门智能体适用场景
工程前端开发者、后端架构师、代码审查员Web 开发、代码审查、架构设计
营销小红书运营、抖音策略师、微信公众号运营社媒运营、内容营销、品牌推广
设计UI 设计师、UX 研究员、品牌守护者界面设计、用户研究、品牌一致性
产品产品经理、Sprint 排序师、趋势研究员需求管理、规划、市场调研
测试API 测试员、性能基准师、无障碍审核员接口测试、压测、WCAG 合规
销售赢单策略师、售前工程师、Pipeline 分析师销售推进、技术方案、预测分析
+ +

实战示例

+ +

场景一：代码审查

+

用 3 个智能体配合，对 PR 进行全面审查。

+
+展开查看完整流程 +
    +
  1. 代码审查员 — 逐行检查代码质量、错误处理、命名规范
    2. +
  2. 安全工程师 — 检查注入漏洞、认证问题、敏感数据泄露
    3. +
  3. 性能基准师 — 评估复杂度、N+1 查询、内存使用
    4. +
+

完整示例：workflow-code-review.md

+
+ +

场景二：小红书品牌推广

+

从 0 到 1 完成种草推广全流程。

+
+展开查看完整流程 +
    +
  1. 小红书运营 — 制定内容策略和达人合作方案
    2. +
  2. 品牌守护者 — 确保品牌调性一致
    3. +
  3. 内容创作者 — 产出种草笔记
    4. +
  4. 数据分析师 — 追踪投放数据、出复盘报告
    5. +
  5. 增长黑客 — 设计裂变和转化路径
    6. +
+

完整示例：workflow-xiaohongshu-launch.md

+
+ +

场景三：出海产品 MVP

+

5 个智能体协作，快速构建产品原型。

+
+展开查看完整流程 +
    +
  1. 前端开发者 — 构建 React 应用
    2. +
  2. 后端架构师 — 设计 API 和数据库
    3. +
  3. 增长黑客 — 规划用户获取策略
    4. +
  4. 快速原型师 — 快速迭代
    5. +
  5. 现实检验者 — 上线前质量把关
    6. +
+
+ +

全部智能体一览

+ +
+工程部（28 个） +

前端开发者、后端架构师、AI 工程师、DevOps 自动化、安全工程师、快速原型师、高级开发者、移动应用开发者、数据工程师、技术文档工程师、自主优化架构师、嵌入式固件工程师、嵌入式 Linux 驱动工程师、FPGA/ASIC 数字设计工程师、IoT 方案架构师、故障响应指挥官、威胁检测工程师、Solidity 智能合约工程师、微信小程序开发者、代码审查员、数据库优化师、Git 工作流大师、软件架构师、SRE、AI 数据修复工程师、飞书集成开发工程师、钉钉集成开发工程师

+
+ +
+设计部（8 个） +

UI 设计师、UX 研究员、UX 架构师、品牌守护者、图像提示词工程师、视觉叙事师、趣味注入师、包容性视觉专家

+
+ +
+营销部（27 个） +

小红书运营、抖音策略师、微信公众号运营、B站内容策略师、快手策略师、中国电商运营师、电商运营师、百度 SEO 专家、私域流量运营师、直播电商主播教练、跨境电商运营专家、短视频剪辑指导师、微博运营策略师、播客内容策略师、微信视频号运营策略师、知识付费产品策划师、小红书专家、微信公众号管理、知乎策略师、TikTok 策略师、Twitter 互动官、Instagram 策展师、Reddit 社区运营、应用商店优化师、增长黑客、内容创作者、社交媒体策略师、SEO 专家、轮播图增长引擎、LinkedIn 内容创作专家、图书联合作者

+
+ +
+付费媒体部（7 个） +

付费媒体审计师、广告创意策略师、社交广告策略师、PPC 竞价策略师、程序化广告采买专家、搜索词分析师、追踪与归因专家

+
+ +
+销售部（8 个） +

客户拓展策略师、销售教练、赢单策略师、Discovery 教练、售前工程师、Outbound 策略师、Pipeline 分析师、投标策略师

+
+ +
+金融部（3 个） +

财务预测分析师、发票管理专家、金融风控分析师

+
+ +
+人力资源部（2 个） +

招聘专家、绩效管理专家

+
+ +
+法务部（2 个） +

合同审查专家、制度文件撰写专家

+
+ +
+供应链部（3 个） +

库存预测专家、供应商评估专家、物流路线优化师

+
+ +
+产品部（5 个） +

Sprint 排序师、趋势研究员、反馈分析师、行为助推引擎、产品经理

+
+ +
+项目管理部（6 个） +

高级项目经理、项目牧羊人、实验追踪员、工作室制片人、工作室运营、Jira 工作流管家

+
+ +
+测试部（9 个） +

证据收集者、现实检验者、API 测试员、性能基准师、无障碍审核员、测试结果分析师、工具评估师、工作流优化师、嵌入式测试工程师

+
+ +
+支持部（8 个） +

客服响应者、数据分析师、法务合规员、高管摘要师、财务追踪员、基础设施运维师、招聘运营专家、供应链采购策略师

+
+ +
+专项部（30 个） +

智能体编排者、提示词工程师、身份信任架构师、数据整合师、LSP 索引工程师、报告分发师、销售数据提取师、合规审计师、应付账款智能体、身份图谱操作员、文化智能策略师、开发者布道师、模型 QA 专家、ZK 管家、区块链安全审计师、留学规划顾问、政务数字化售前顾问、企业培训课程设计师、MCP 构建器、文档生成器、工作流架构师、自动化治理架构师、Salesforce 架构师、医疗健康营销合规师、高考志愿填报顾问、动态定价策略师、AI 治理政策专家、企业风险评估师、会议效率专家

+
+ +
+空间计算部（6 个） +

visionOS 空间工程师、macOS Metal 空间工程师、XR 界面架构师、XR 沉浸式开发者、XR 座舱交互专家、终端集成专家

+
+ +
+游戏开发部（17 个） +

通用：游戏设计师、关卡设计师、叙事设计师、技术美术、游戏音频工程师

+

Unity：Unity 架构师、Unity 编辑器工具开发者、Unity 多人游戏工程师、Unity Shader Graph 美术师

+

Unreal：Unreal 多人游戏架构师、Unreal 系统工程师、Unreal 技术美术、Unreal 世界构建师

+

Blender：Blender 插件工程师

+

Godot：Godot 游戏脚本开发者、Godot 多人游戏工程师、Godot Shader 开发者

+

Roblox：Roblox 虚拟形象创作者、Roblox 体验设计师、Roblox 系统脚本工程师

+
+ +
+学术部（6 个） +

人类学家、地理学家、历史学家、叙事学家、心理学家、学习规划师

+
+ +
+ 想找特定的智能体？运行 ./scripts/search-agents.sh "关键词" 快速搜索。 +
+ +

更多资源

+ + + + + + diff --git a/scripts/create-agent.sh b/scripts/create-agent.sh new file mode 100644 index 0000000..c8c0577 --- /dev/null +++ b/scripts/create-agent.sh @@ -0,0 +1,211 @@ +#!/usr/bin/env bash +# +# create-agent.sh — 交互式创建新智能体 +# +# 用法: ./scripts/create-agent.sh +# +# 引导用户填写名称、描述、部门、核心使命，自动生成 .md 文件 + +set -euo pipefail + +# --- 颜色 --- +if [[ -t 1 ]]; then + C_GREEN=$'\033[0;32m'; C_YELLOW=$'\033[1;33m'; C_RED=$'\033[0;31m' + C_CYAN=$'\033[0;36m'; C_BOLD=$'\033[1m'; C_DIM=$'\033[2m'; C_RESET=$'\033[0m' +else + C_GREEN=''; C_YELLOW=''; C_RED=''; C_CYAN=''; C_BOLD=''; C_DIM=''; C_RESET='' +fi + +ok() { printf "${C_GREEN}[OK]${C_RESET} %s\n" "$*"; } +warn() { printf "${C_YELLOW}[!!]${C_RESET} %s\n" "$*"; } +err() { printf "${C_RED}[ERR]${C_RESET} %s\n" "$*" >&2; } +header() { printf "\n${C_BOLD}%s${C_RESET}\n" "$*"; } + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)" + +# 部门列表（目录名 → 显示名） +declare -A DEPT_MAP=( + [academic]="学术部" + [design]="设计部" + [engineering]="工程部" + [finance]="金融部" + [game-development]="游戏开发部" + [hr]="人力资源部" + [legal]="法务部" + [marketing]="营销部" + [paid-media]="付费媒体部" + [product]="产品部" + [project-management]="项目管理部" + [sales]="销售部" + [spatial-computing]="空间计算部" + [specialized]="专项部" + [supply-chain]="供应链部" + [testing]="测试部" + [support]="支持部" +) + +# 可选颜色 +COLORS=(blue cyan green orange pink purple red yellow) + +header "创建新智能体" +echo "" + +# --- 检测终端 --- +if [[ ! -t 0 ]]; then + err "此脚本需要交互式终端。请直接运行: ./scripts/create-agent.sh" + exit 1 +fi + +# --- 1. 输入名称 --- +read -r -p "$(printf "${C_BOLD}智能体名称${C_RESET}（中文，如"安全审计师"）: ")" AGENT_NAME " line "$AGENT_FILE" << EOF +--- +name: ${AGENT_NAME} +description: ${AGENT_DESC} +color: ${AGENT_COLOR} +--- + +# ${AGENT_NAME} + +你是**${AGENT_NAME}**，${AGENT_DESC} + +## 你的身份与记忆 + +- **角色**：${AGENT_NAME} +- **个性**：专业、务实、注重结果 +- **记忆**：你记住行业最佳实践、常见陷阱和解决方案 +- **经验**：你在${DEPT_NAME}领域有丰富的实战经验 + +## 核心使命 + +${MISSION_BLOCK} +## 关键规则 + +- 始终以专业角度分析问题 +- 给出可执行的建议，而非空泛的理论 +- 遇到不确定的情况，明确说明假设条件 + +## 技术交付物 + +### 工作流程 + +1. 理解需求和背景 +2. 分析现状和差距 +3. 制定方案 +4. 输出可执行的交付物 + +### 输出格式 + +- 结构化的分析报告 +- 清晰的行动项列表 +- 优先级排序的建议 +EOF + +ok "智能体文件已创建: $AGENT_FILE" + +echo "" +header "下一步" +echo "" +dim "1. 编辑文件，完善智能体内容" +dim " 编辑器打开: $AGENT_FILE" +echo "" +dim "2. 转换格式（让其他工具也能用）" +dim " ./scripts/convert.sh --tool claude-code" +echo "" +dim "3. 搜索验证" +dim " ./scripts/search-agents.sh \"$AGENT_NAME\"" +echo "" diff --git a/scripts/install.sh b/scripts/install.sh index cc8a3dc..ca61e95 100755 --- a/scripts/install.sh +++ b/scripts/install.sh @@ -57,8 +57,13 @@ usage() { # --- 预检 --- check_integrations() { if [[ ! -d "$INTEGRATIONS" ]]; then - err "integrations/ 不存在。请先运行 ./scripts/convert.sh" - exit 1 + warn "integrations/ 不存在，正在自动运行 convert.sh 生成..." + bash "$SCRIPT_DIR/convert.sh" + if [[ ! -d "$INTEGRATIONS" ]]; then + err "convert.sh 运行后 integrations/ 仍不存在，请检查。" + exit 1 + fi + ok "已自动生成 integrations/" fi } diff --git a/scripts/lint-agents.sh b/scripts/lint-agents.sh index b4aa709..1dad19c 100755 --- a/scripts/lint-agents.sh +++ b/scripts/lint-agents.sh @@ -11,13 +11,19 @@ set -euo pipefail AGENT_DIRS=( + academic design engineering + finance game-development + hr + legal marketing paid-media product project-management + sales + supply-chain testing support spatial-computing diff --git a/scripts/search-agents.sh b/scripts/search-agents.sh new file mode 100644 index 0000000..d12d1f4 --- /dev/null +++ b/scripts/search-agents.sh @@ -0,0 +1,86 @@ +#!/usr/bin/env bash +# +# search-agents.sh — 按关键词搜索智能体名称和描述 +# +# 用法: ./scripts/search-agents.sh "关键词" +# 示例: ./scripts/search-agents.sh "小红书" +# ./scripts/search-agents.sh "security" +# ./scripts/search-agents.sh "React" + +set -euo pipefail + +if [[ $# -eq 0 ]]; then + echo "用法: $0 <关键词>" + echo "示例: $0 \"小红书\"" + exit 1 +fi + +KEYWORD="$1" + +# 颜色 +if [[ -t 1 ]]; then + C_GREEN=$'\033[0;32m'; C_CYAN=$'\033[0;36m'; C_YELLOW=$'\033[1;33m' + C_BOLD=$'\033[1m'; C_DIM=$'\033[2m'; C_RESET=$'\033[0m' +else + C_GREEN=''; C_CYAN=''; C_YELLOW=''; C_BOLD=''; C_DIM=''; C_RESET='' +fi + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)" + +AGENT_DIRS=( + academic design engineering finance game-development hr legal marketing + paid-media product project-management sales supply-chain testing support + spatial-computing specialized +) + +count=0 + +for dir in "${AGENT_DIRS[@]}"; do + dirpath="$REPO_ROOT/$dir" + [[ -d "$dirpath" ]] || continue + + while IFS= read -r -d '' file; do + # 提取 name 和 description + local_name="" + local_desc="" + in_fm=0 + + while IFS= read -r line; do + if [[ "$line" == "---" ]]; then + in_fm=$((in_fm + 1)) + [[ $in_fm -ge 2 ]] && break + continue + fi + [[ $in_fm -ne 1 ]] && continue + + if [[ "$line" =~ ^name:\ (.+)$ ]]; then + local_name="${BASH_REMATCH[1]}" + elif [[ "$line" =~ ^description:\ (.+)$ ]]; then + local_desc="${BASH_REMATCH[1]}" + fi + done < "$file" + + # 在 name、description 和文件名中搜索关键词（不区分大小写） + search_text="$local_name $local_desc $(basename "$file")" + if echo "$search_text" | grep -qi "$KEYWORD"; then + count=$((count + 1)) + rel_path="${file#$REPO_ROOT/}" + printf "${C_GREEN}%d.${C_RESET} ${C_BOLD}%s${C_RESET}\n" "$count" "$local_name" + printf " ${C_DIM}%s${C_RESET}\n" "$local_desc" + printf " ${C_CYAN}%s${C_RESET}\n" "$rel_path" + echo "" + fi + done < <(find "$dirpath" -name "*.md" -type f -print0 | sort -z) +done + +if [[ $count -eq 0 ]]; then + echo "未找到匹配 \"$KEYWORD\" 的智能体。" + echo "" + echo "提示：尝试更短或更通用的关键词，例如：" + echo " $0 \"前端\"" + echo " $0 \"安全\"" + echo " $0 \"marketing\"" +else + echo "共找到 ${count} 个匹配 \"$KEYWORD\" 的智能体。" +fi diff --git a/scripts/sync-upstream.sh b/scripts/sync-upstream.sh new file mode 100644 index 0000000..f7a0f61 --- /dev/null +++ b/scripts/sync-upstream.sh @@ -0,0 +1,156 @@ +#!/usr/bin/env bash +# +# sync-upstream.sh — 同步上游 msitarzewski/agency-agents 的新增智能体 +# +# 用法: ./scripts/sync-upstream.sh +# +# 流程: 检测/添加 upstream remote → fetch → 列出新增文件 → 提示翻译 + +set -euo pipefail + +# --- 颜色 --- +if [[ -t 1 ]]; then + C_GREEN=$'\033[0;32m'; C_YELLOW=$'\033[1;33m'; C_RED=$'\033[0;31m' + C_CYAN=$'\033[0;36m'; C_BOLD=$'\033[1m'; C_DIM=$'\033[2m'; C_RESET=$'\033[0m' +else + C_GREEN=''; C_YELLOW=''; C_RED=''; C_CYAN=''; C_BOLD=''; C_DIM=''; C_RESET='' +fi + +ok() { printf "${C_GREEN}[OK]${C_RESET} %s\n" "$*"; } +warn() { printf "${C_YELLOW}[!!]${C_RESET} %s\n" "$*"; } +err() { printf "${C_RED}[ERR]${C_RESET} %s\n" "$*" >&2; } +header() { printf "\n${C_BOLD}%s${C_RESET}\n" "$*"; } +dim() { printf "${C_DIM}%s${C_RESET}\n" "$*"; } + +UPSTREAM_URL="https://github.com/msitarzewski/agency-agents.git" +UPSTREAM_NAME="upstream" +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)" + +cd "$REPO_ROOT" + +# --- 1. 检测/添加 upstream remote --- +header "检查 upstream remote..." + +if git remote get-url "$UPSTREAM_NAME" >/dev/null 2>&1; then + existing_url=$(git remote get-url "$UPSTREAM_NAME") + if [[ "$existing_url" != "$UPSTREAM_URL" ]]; then + warn "upstream remote 已存在但 URL 不同: $existing_url" + warn "期望: $UPSTREAM_URL" + warn "如需更新，请手动执行: git remote set-url upstream $UPSTREAM_URL" + exit 1 + fi + ok "upstream remote 已配置" +else + git remote add "$UPSTREAM_NAME" "$UPSTREAM_URL" + ok "已添加 upstream remote: $UPSTREAM_URL" +fi + +# --- 2. Fetch 上游 --- +header "获取上游更新..." + +if ! git fetch upstream --depth=1 2>/dev/null; then + err "无法连接上游仓库。请检查网络连接。" + err "上游地址: $UPSTREAM_URL" + exit 1 +fi +ok "上游数据已获取" + +# --- 3. 对比差异 --- +header "分析差异..." + +# 获取上游的智能体文件列表（排除非智能体目录） +AGENT_DIRS="academic design engineering finance game-development hr legal marketing paid-media product project-management sales spatial-computing specialized supply-chain testing support" + +UPSTREAM_FILES=$(git ls-tree -r --name-only upstream/main -- $AGENT_DIRS 2>/dev/null || \ + git ls-tree -r --name-only upstream/master -- $AGENT_DIRS 2>/dev/null || \ + git ls-tree -r --name-only upstream HEAD -- $AGENT_DIRS 2>/dev/null) + +LOCAL_FILES=$(git ls-tree -r --name-only HEAD -- $AGENT_DIRS 2>/dev/null) + +# 找出上游有但本地没有的文件（新增智能体） +NEW_FILES=() +while IFS= read -r line; do + [[ -z "$line" ]] && continue + if ! echo "$LOCAL_FILES" | grep -qF "$line"; then + NEW_FILES+=("$line") + fi +done <<< "$UPSTREAM_FILES" + +# 找出上游修改过的文件（可能需要更新翻译） +MODIFIED_FILES=() +while IFS= read -r line; do + [[ -z "$line" ]] && continue + if echo "$LOCAL_FILES" | grep -qF "$line"; then + # 比较文件内容 + upstream_content=$(git show "upstream/main:$line" 2>/dev/null || git show "upstream/master:$line" 2>/dev/null || echo "") + local_content=$(git show "HEAD:$line" 2>/dev/null || echo "") + if [[ -n "$upstream_content" && "$upstream_content" != "$local_content" ]]; then + MODIFIED_FILES+=("$line") + fi + fi +done <<< "$UPSTREAM_FILES" + +# --- 4. 报告结果 --- +echo "" + +if [[ ${#NEW_FILES[@]} -eq 0 && ${#MODIFIED_FILES[@]} -eq 0 ]]; then + ok "本地已与上游同步，没有发现新增或变更的智能体。" + exit 0 +fi + +if [[ ${#NEW_FILES[@]} -gt 0 ]]; then + header "上游新增智能体（${#NEW_FILES[@]} 个）" + echo "" + for f in "${NEW_FILES[@]}"; do + # 提取英文名称 + en_name=$(basename "$f" .md) + printf " ${C_GREEN}+${C_RESET} %s\n" "$f" + done + + echo "" + printf "${C_BOLD}自动拉取新增文件？${C_RESET} [y/N]: " + if [[ -t 0 ]]; then + read -r choice /dev/null 2>&1 || \ + git checkout "upstream/master:$f" > /dev/null 2>&1 || { + warn "无法检出: $f" + continue + } + # 创建目录（如果需要） + dir=$(dirname "$f") + mkdir -p "$dir" + git show "upstream/main:$f" > "$f" 2>/dev/null || \ + git show "upstream/master:$f" > "$f" 2>/dev/null || true + ok "已拉取: $f" + done + echo "" + warn "新增文件已拉取（英文原版）。请翻译后提交。" + warn "翻译后记得运行: ./scripts/convert.sh 更新各工具格式。" + else + dim "跳过自动拉取。手动拉取：" + dim " git checkout upstream/main -- " + fi +fi + +if [[ ${#MODIFIED_FILES[@]} -gt 0 ]]; then + echo "" + header "上游已更新的文件（${#MODIFIED_FILES[@]} 个）" + echo "" + for f in "${MODIFIED_FILES[@]}"; do + printf " ${C_YELLOW}~${C_RESET} %s\n" "$f" + done + echo "" + warn "以上文件在上游有更新，可能需要同步翻译。" + warn "查看差异: git diff HEAD upstream/main -- " +fi + +echo "" +ok "同步分析完成。" diff --git a/setup.sh b/setup.sh new file mode 100644 index 0000000..754d9fd --- /dev/null +++ b/setup.sh @@ -0,0 +1,214 @@ +#!/usr/bin/env bash +# +# setup.sh — agency-agents-yhz 一键安装脚本 +# +# 用法： +# curl -fsSL https://raw.githubusercontent.com/Yhazrin/agency-agents-yhz/main/setup.sh | bash +# +# 流程：检测 git → clone 到临时目录 → 转换格式 → 安装 → 打开引导 → 清理 + +set -euo pipefail + +# --- 颜色 --- +if [[ -t 1 ]]; then + C_GREEN=$'\033[0;32m'; C_YELLOW=$'\033[1;33m'; C_RED=$'\033[0;31m' + C_CYAN=$'\033[0;36m'; C_BOLD=$'\033[1m'; C_DIM=$'\033[2m'; C_RESET=$'\033[0m' +else + C_GREEN=''; C_YELLOW=''; C_RED=''; C_CYAN=''; C_BOLD=''; C_DIM=''; C_RESET='' +fi + +ok() { printf "${C_GREEN}[OK]${C_RESET} %s\n" "$*"; } +warn() { printf "${C_YELLOW}[!!]${C_RESET} %s\n" "$*"; } +err() { printf "${C_RED}[ERR]${C_RESET} %s\n" "$*" >&2; } +header() { printf "\n${C_BOLD}%s${C_RESET}\n" "$*"; } +dim() { printf "${C_DIM}%s${C_RESET}\n" "$*"; } + +REPO_URL="https://github.com/Yhazrin/agency-agents-yhz.git" +GUIDE_DIR="${HOME}/.agency-agents-zh" + +# --- 终端引导 --- +show_terminal_guide() { + local tool_name="${1:-AI 工具}" + local agent_count="${2:-180}" + local B="║"; local TL="╔"; local TR="╗"; local BL="╚"; local BR="╝" + local H="═"; local LH="╠"; local RH="╣"; local S="─"; local MT="╤"; local MB="╧" + + printf "\n" + printf "${C_CYAN}${TL}══════════════════════════════════════════════════════════${TR}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_BOLD}agency-agents-yhz 安装成功${C_RESET} ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${LH}══════════════════════════════════════════════════════════${RH}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} 已安装: ${C_GREEN}${tool_name}${C_RESET} (${agent_count} 个智能体) ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_BOLD}使用方式${C_RESET}：直接用自然语言激活 ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} "激活前端开发者模式，帮我审查代码" ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} "作为小红书运营专家，写一篇种草笔记" ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} "使用代码审查员智能体，检查 PR" ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_BOLD}热门智能体${C_RESET}： ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_GREEN}·${C_RESET} 前端开发者 ${C_GREEN}·${C_RESET} 后端架构师 ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_GREEN}·${C_RESET} 小红书运营专家 ${C_GREEN}·${C_RESET} 代码审查员 ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_GREEN}·${C_RESET} 数据分析师 ${C_GREEN}·${C_RESET} UI 设计师 ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_BOLD}搜索智能体${C_RESET}： ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_DIM}./scripts/search-agents.sh "关键词"${C_RESET} ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${B}${C_RESET} ${C_CYAN}https://github.com/Yhazrin/agency-agents-yhz${C_RESET} ${C_CYAN}${B}${C_RESET}\n" + printf "${C_CYAN}${BL}══════════════════════════════════════════════════════════${BR}${C_RESET}\n" + printf "\n" +} + +# 检测已安装的工具 +detect_tools() { + local detected=() + [[ -d "${HOME}/.claude" ]] && detected+=("claude-code") + (command -v code >/dev/null 2>&1 || [[ -d "${HOME}/.github" ]]) && detected+=("copilot") + (command -v cursor >/dev/null 2>&1 || [[ -d "${HOME}/.cursor" ]]) && detected+=("cursor") + (command -v trae >/dev/null 2>&1 || [[ -d "${HOME}/.trae" ]]) && detected+=("trae") + (command -v opencode >/dev/null 2>&1 || [[ -d "${HOME}/.config/opencode" ]]) && detected+=("opencode") + (command -v openclaw >/dev/null 2>&1 || [[ -d "${HOME}/.openclaw" ]]) && detected+=("openclaw") + command -v aider >/dev/null 2>&1 && detected+=("aider") + (command -v windsurf >/dev/null 2>&1 || [[ -d "${HOME}/.codeium" ]]) && detected+=("windsurf") + (command -v gemini >/dev/null 2>&1 || [[ -d "${HOME}/.gemini" ]]) && detected+=("gemini-cli") + [[ -d "${HOME}/.gemini/antigravity/skills" ]] && detected+=("antigravity") + (command -v qwen >/dev/null 2>&1 || [[ -d "${HOME}/.qwen" ]]) && detected+=("qwen") + echo "${detected[*]}" +} + +# 工具显示名 +tool_display_name() { + case "$1" in + claude-code) echo "Claude Code" ;; + copilot) echo "Copilot" ;; + cursor) echo "Cursor" ;; + trae) echo "Trae" ;; + opencode) echo "OpenCode" ;; + openclaw) echo "OpenClaw" ;; + aider) echo "Aider" ;; + windsurf) echo "Windsurf" ;; + gemini-cli) echo "Gemini CLI" ;; + antigravity) echo "Antigravity" ;; + qwen) echo "Qwen Code" ;; + esac +} + +# --- 主流程 --- +main() { + header "agency-agents-yhz 一键安装" + printf "\n" + + # 1. 检测 git + if ! command -v git >/dev/null 2>&1; then + err "未找到 git。请先安装 git：https://git-scm.com/downloads" + exit 1 + fi + + # 2. 创建临时目录并 clone + TMPDIR=$(mktemp -d 2>/dev/null || mktemp -d -t 'agency-agents') + trap 'cd / && rm -rf "$TMPDIR" 2>/dev/null || true' EXIT + + printf "${C_DIM}正在下载智能体仓库...${C_RESET}\n" + if ! git clone --depth 1 "$REPO_URL" "$TMPDIR/agency-agents-yhz" 2>/dev/null; then + err "下载失败。请检查网络连接或手动 clone：" + err " git clone $REPO_URL" + exit 1 + fi + ok "仓库下载完成" + + cd "$TMPDIR/agency-agents-yhz" + + # 3. 检测工具并决定是否需要转换 + local detected_raw + detected_raw="$(detect_tools)" + local detected_arr=() + if [[ -n "$detected_raw" ]]; then + read -ra detected_arr <<< "$detected_raw" + fi + + # 只有 claude-code 和 copilot 不需要 integrations/（直接复制源 .md） + # 其余工具需要先 convert + local needs_convert=false + local needs_convert_tools=() + for t in "${detected_arr[@]}"; do + case "$t" in + claude-code|copilot) ;; # 不需要转换 + *) needs_convert=true; needs_convert_tools+=("$t") ;; + esac + done + + if $needs_convert; then + header "转换智能体格式..." + for t in "${needs_convert_tools[@]}"; do + bash ./scripts/convert.sh --tool "$t" + done + fi + + # 4. 安装 + header "安装智能体..." + bash ./scripts/install.sh + + # 5. 复制 guide.html + mkdir -p "$GUIDE_DIR" + if [[ -f "./guide.html" ]]; then + cp "./guide.html" "$GUIDE_DIR/guide.html" + ok "使用指南已复制到 $GUIDE_DIR/guide.html" + fi + + # 6. 引导选择 + printf "\n" + local tool_name="AI 工具" + if [[ ${#detected_arr[@]} -gt 0 ]]; then + local display_names=() + for t in "${detected_arr[@]}"; do + display_names+=("$(tool_display_name "$t")") + done + tool_name="${display_names[*]}" + fi + + printf "${C_BOLD}安装完成！${C_RESET} 已为 ${C_GREEN}${tool_name}${C_RESET} 安装 180 个智能体。\n" + printf "\n" + printf "查看使用指南：\n" + printf " ${C_GREEN}[1]${C_RESET} 在浏览器中打开（推荐）\n" + printf " ${C_GREEN}[2]${C_RESET} 在终端中显示\n" + printf " ${C_GREEN}[3]${C_RESET} 跳过\n" + printf "\n" + + if [[ -t 0 ]]; then + read -r -p "请选择 [1/2/3]: " choice /dev/null 2>&1; then + xdg-open "$guide_path" 2>/dev/null & + elif command -v open >/dev/null 2>&1; then + open "$guide_path" 2>/dev/null & + elif command -v start >/dev/null 2>&1; then + start "$guide_path" 2>/dev/null & + else + warn "无法自动打开浏览器。请手动打开：$guide_path" + fi + ok "已在浏览器中打开使用指南" + else + warn "guide.html 未找到。" + show_terminal_guide "$tool_name" + fi + ;; + 2) + show_terminal_guide "$tool_name" + ;; + *) + printf "\n" + dim "跳过引导。随时查看指南：$GUIDE_DIR/guide.html" + dim "或访问：https://github.com/Yhazrin/agency-agents-yhz" + ;; + esac + + printf "\n" + ok "全部完成！重启你的 AI 工具后即可使用。" +} + +main "$@" diff --git a/workflows/README.md b/workflows/README.md new file mode 100644 index 0000000..e478586 --- /dev/null +++ b/workflows/README.md @@ -0,0 +1,20 @@ +# 多智能体协作工作流 + +预定义的多智能体协作模板，定义了参与的智能体、协作顺序和每步 prompt。 + +## 使用方式 + +每个工作流文件包含： +1. **参与智能体** — 需要激活的专家 +2. **协作流程** — 每步做什么、谁来做 +3. **Prompt 模板** — 直接复制粘贴使用 + +按顺序激活智能体，将上一步的输出作为下一步的输入。 + +## 工作流列表 + +| 工作流 | 智能体数 | 场景 | +|--------|---------|------| +| [产品上线](product-launch.md) | 5 个 | 从需求到发布的全流程 | +| [代码审查](code-review-pipeline.md) | 3 个 | PR 全面审查 | +| [营销活动](marketing-campaign.md) | 5 个 | 从策略到投放的全流程 | diff --git a/workflows/code-review-pipeline.md b/workflows/code-review-pipeline.md new file mode 100644 index 0000000..45a5f12 --- /dev/null +++ b/workflows/code-review-pipeline.md @@ -0,0 +1,95 @@ +# 工作流：代码审查流水线 + +3 个智能体从不同角度全面审查 PR，输出结构化审查报告。 + +## 参与智能体 + +1. **代码审查员** — 代码质量、规范、可维护性 +2. **安全工程师** — 安全漏洞、敏感数据、认证问题 +3. **性能基准师** — 复杂度、资源使用、瓶颈分析 + +## 流程 + +### 第 1 步：代码质量审查（代码审查员） + +``` +作为代码审查员，对以下代码进行全面审查： + +[粘贴代码或 PR diff] + +审查维度： +- 错误处理是否完善 +- 命名是否清晰一致 +- 代码结构是否合理 +- 是否有代码重复 +- 边界条件是否处理 + +输出格式： +每个问题列出：文件名:行号 + 问题描述 + 修改建议 +严重程度：Critical / Warning / Suggestion +``` + +### 第 2 步：安全审计（安全工程师） + +``` +作为安全工程师，对以下代码进行安全审计： + +[粘贴同一段代码] + +检查项： +- OWASP Top 10（注入、XSS、CSRF 等） +- 敏感数据泄露（密钥、密码、个人信息） +- 认证与授权缺陷 +- 不安全的依赖 +- 输入验证不足 + +输出格式： +每个漏洞列出：类型 + 位置 + 风险等级（高/中/低）+ 修复方案 +``` + +### 第 3 步：性能分析（性能基准师） + +``` +作为性能基准师，分析以下代码的性能表现： + +[粘贴同一段代码] + +分析维度： +- 时间复杂度 +- 空间复杂度 +- N+1 查询问题 +- 内存泄漏风险 +- 不必要的网络请求 +- 缓存机会 + +输出格式： +每个问题列出：位置 + 问题描述 + 影响范围 + 优化建议 +``` + +### 第 4 步：汇总报告 + +将三个智能体的输出汇总为一份报告： + +``` +## PR 审查报告 + +### Critical（必须修复） +- [列出所有 Critical 级别问题] + +### Warning（建议修复） +- [列出所有 Warning 级别问题] + +### Suggestion（可选优化） +- [列出所有 Suggestion 级别问题] + +### 审查统计 +- 安全漏洞：X 个 +- 性能问题：X 个 +- 代码质量问题：X 个 +``` + +## 使用技巧 + +- 三个审查可以并行进行（在不同会话中同时激活） +- 对于大型 PR，可以分文件审查 +- 审查结果可以直接贴到 PR comment 中 diff --git a/workflows/marketing-campaign.md b/workflows/marketing-campaign.md new file mode 100644 index 0000000..3211c61 --- /dev/null +++ b/workflows/marketing-campaign.md @@ -0,0 +1,105 @@ +# 工作流：营销活动全流程 + +从策略制定到内容产出再到数据分析，5 个智能体协作完成一次营销活动。 + +## 参与智能体 + +1. **增长黑客** — 策略制定、增长目标 +2. **内容创作者** — 内容策划与产出 +3. **品牌守护者** — 品牌调性把关 +4. **社交媒体策略师** — 渠道分发策略 +5. **数据分析师** — 效果追踪与复盘 + +## 流程 + +### 第 1 步：增长策略（增长黑客） + +``` +作为增长黑客，为以下产品/活动制定增长策略： + +产品/品牌：[名称] +目标：[拉新/促活/转化] +预算：[预算范围] +时间：[活动周期] +目标人群：[用户画像] + +要求包含： +- 核心增长假设 +- 关键指标（北极星指标 + 辅助指标） +- 获客渠道优先级 +- 裂变/病毒机制设计 +- 实验计划（至少 3 个 A/B 测试） +``` + +### 第 2 步：品牌调性确认（品牌守护者） + +将策略传给品牌守护者： + +``` +作为品牌守护者，审查以下营销策略是否符合品牌调性： + +品牌信息： +- 品牌名称：[名称] +- 品牌调性：[专业/年轻/高端/亲民] +- 核心价值观：[列出] +- 禁用词/禁用风格：[如有] + +待审查的营销策略： +[粘贴第 1 步的策略] + +输出： +- 符合品牌的部分 ✓ +- 需要调整的部分 ✗ + 修改建议 +- 建议的品牌话术模板 +``` + +### 第 3 步：内容产出（内容创作者） + +``` +作为内容创作者，根据以下策略产出内容： + +[粘贴已确认的策略] + +要求： +- 产出 [N] 篇内容 +- 每篇包含：标题、正文、配图描述、CTA +- 适配平台：[小红书/抖音/微信公众号/...] +- 发布时间建议 +``` + +### 第 4 步：渠道分发（社交媒体策略师） + +``` +作为社交媒体策略师，为以下内容制定分发计划： + +[粘贴内容] + +要求包含： +- 各平台发布时间表 +- 平台适配调整（同一内容在不同平台的差异化） +- 互动策略（评论回复、话题引导） +- KOL/KOC 合作建议 +- 付费推广预算分配 +``` + +### 第 5 步：效果追踪（数据分析师） + +``` +作为数据分析师，为本次营销活动设计数据追踪方案： + +活动目标：[来自第 1 步] +投放渠道：[来自第 4 步] + +要求包含： +- 核心指标看板设计 +- 各渠道 UTM 参数规范 +- 转化漏斗定义 +- 日报/周报模板 +- 复盘报告模板（活动结束后使用） +``` + +## 使用技巧 + +- 第 2 步的品牌审查很重要，避免内容"跑偏" +- 内容产出可以批量进行，一次生成多篇 +- 数据追踪方案应在活动开始前就部署好 diff --git a/workflows/product-launch.md b/workflows/product-launch.md new file mode 100644 index 0000000..becb66e --- /dev/null +++ b/workflows/product-launch.md @@ -0,0 +1,98 @@ +# 工作流：产品上线 + +从需求定义到上线发布的全流程，5 个智能体协作完成。 + +## 参与智能体 + +1. **产品经理** — 需求定义、PRD 撰写 +2. **前端开发者** — UI 实现 +3. **后端架构师** — API 设计与实现 +4. **API 测试员** — 接口测试 +5. **DevOps 自动化师** — 部署上线 + +## 流程 + +### 第 1 步：需求定义（产品经理） + +``` +作为产品经理，为以下功能撰写 PRD： + +功能名称：[你的功能] +目标用户：[用户画像] +核心价值：[解决什么问题] + +要求包含： +- 用户故事（至少 3 个） +- 验收标准 +- 技术约束 +- 优先级（P0/P1/P2） +``` + +### 第 2 步：API 设计（后端架构师） + +将第 1 步的 PRD 传给后端架构师： + +``` +作为后端架构师，根据以下 PRD 设计 RESTful API： + +[粘贴 PRD 内容] + +要求包含： +- 数据模型（字段、类型、关系） +- API 端点（URL、方法、请求/响应） +- 认证方案 +- 错误码定义 +``` + +### 第 3 步：前端实现（前端开发者） + +将 API 设计传给前端开发者： + +``` +作为前端开发者，根据以下 API 设计实现前端页面： + +[粘贴 API 设计] + +要求： +- 组件拆分合理 +- 错误状态处理 +- Loading 状态 +- 响应式适配 +``` + +### 第 4 步：接口测试（API 测试员） + +``` +作为 API 测试员，为以下 API 设计测试用例： + +[粘贴 API 设计] + +要求包含： +- 正常流程测试 +- 边界值测试 +- 异常输入测试 +- 认证/权限测试 +- 每个端点至少 3 个测试用例 +``` + +### 第 5 步：部署上线（DevOps 自动化师） + +``` +作为 DevOps 自动化师，为以下项目设计部署方案： + +项目类型：[Web 应用/API 服务/微服务] +技术栈：[前端框架、后端语言、数据库] +预期流量：[DAU/TPS] + +要求包含： +- CI/CD 流水线配置 +- 环境规划（dev/staging/prod） +- 监控告警 +- 回滚策略 +``` + +## 注意事项 + +- 每步之间将上一步的输出作为下一步的输入 +- 如果某步的输出不合理，可以要求该智能体修正后再继续 +- 可以跳过不需要的步骤（如已有 API 设计可从第 3 步开始）