diff --git a/.claude/agents/content-explorer-agent.md b/.claude/agents/content-explorer-agent.md index ef22b57..22f6774 100644 --- a/.claude/agents/content-explorer-agent.md +++ b/.claude/agents/content-explorer-agent.md @@ -19,6 +19,26 @@ tools: ["Task", "Read", "Bash", "Grep", "Glob"] **重要**:agent-browser 是一个**命令行工具**(通过 Bash 工具调用),**不是 agent**! +### ⚠️ 严格禁止使用 chrome-devtools MCP + +**你绝对不能使用任何 chrome-devtools MCP 工具!** + +- ❌ 禁止使用:`mcp__chrome-devtools__*` 系列工具 +- ❌ 禁止使用:`TakeScreenshot`, `NavigatePage`, `Click`, `Fill` 等 MCP 工具 +- ✅ 只允许使用:`agent-browser` CLI 命令(通过 Bash 工具调用) + +**正确做法**: +```bash +# ✅ 正确:使用 Bash 工具调用 agent-browser CLI +Bash: agent-browser open +Bash: agent-browser snapshot -i +Bash: agent-browser close + +# ❌ 错误:直接使用 chrome-devtools MCP 工具 +mcp__chrome-devtools__navigate_page +mcp__chrome-devtools__take_snapshot +``` + 加载后请仔细阅读文档,了解正确的使用方式。 ## 核心职责 @@ -171,13 +191,14 @@ agent-browser --session proj2 open ## 重要注意事项 1. **⚠️ 必须先加载 skill**: 在执行任何探索任务前,必须使用 `Skill` 工具加载 `agent-browser` skill -2. **正确使用 agent-browser**: agent-browser 是 CLI 工具,通过 **Bash 工具**调用,不是 agent -3. **优先使用 snapshot**: 使用 `agent-browser snapshot -i` 获取结构化文本,避免使用截图 -4. **只返回JSON**: 不要添加任何解释性文字 -5. **顺序处理更稳定**: 虽然支持 session 并行,但建议顺序处理每个项目 -6. **质量标准**: 遵循本文件的"内容质量标准"章节 -7. **数据格式**: 按照 `.claude/schemas/project-content-template.md` 的格式要求 -8. **数据验证**: 确保返回的JSON格式正确,字段完整 +2. **⚠️ 严格禁止 chrome-devtools MCP**: 绝对不能使用任何 `mcp__chrome-devtools__*` 系列 MCP 工具,只能通过 Bash 工具调用 `agent-browser` CLI 命令 +3. **正确使用 agent-browser**: agent-browser 是 CLI 工具,通过 **Bash 工具**调用,不是 agent +4. **优先使用 snapshot**: 使用 `agent-browser snapshot -i` 获取结构化文本,避免使用截图 +5. **只返回JSON**: 不要添加任何解释性文字 +6. **顺序处理更稳定**: 虽然支持 session 并行,但建议顺序处理每个项目 +7. **质量标准**: 遵循本文件的"内容质量标准"章节 +8. **数据格式**: 按照 `.claude/schemas/project-content-template.md` 的格式要求 +9. **数据验证**: 确保返回的JSON格式正确,字段完整 ## 数据Schema验证 diff --git a/.claude/commands/discover-projects.md b/.claude/commands/discover-projects.md index b3d71d8..7d935ab 100644 --- a/.claude/commands/discover-projects.md +++ b/.claude/commands/discover-projects.md @@ -12,6 +12,23 @@ $ARGUMENTS --- +## ⚠️ 重要约束 + +### 严格禁止使用 chrome-devtools MCP + +**在整个 `discover-projects` 命令流程中,绝对不能使用任何 chrome-devtools MCP 工具!** + +- ❌ 禁止使用:`mcp__chrome-devtools__*` 系列工具 +- ❌ 禁止使用:`TakeScreenshot`, `NavigatePage`, `Click`, `Fill` 等 MCP 工具 +- ✅ 只允许:`content-explorer-agent` 使用 `agent-browser` CLI 命令(通过 Bash 工具调用) + +**架构设计原则**: +- `content-explorer-agent` 在独立上下文中运行 +- 只通过 Bash 工具调用 `agent-browser` CLI 命令 +- 主上下文不直接进行任何浏览器操作 + +--- + ## 架构概述 此命令采用 **双 Agent 协作架构**,将探索逻辑和提交逻辑分离到独立的 agent 上下文中,主上下文只保留调度和统计信息。 @@ -121,6 +138,7 @@ TOTAL_BATCHES=$(( (TOTAL_TASKS + BATCH_SIZE - 1) / BATCH_SIZE )) - agent-browser 是一个 CLI 工具,通过 Bash 工具调用(不是 agent) - 使用 `agent-browser snapshot -i` 获取页面结构化文本(无头模式) - 顺序处理每个项目,更稳定可靠 +- **严格禁止使用 chrome-devtools MCP 工具,只能通过 Bash 调用 agent-browser CLI** **输入格式**: ```json @@ -273,6 +291,7 @@ fi ### 技术实现细节 - **浏览器自动化**: content-explorer-agent 使用 `agent-browser` CLI 工具(通过 Bash 工具调用) +- **严格禁止 MCP**: 绝不使用 chrome-devtools MCP 工具,只通过 Bash 调用 agent-browser CLI 命令 - **无头模式**: 使用 `agent-browser snapshot -i` 获取页面结构化文本,避免截图 - **顺序处理**: 逐个访问项目页面,确保稳定性 - **上下文隔离**: Explorer Agent 在独立上下文中完成所有探索后释放 @@ -293,7 +312,8 @@ fi ### Explorer Agent 上下文(隔离) - agent-browser skill 加载 -- 项目探索流程(使用 agent-browser CLI 命令) +- 项目探索流程(使用 agent-browser CLI 命令,通过 Bash 工具调用) +- **严格禁止使用 chrome-devtools MCP 工具** - 内容整理和验证 - → 每批处理完即释放