重写 Skill 安装指引，让 agent 可自主完成安装与鉴权

[mingxingmeng-ctrl]

合入判断

[APPROVE] — 纯文档改写，重构 Skill 安装指引为「agent 可自路由」结构，内容已对 CLI 源码 + changelog + 两轮全新 agent 端到端实测逐条验证。

3 files · +212 / -134 · docs/skill/install（en / zh-CN / zh-HK）

---

变更概要

• 重写 skill/install/index.md（三语言同步）：把鉴权章节从一行含糊的「在浏览器完成 OAuth」改写为 agent 可消费的完整模型——env-var headless、device-flow（agent 驱动 + 人浏览器批准）、安装 sudo 需真实终端、Homebrew 缺失回退 curl、/plugin 仅交互式。
• 结构从「逐行执行主体标签」收敛为一条元规则 + intent-driven 方法，每个分叉 gate 在可观测条件（command -v brew、auth status、有无 shell）上，让 agent 自决。
• 顶部 <!-- AI INSTRUCTION --> 块为权威 checklist；正文人类向内容（示例、restrictions、截图）保留。

---

风险分析

风险点	等级	缓解措施
命令/行为写错误导 agent	✅	全部命令对 longbridge-terminal v0.22.1 源码（auth.rs/cli/mod.rs/region.rs/context.rs）+ 仓库 changelog 核实；两轮全新 subagent 实测装通 + 登录 + 拉到 AAPL 实时行情
三语言不同步	✅	en/zh-CN/zh-HK 同改，关键命令计数逐项校验一致
触碰非 scope 文件	✅	仅改三份 install/index.md，无 frontmatter/图片/路由改动
构建影响	🟢	纯 Markdown 内容，未改组件/frontmatter/slug

---

设计决策

• 元规则替代逐行标签：用户主导的简化方向，经实测验证 agent 仍能在每个分叉自路由（"every fork was tied to a checkable condition"）。
• gap：鉴权先 auth status：已有有效 token 即跳过，避免对已登录机器多弹一次浏览器批准。
• 术语 AI→agent：执行者语境统一用 "agent"（更精确）；"AI assistant/tool" 指代用户工具的保留。
• .cn region 提示：CLI 自动选区，授权 URL/接口可能落 open.longbridge.cn——文档显式说明以免误判为钓鱼链接（已 region.rs 核实 + 实测复现）。

---

代码关注点

1. [需判断] npx skills add longbridge/skills -g 作为 agent-runnable 的 Skill 安装路径 (docs/*/skill/install/index.md Step 2)
   该工具是 Vercel Labs 的跨平台 skills 生态（已核实非 Claude Code 插件系统），装到 ~/.claude/skills/；建议 reviewer 确认 longbridge/skills 仓可被该工具消费（命令沿用原文档已有写法，未改）。
2. [信息] 文档外发现：install 脚本把二进制下载源硬编码为 open.longbridge.cn（挂在 .com 入口下）——属 longbridge-terminal 仓脚本问题，非本 PR 范围，建议单独反馈。

---

验证状态

✅ 命令对 CLI 源码核实 · ✅ 两轮全新 agent 端到端实测（装→登录→实时行情）· 📋 无 CI 代码测试（纯文档）

[mingxingmeng-ctrl]

Superseded by #1059 — 已获组织写权限，改为同仓 PR（head 从 fork 切到上游分支）。