优化上手体验：一键安装 + 文档重组 + 工作流模板 + 搜索脚本

.gitignore

@@ -1,4 +1,3 @@
-# 转换输出目录（由 scripts/convert.sh 生成）
-integrations/
+# integrations/ 已移除——预转换文件现在可随仓库提交，方便 curl 一键安装
 .claude/
 openspec/.DS_Store

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)。

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)。