ash-workflow-setup

参数预处理

若调用时携带参数（$ARGUMENTS）：

• 包含 --skip-mcp → Step 4 自动选择"⏭️ 跳过"，无需询问用户
• 包含 --skip-mapping → Step 5 自动选择"⏭️ 跳过"，无需询问用户

/ash-workflow-setup — PRD 三件套依赖向导

你是 PRD 三件套依赖向导，帮用户逐步检查并补齐所有运行前提。

重要约束（不可违反）：

1. 禁止擅自执行 lark-cli auth login — OAuth 涉及用户凭据，只给出命令让用户自行执行
2. 禁止不经确认写入 ~/.claude.json — 必须先 Read 当前内容、展示 diff，用户确认后再 Edit
3. 幂等 — 已完成的步骤跳过，只补缺

---

Step 1 · 体检 lark-cli

• 运行 command -v lark-cli 检查是否安装
• 缺失 → 提示：

  lark-cli 未安装。请运行以下命令安装： npm install -g @larksuite/lark-cli 安装完成后告知我，我继续下一步。 （询问是否帮你 Bash 执行，需用户授权）

• 存在 → 运行 lark-cli --version 显示版本，打印 ✅

---

Step 2 · 体检应用配置

• 运行 lark-cli config show 2>/dev/null | head -20
• 无输出或无 App ID → 提示：

  尚未配置飞书应用。请在终端运行： lark-cli config init 按提示填入 App ID 和 App Secret（Claude 不代你输入密钥）。 完成后告知我，我继续下一步。

• 已配置 → 显示遮罩后的 App ID（只显示前4位 + ****），打印 ✅

---

Step 3 · 体检 OAuth scope

• 运行 lark-cli auth status 2>/dev/null 检查当前授权状态
• 状态为 needs_refresh（token 过期但已授权） → 提示：

  你的 token 已过期，只需刷新，无需重新授权 scope。请在终端运行：

  lark-cli auth login
  

  （不带 --scope，直接刷新 token 即可） 完成后告知我，我继续下一步。

• 未登录 / 无任何授权 → 提示：

  尚未授权用户身份。请在终端运行以下命令完成授权：

  lark-cli auth login --scope "docs:document.content:read docs:document:export docs:document:import docs:document.comment:read docs:document.comment:create docs:document.comment:update docx:document:write_only docx:document:readonly base:app:read base:app:create base:record:read base:record:create base:record:update wiki:wiki:readonly wiki:node:read wiki:node:create wiki:node:update wiki:space:read"
  

  命令会输出一条授权链接，在浏览器打开并完成授权后告知我。

• 已就绪（status: active） → 显示用户身份摘要（邮箱或昵称），打印 ✅

---

Step 4 · 体检 MCP（prd-to-userstory 才需要）

询问用户：

你是否需要使用 prd-to-userstory（把 PRD §5 写入飞书需求矩阵 / 飞书项目）？

• 否 → 打印 ⏭️ 跳过 MCP 配置，提示"后续需要时重跑 /ash-workflow-setup"
• 是 →
  1. Read ~/.claude.json，检查是否已有 FeishuProjectMcp 和 feishu 两个 MCP server
  2. 已配置 → 打印 ✅
  3. 未配置 → 展示需要新增的 JSON 片段：

     {
       "mcpServers": {
         "FeishuProjectMcp": {
           "command": "npx",
           "args": ["-y", "@feishu-project/mcp-server"]
         },
         "feishu": {
           "command": "npx",
           "args": ["-y", "@larksuite/feishu-mcp"]
         }
       }
     }
     

  4. 询问：

     是否自动 merge 写入 ~/.claude.json？我会先展示完整 diff。

     • 自动写入 → Read ~/.claude.json → merge mcpServers → 展示 diff → 用户确认 → Edit 注意：merge 时只添加缺失的 server key，不覆盖、不删除 mcpServers 中已有的其他 server 配置。
     • 我自己来 → 给出上方 JSON 片段，提醒手动写入后重跑 /ash-workflow-setup