# Agent 自适应安装与 Skill 详情页调整

日期：2026-07-13

## 问题

当前详情页把 `git clone` 和复制目录作为默认安装方式，要求用户理解不同 Agent 的路径，步骤僵硬。详情页的信息层级也更像 Registry 数据展示，而不是帮助用户理解并立即使用 Skill。

## 方案

采用“Agent 安装优先、源码入口次要”的双通道：

1. 每个 Skill 详情页生成一条自然语言安装提示词。
2. 提示词引用统一的仓颉 Skill 安装规范，并包含准确来源和 slug。
3. Agent 读取规范后自行识别运行环境、安装目录、Skill 数量和冲突情况。
4. 源仓库仍然公开可见，但不再把手动命令当作普通用户主流程。
5. 详情页改为主内容加右侧安装卡：左侧解释用途和调用方式，右侧固定展示安装提示词、复制按钮和 Registry 信息。

## 边界

- 不做 Agent 协议唤起或本地守护进程。
- 不假设所有 Skill 已收录到 SkillHub。
- 不在网站服务器端下载或安装任何文件。
- 对外部来源执行安装前，Agent 必须先检查风险和同名冲突。

## 验证

- 单元测试覆盖 GitHub 来源和仓库内置来源的提示词生成。
- 详情页不再出现硬编码的 Codex 复制命令。
- 教程和首页统一使用“复制提示词给 Agent”的安装模型。
- 桌面和移动端检查右侧安装卡与复制交互。