正文
获取原文件docs/plans/2026-07-13-agent-install-detail-redesign.md
日期：2026-07-13
问题
当前详情页把 git clone 和复制目录作为默认安装方式，要求用户理解不同 Agent 的路径，步骤僵硬。详情页的信息层级也更像 Registry 数据展示，而不是帮助用户理解并立即使用 Skill。
方案
采用“Agent 安装优先、源码入口次要”的双通道：
- 每个 Skill 详情页生成一条自然语言安装提示词。
- 提示词引用统一的仓颉 Skill 安装规范，并包含准确来源和 slug。
- Agent 读取规范后自行识别运行环境、安装目录、Skill 数量和冲突情况。
- 源仓库仍然公开可见，但不再把手动命令当作普通用户主流程。
- 详情页改为主内容加右侧安装卡：左侧解释用途和调用方式，右侧固定展示安装提示词、复制按钮和 Registry 信息。
边界
- 不做 Agent 协议唤起或本地守护进程。
- 不假设所有 Skill 已收录到 SkillHub。
- 不在网站服务器端下载或安装任何文件。
- 对外部来源执行安装前，Agent 必须先检查风险和同名冲突。
验证
- 单元测试覆盖 GitHub 来源和仓库内置来源的提示词生成。
- 详情页不再出现硬编码的 Codex 复制命令。
- 教程和首页统一使用“复制提示词给 Agent”的安装模型。
- 桌面和移动端检查右侧安装卡与复制交互。