# Agent Boost > Analyze any deployed web application and add a smart Agent layer to it. Triggered by /agent-boost. Scans the project, recommends an Agent + Skills combo, asks the user to confirm, then generates a standardized MCP Bridge, agent.md, SKILL files, embeds a chat widget. Registers the agent with the shared agent-server. Works for any app type — not HR specific. - Skill: `infometa/agent-boost` (Agent Skill, multi-file: 37 files) - Install (CLI): `npx skillmds@latest add infometa/agent-boost` - Raw SKILL.md: https://api.skillmd.com/api/skills/infometa/agent-boost/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: infometa (https://skillmd.com/u/infometa) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/infometa/agent-boost --- # agent-boost 为 Web 应用增加智能 Agent 能力。本 skill 是 `/agent-boost` 命令的核心实现。 > 核心设计：Agent 大脑跑在共享的 `agent-server`（FastAPI）上；MCP Bridge 跟用户应用一起跑（plugin 标准化生成，用户不写）；定时任务在 server 端。企微等外部集成由 agent-server 管理面板在 agent 创建后独立绑定，不进入创建主线。 > MCP 服务：身份认证与状态查询通过 `hr-claw-agent-server` MCP 服务完成（完整路径见下方速查表），调用 `check_identity`、`get_agent_status` 两个工具；Agent 注册统一走 `register-agent.sh` 脚本（dev/prod 同一脚本，仅 `AGENT_SERVER_URL` 不同）。 > Shell 命令约定见 `references/shell-conventions.md`（所有阶段适用）。 --- ## MCP 工具速查 > MCP 服务完整路径：`HRIT/agent-boost/hr-claw-agent-server`（调用 MCP 工具时需使用完整路径，简写 `hr-claw-agent-server` 仅用于文档简称）。 | 工具 | MCP 服务 | 用途 | 使用阶段 | |------|---------|------|---------| | `check_identity` | `HRIT/agent-boost/hr-claw-agent-server` | 检查当前用户身份（鉴权平台自动注入 `x-tai-identity`） | §0 路由 | | `get_agent_status` | `HRIT/agent-boost/hr-claw-agent-server` | 查询远端 Agent 注册状态 | §0 路由 | --- ## 流程纪律 1. **主线六阶段顺序执行** — §0→§1→§2→§3→§4→§5，路线 B/C 按路由跳转但不逆行 2. **能力启用遵循注册表** — §1 detect / §2 confirm / §3 inject / §5 test 均按 `modules/registry.md` 调用已启用能力的锚点；未启用的能力全程跳过，主线不硬编码任何能力名 3. **注册成功（`state:deployed`）后必须执行 §5 验证**，通过质量门禁后才输出「完成」 4. **禁止创建 `docs/plan.md`** — 本 skill 工作流已完整定义 5. **身份认证与状态查询通过 MCP 工具完成**（`check_identity`、`get_agent_status`）；**Agent 注册统一走 `register-agent.sh` 脚本**（dev/prod 同一脚本，仅 `AGENT_SERVER_URL` 不同） 6. **脚本操作调用封装脚本** — `KEY1="v1" bash ${SKILL_DIR}/scripts/xxx.sh`（gen-bridge / register-agent / test-mcp / remote-exec / prod-deploy 等） --- ## 主线流程 | 阶段 | 加载文件 | 一句话 | 能力 Hook | |------|----------|--------|-----------| | §0 路由 | `phases/0-context.md` | 检测状态 → 路线 A/B/C | — | | §1 分析 | `phases/1-analyze.md` | 扫描项目 → 核心能力矩阵 | 【detect】 | | §2 建议 | `phases/2-suggest.md` | 模板推荐 → 逐项弹窗确认（含能力启用确认） | 【confirm】 | | §3 创建 | `phases/3-create.md` | 生成所有代码产物（Bridge + 各能力产物；不注册不部署） | 【inject】 | | §4 注册 | `phases/4-register.md` | 入口决策 → 部署 Bridge（如需）→ 注册 Agent → 验证 loaded | — | | §5 验证 | `phases/5-verify.md` | MCP 工具质量 + 能力测试 → 质量门禁通过才输出完成 | 【test】 | **能力模块：** | 模块 | 文件 | 层级 | 覆盖 | |------|------|------|------| | MCP Bridge | `modules/mcp.md` | 核心（always-on） | 生成(§3) → 部署(§4) → 测试(§5) | | API 授权 | `modules/authz.md` | 可选能力（按需启用） | detect(§1) → confirm(§2) → inject(§3) → test(§5) | | 数仓问数 | `modules/dw-qa.md` | 可选能力（按需启用） | detect(§1) → confirm(§2) → inject(§3) → test(§5) | > 可选能力的注册表见 `modules/registry.md`。新增可选能力不改 phase 文件，只改 registry + 加 module 文件。 各阶段详细说明中内嵌脚本调用示例，脚本清单及变量定义见各阶段文件。 --- ## 产物自检（注册后强制核对） - [ ] `.agent/agent.md` 存在，frontmatter 解析无误，body 非空 - [ ] `.agent/boost-state.json` 存在，`state` 为 `deployed` - [ ] 每个 skill 有 `SKILL.md`，frontmatter 含 `name`/`description` - [ ] `mcp_server/mcp_bridge.py` 包含 `call_api` 和 `list_endpoints`，py_compile 通过 - [ ] 若启用 authz：`.agent/authz/api-authz.json` 存在，`apis` 非空；`enforcement=middleware` 时授权中间件已生成并注入应用入口 - [ ] `public/chat-widget.js` + `public/agent-entry-widget-icon.svg` 存在 - [ ] `public/index.html` 末尾包含 `