---
description: 引导配置 Figma Remote MCP（pi-figma-remote-auth）；setup/login 与 KB 提案闸门分工
argument-hint: "[可选：status|help]"
---

> Pi 包 `@suwenguang/pi-kb`：运行时包根为环境变量 `PI_KB_ROOT`（由 `extensions/kb-root.ts` 注入）。
> 工种子 Agent 通过 **pi-subagents** 派发（已 bundled）；agent 定义见本包 `agents/`。
> 脚本调用示例：`node "$PI_KB_ROOT/scripts/<name>.mjs"`。

## 用户输入

${@:-（未附带参数；结合当前对话上下文执行，缺信息时向用户澄清。）}

---
引导用户完成 **Figma Remote MCP** 配置，使 Pi 可经 `pi-mcp-adapter` 调用 Figma 工具。本包已 bundled `pi-figma-remote-auth` + `pi-mcp-adapter`，**无需**再 `pi install npm:pi-figma-remote-auth`。

细则 SSOT：[kb-figma-remote.md](../skills/kb-workflow/references/kb-figma-remote.md)。

## Bootstrap

本命令**豁免**业务仓 bootstrap 门禁（与反馈/进化/DeepSeek/Cursor setup 类似）：未 `/kb-init` 也可执行。

## 执行步骤

### 1. 探测扩展与 MCP

- 若存在斜杠 `/figma-remote-auth`：扩展已加载。  
- 请用户执行 `/figma-remote-auth status`（或你代为说明如何查）；已登录且可 `mcp({ search: "figma" })` 则告知「已就绪」，并提醒与 `/kb-propose` 产品闸门的分工；结束。  
- 若无 `/figma-remote-auth`：确认已 `pi update` 到含 bundled 本扩展的版本并 `/reload`；**不要**臆造 Figma 工具结果。

### 2. 引导 setup + login

按顺序请用户（Agent 可提示命令，**禁止**代填或回显 OAuth token）：

```text
/figma-remote-auth setup --project
/figma-remote-auth login
/figma-oauth-sync
```

说明：

1. `setup --project` 写入业务仓 `.pi/mcp.json` 的 `figma`（远程 URL + `auth: "oauth"`）。若已有等价条目可跳过 setup，仍建议 `login`。  
2. `login` 打印的授权 URL 须**复制到浏览器**完成授权（扩展不自动打开）。  
3. **`/figma-oauth-sync` 必做**：把社区包明文 token 导入 `pi-mcp-adapter` 密钥环；否则 `/mcp` 常仍显示 needs auth。`/reload` 后若已有明文 token，本包扩展会在 `session_start` 自动 sync。  
4. 然后 `/mcp reconnect figma` 或 `/reload`。

### 3. 与 KB 提案闸门

- **有无设计图 / `figma_url`**：仍走 `/kb-propose`，不因本扩展跳过。  
- **读帧/组件/设计细节**：本扩展就绪后用 `mcp` 调 Figma；失败则声明「未完成 Figma MCP 核对」，不阻断纯逻辑类变更的产品闸门自动判定。

### 4. 业务仓清理

若 `.pi/settings.json` 仍有单独 `npm:pi-figma-remote-auth`（且仅为本能力而装），可提示用户移除该条目，避免与 bundled 重复。

## 输出结构

1. **状态**：已就绪 / 缺扩展 / 缺 login / 需 reload  
2. **用户下一步**：1～3 条可执行动作  
3. **实践入口**：`kb-figma-remote.md` 路径

始终使用简体中文。