homepage-craftlisted
Install: claude install-skill uwakeme/wake-skills
# homepage-craft
把一个开源仓库变成一页拿得出手的主页:素材全部来自仓库本身(README、manifest、截图、git 元信息),产物是一个单文件 HTML,双击能开、推到 GitHub Pages 就能发布。视觉质量优先借力环境里已装的设计类 skill,本 skill 负责的是"仓库 → 内容 → 页面"这条流水线和发布可用性。
## 设计原则(贯穿整个 procedure)
| 原则 | 含义 | 反例 |
| --- | --- | --- |
| **内容真实** | 页面上一切事实(功能、数字、链接、截图)都来自仓库素材,拿不到的就不写 | 编造 "10k+ users"、放 stock 占位图、写仓库里不存在的功能 |
| **单文件零构建** | 一个 `index.html` 装下全部 CSS/JS,无 npm、无构建步骤,file:// 直接打开 | 产物需要 `npm install && build` 才能看 |
| **美感有出处** | 设计决策来自 companion skill 或内置基线,并在报告里说明用了哪条路径 | 不声明来源地随手套一个紫色渐变模板 |
| **发布即可用** | OG meta、favicon、JSON-LD、相对路径全配齐,推到 GitHub Pages 就是完成态 | 分享出去没有社交预览卡片;图片路径出了 docs/ 就 404 |
风格基线:**像一个头部开源项目的官网,不是像模板市场的 demo 页。**
---
## Inputs to collect
按需读取,不需要全部问用户:
- **项目路径**:默认当前工作目录;用户给 GitHub URL 时走远程模式(见 Step 2)
- **输出位置**:默认 `<project-root>/docs/index.html`(GitHub Pages 的 /docs 源约定);`docs/` 被文档框架占用时改用 `homepage/index.html`(见 Failure handling)
- **页面语言**:默认跟随主 README 的语言,不问;用户指定了其他语言按用户的来
- **风格偏好**(可选):用户主动说了("暗色"、"极简")就记录;没说且有 companion 设计 skill 时交给它决定;两者都没有时,从基线三方向里按项目类型选,不追问(见 Step 3)
- **部署意向**:不预设、不提前问——Step 7 生成完毕后再询问;用户一开始就明确说"部署到 GitHub Pages"的,Step 7 免询问直接走
- **发布策略**:同样在 Step 7 与部署意向一起问(A:main + /docs;B:独立 gh-pages 分支),不预设默认偏好;用户在需求里指定了("走 gh-pages"、"别动 main")就跳过询问
- **地址回填意向**:也不提前问——Step 8 拿到公开地址后一次性问(README 挂链接 / 仓库 Website 字段 / 两项都做 / 都不做),让用户自己勾选
---
## Procedure
### Step 1 — 扫描项目,收集素材
读取根目录列表和关键 manifest,确定 name、version、description、license、homepage/repository 字段。manifest 类型对照表与 readme-craft 一致(package.json / pyproject.to