Back to search
game-to-xhs
SkillWorks with Claude CodeGitHub
把「想法」或「想复刻的游戏」做成能上架小红书的小工具:需求引导 → 方案冻结(12 份文档) → 分阶段开发 → 名字/图标/封面 → preflight → 打包 → 上传预览 → 送审,全程同一个 agent 完成。含两套起步工程与零依赖自检脚本。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/davidliu12-code--game-to-xhs)HTML
<a href="/listings/davidliu12-code--game-to-xhs"><img src="/api/listings/davidliu12-code--game-to-xhs/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
克隆或下载后,把整个目录放到当前 agent 的用户级 skill 目录,目录名必须和 `SKILL.md` 里的 `name` 一致:
# macOS / Linux git clone https://github.com/DavidLiu12-code/game-to-xhs.git ~/.dsh/skills/game-to-xhs # Windows PowerShell git clone https://github.com/DavidLiu12-code/game-to-xhs.git "$env:USERPROFILE\.dsh\skills\game-to-xhs"
也可以手动复制。装完新开会话(或重启 agent),skill 列表里应出现 `game-to-xhs`。
> 目录名写错成别的名字,多数 agent 会拒绝加载。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 104 lines
- ---
- name: game-to-xhs
- description: 把「一个想法」或「一个想复刻的游戏」做成能上架小红书的小工具——在同一个对话里完成需求引导、方案冻结、分阶段开发、名字/简介/图标/封面生成、离线 zip 打包、上传预览与送审。用户说「做一个小红书小工具 / 复刻这个小游戏 / 把这个 H5 做成小工具 / 打包或上传或送审小工具 / 生成小工具图标封面」时使用。
- version: 1.0.1
- ---
- # 小红书小工具工坊
- 从一句想法到一个能过审的小工具,全程在**当前这个对话**里完成。用户不需要懂技术。
- ## 这个 skill 交付什么
- ```
- <工具名>/
- ├── 01_需求/ 需求与复刻取证(P1)
- ├── 02_方案/ 冻结的方案包,12 份文档(P2)
- ├── src/ 源码
- ├── dist/ 可直接打 zip 的产物(根目录有 index.html)
- ├── release/ <工具名>.zip、<工具名>-图标.png、<工具名>-封面.png
- └── docs/ 每阶段验证报告 + preflight 结果
- ```
- 最后能拿到:能过校验的 zip、合规的图标和封面、一套 14 字以内的名字和简介、以及一份「哪些验证真做了、哪些没做」的诚实清单。
- ## 铁律(任何阶段都不许违反)
- 1. **全程一个 agent。** 方案、代码、素材、打包、送审都在当前会话完成。禁止把「方案压缩包 + 一段提示词」交给别的 agent 去开发。
- 2. **不编造。** 没实测的平台能力写 `NOT_RUN`;浏览器跑通 ≠ 模拟器跑通 ≠ 真机跑通;原版游戏的数值拿不到就标 `UNKNOWN`,不许猜一个写进文档。
- 3. **不假成功。** `postNote` 调用成功只代表唤起了发布页,不等于发布成功;`submit` 成功不等于审核通过;SDK 不存在就隐藏按钮,不显示「已关注 / 已发布 / 已保存」。
- 4. **三道门禁。**
- - **G-方案**:P2 方案没冻结,不写正式代码(只能写探针)。
- - **G-包**:`scripts/preflight.js` 没有全 PASS,不打包、不上传。
- - **G-送审**:上传代码包后必须先出预览二维码、用户扫码并**明确回复「预览通过」**,才能送审。任何「已扫码」「应该没问题」都不算。
- 5. **一次性只推进一件事。** 安装依赖、登录、上传、送审、发布,每一步前先问用户,得到同意再做下一件。
- ## 六阶段
- | 阶段 | 做什么 | 出口条件 | 读哪个 |
- |---|---|---|---|
- | **P0 就绪** | 确认开发规范 skill 和 CLI 可用、建目录 | 规范 skill 能读到、`ensure-cli` 版本检查通过 | `references/06-builtin-commands.md` |
- | **P1 需求** | 先问「有没有想复刻的游戏」→ 有链接就取证,没有就聊玩法和目标 | 需求卡填满、原版证据(或「无复刻」的明确记录)落盘 | `references/01-dialogue.md` |
- | **P2 冻结** | 把需求写成 12 份方案文档,让用户逐条确认 | 用户回复「方案没问题」;决策追踪表没有空白项 | `references/02-spec-package.md` |
- | **P3 骨架** | 平台桥接 + 安全区 + 存储 + 空壳页面,先让它在模拟器里跑起来 | 空壳能启动、SDK 缺失也不崩 | `references/03-build-gates.md` |
- | **P4–P6 开发** | 核心玩法 → 界面/中文/音频 → 平台能力与兼容 | 每阶段 PASS/FAIL/NOT_RUN + 证据路径 | `references/03`、`references/07-pitfalls.md` |
- | **P7 发布** | 名字/简介/图标/封面 → 打包 → 自检 → 上传 → 预览 → 送审 | preflight 全 PASS、预览码已扫、用户说「送审」 | `references/04-branding.md`、`references/05-release.md` |
- P0 → P2 是**必须**的。用户只想改一个按钮或只做打包时,走「最小路径」:只做 P7 + 相关回归,并在报告里写清跳过了哪些阶段。
- ## 怎么跟用户说话(新手模式)
- - **一次只问 3–5 个问题**,每个都给选项、给推荐项、给一句人话解释。不要问开放式大问题。
- - **技术决定你来做。** 用户不该被问「要不要用 TypeScript」。你按复杂度和他的设备情况选好,一句话说明理由。
- - **每阶段收尾三行**:做完了什么 / 产物在哪 / 下一步建议 + 一个问句。
- - 用户说「随便 / 你定 / 都行」→ 立刻按推荐项推进,不追问。
- - 用户说的东西做不了(平台不支持、体积超限、版权风险)→ 直接说清限制 + 给 2 个可行替代,别硬做。
- - 不要在对话里贴大段代码和长表格;总结成结论,细节写进文件并给路径。
- ## 目录与命名约定
- - 一个工具一个目录,放在用户当前工作区下的 `<工具名>/`。
- - 源码在 `src/`,产物在 `dist/`(**根目录直接是 index.html**,不许再套一层)。
- - 交付物在 `release/`:`<工具名>.zip`、`<工具名>-图标.png`(512×512)、`<工具名>-封面.png`(1080×1440)。
- - 阶段报告在 `docs/P{阶段}_报告.md`,每条结论后面跟证据路径。
- - 不覆盖用户已有文件:动手前先看目录里有什么,覆盖前备份成 `*.bak-<时间戳>`。
- ## 技术路线(默认双轨,由你选)
- | 情况 | 路线 | 理由 |
- |---|---|---|
- | 玩法单屏、状态简单、无复杂构建需求 | **零构建**:纯 HTML + 外置 JS(ES2017 传统 IIFE)+ CSS | 不用装 npm,改完直接打包,新手最不容易卡 |
- | 多模块、复杂状态机、要拆文件、要长期迭代 | **Vite 工程化**:源码用 ESM/现代语法,构建到 ES2017 + 传统 IIFE | 工程化好,但首次要 `npm install`(需联网,先问用户);构建配置已按容器兼容调好,别改 |
- 两套起步工程都在 `templates/`:`stable-app/`(零构建)、`vite-app/`(Vite 工程化)。复制后改,别从空文件开始写——平台桥接、安全区、存储、音频合成这些坑模板里已经踩平了。
- ## 开工检查表
- 每次接到任务,先按顺序做这几件事(不要跳):
- 1. 读 `references/01-dialogue.md`,判断用户现在处在哪一步(已有方案?只有想法?只想打包?)。
- 2. 确认开发规范可用:当前会话有没有 `minitool-zip-builder` skill?没有就按 `references/06-builtin-commands.md` 里第一段口令安装(装前问用户)。
- 3. 需要上传/送审时再确认 `redapp-cli` 可用,同样按 06 处理。
- 4. 建目录,把本次任务写进 `01_需求/00_任务卡.md`(谁、想做什么、参考对象、期望上线时间)。
- 5. 开始 P1 对话。
- ## 常见追问怎么处理
- - 「帮我把这个 H5 打包上传」→ 只走 P7:`preflight` → 打包 → 上传 → 预览 → 送审;不重写代码,但 preflight 报的错必须修。
- - 「图标不好看,重做」→ 只重跑 `references/04-branding.md` 的图标流程,不碰代码。
- - 「审核被拒了,原因是 XX」→ 读 `references/05-release.md` 的驳回处理,改完走**新版本**流程(不是重新提交同一个包)。
- - 「我想加一个功能」→ 先判断是否影响已冻结的玩法规则;影响就走变更单(`02_方案/变更记录.md`),不影响就直接做 + 补测试。
- ## 参考文件
- - `references/01-dialogue.md` — 引导对话剧本:问什么、怎么问、什么算聊清楚了
- - `references/02-spec-package.md` — 方案包 12 份文档的模板与粒度要求
- - `references/03-build-gates.md` — P3–P7 每阶段的验证项和证据要求
- - `references/04-branding.md` — 名字/简介/图标/封面:硬规格、生成流程、兜底提示词
- - `references/05-release.md` — 打包、上传、预览二维码、送审、驳回处理
- - `references/06-builtin-commands.md` — 三条内置安装口令原文与校验步骤
- - `references/07-pitfalls.md` — 平台踩坑清单(来自真实上线项目)
- - `scripts/preflight.js` — 打包前自检(名字长度、图片比例、zip 结构、CSP/兼容扫描)
- - `scripts/make-zip.js` — 生成根目录含 index.html 的 zip
- - `templates/stable-app/` — 零构建起步工程
- - `templates/vite-app/` — Vite 工程化起步工程
README.md · README · 151 lines
- # game-to-xhs · 小红书小工具工坊
- [](https://github.com/DavidLiu12-code/game-to-xhs/actions/workflows/check.yml)
- 把一个「想法」或「一个想复刻的小游戏」,在**同一个对话里**做成能提交审核的小红书小工具。
- 这个 skill 是一整套流程 + 可执行工具,不是提示词合集:它带着两套跑得起来的起步工程、一个打包前自检脚本、一个零依赖打包脚本,以及一份从真实上线项目里踩出来的平台踩坑清单。
- ```
- 想法 / 复刻链接
- → 需求引导(每轮 3–5 个问题,给选项和推荐)
- → 方案冻结(12 份文档,用户逐条确认)
- → 分阶段开发(P3 骨架 → P4 玩法 → P5 界面音频 → P6 平台能力)
- → 名字 / 简介 / 图标 / 封面(符合平台硬规格)
- → preflight 自检 → 打 zip → 上传 → 预览二维码 → 送审
- ```
- ## 它解决什么问题
- 常见做法是「先找 AI 聊方案 → 把方案压成一个包 + 一段提示词,丢给另一个 agent 写代码」。这个流程有四个固定失败点:
- | 断点 | 这里的做法 |
- |---|---|
- | 方案和代码不在同一个上下文里,细节一传就丢 | 从对话到代码到送审,**全程同一个 agent**,不转包 |
- | 「在我浏览器里能跑」被当成「能上线」 | 明确区分浏览器 / 模拟器 / 真机三层,只有真机能写平台功能 PASS |
- | 拿不到原版数值就编一个 | 证据分级 VERIFIED / PARTIAL / UNKNOWN,UNKNOWN 只进风险表,不进代码常量 |
- | 「已提交」被当成「已发布」 | 三道门禁:方案冻结、preflight 全 PASS、预览二维码 + 用户明确回复「预览通过」 |
- ## 依赖
- 这个 skill 本身是**流程与工具**,真正跟小红书平台交互靠三个配套 skill / CLI:
- | 依赖 | 用途 | 是否必需 |
- |---|---|---|
- | `minitool-zip-builder` | 小工具开发规范:容器能力、离线打包、兼容基线 | 写代码前必需 |
- | `redapp-cli` | 上传代码包/图片、生成预览二维码、送审、状态查询、本地模拟器 | 发布阶段必需 |
- | `redskillhub-upload` | 把 skill 发布到小红书 SkillHub | 只有「发布 skill」时需要 |
- 安装口令原文在 `references/06-builtin-commands.md`,里面也写了安装后的版本校验方式(`CLI_VERSION_JSON.status` 只认 `current` / `installed` / `updated`)。
- 另外需要:Node.js ≥ 20(`redapp dev` 需要 20+)、一个小红书小工具创作者账号。
- ## 安装
- 克隆或下载后,把整个目录放到当前 agent 的用户级 skill 目录,目录名必须和 `SKILL.md` 里的 `name` 一致:
- ```bash
- # macOS / Linux
- git clone https://github.com/DavidLiu12-code/game-to-xhs.git ~/.dsh/skills/game-to-xhs
- # Windows PowerShell
- git clone https://github.com/DavidLiu12-code/game-to-xhs.git "$env:USERPROFILE\.dsh\skills\game-to-xhs"
- ```
- 也可以手动复制。装完新开会话(或重启 agent),skill 列表里应出现 `game-to-xhs`。
- > 目录名写错成别的名字,多数 agent 会拒绝加载。
- ## 目录结构
- ```
- game-to-xhs/
- ├── SKILL.md # 主入口:铁律、六阶段、对话规范、技术路线
- ├── references/
- │ ├── 01-dialogue.md # 引导对话剧本:问什么、怎么问、什么算聊清楚了
- │ ├── 02-spec-package.md # 12 份方案文档的模板与粒度
- │ ├── 03-build-gates.md # P3–P7 验证项与证据要求
- │ ├── 04-branding.md # 名字/简介/图标/封面硬规格 + 生成提示词
- │ ├── 05-release.md # 打包、上传、预览二维码、送审、驳回处理
- │ ├── 06-builtin-commands.md # 依赖安装口令原文与校验步骤
- │ └── 07-pitfalls.md # 平台踩坑清单(现象 → 原因 → 正确做法)
- ├── scripts/
- │ ├── preflight.js # 打包前自检(零依赖,node 直接跑)
- │ └── make-zip.js # 生成根目录含 index.html 的 zip(零依赖)
- └── templates/
- ├── stable-app/ # 零构建起步工程:纯 HTML + 外置 JS(ES2017 IIFE)
- └── vite-app/ # Vite 工程化起步工程:源码 ESM,构建到 ES2017 + IIFE
- ```
- ## 自检脚本
- `preflight.js` 会检查人和 CLI 都不会替你检查的东西:
- - 名字 / 简介是否 ≤14 字符(按 JS `.length`,emoji 可能算 2)
- - 图标是否 1:1、封面是否 3:4(直接解析 PNG IHDR / JPEG SOF,不信任文件名)
- - zip 包结构:中央目录解析、根目录必须直接是 `index.html`、拒绝绝对路径 / `..` 越界 / 重复路径 / 软链 / 隐藏文件 / 音视频扩展名
- - 源码扫描:内联 `<script>`、行内 `on*=`、`javascript:`、外链、`fetch` / `XHR` / `eval` / `new Function` / WASM、ES2020+ 语法、Chrome 61 不支持的 CSS、安全区兜底、存储降级链
- ```bash
- # 检查目录
- node scripts/preflight.js --dir ./dist --name "点点星球" --slogan "30秒看谁点得准" \
- --version 1.0.0 --icon icon.png --cover cover.png
- # 打包
- node scripts/make-zip.js --dir ./dist --out release/tool.zip
- # 检查 zip
- node scripts/preflight.js --zip release/tool.zip --name "点点星球" --slogan "30秒看谁点得准" \
- --version 1.0.0 --icon icon.png --cover cover.png --json docs/preflight.json
- ```
- 退出码:`0` 通过、`1` 有 FAIL、`2` 用法或输入错误。
- ## 开发自检 / CI
- 仓库自带 GitHub Actions([`check.yml`](.github/workflows/check.yml)),每次 push 会跑:
- 1. `node --check` 语法检查(脚本与零构建模板)
- 2. 生成测试用图标(512×512)与封面(1080×1440)
- 3. 零构建模板 preflight → 必须 0 FAIL
- 4. `make-zip.js` 打包 → 再对 zip 跑一次 preflight
- 5. Vite 模板 `npm install` + `build` → 对 `dist/` 跑 preflight
- 6. **反例回归**:喂 512×600 的图标和 1000×1000 的封面,必须被拦下并报出 1:1 / 3:4 错误
- 本地跑同一套:
- ```bash
- node scripts/dev-make-test-images.js .test-assets
- node scripts/preflight.js --dir templates/stable-app --name 演示工具 --slogan 一句话说明 \
- --version 1.0.0 --icon .test-assets/icon.png --cover .test-assets/cover.png
- ```
- `scripts/dev-make-test-images.js` 只是生成自检用的纯色 PNG,不是设计素材。
- ## 已验证 / 未验证
- 已验证(Windows + Node v24.19.0):
- - `templates/stable-app/`:preflight 0 FAIL 0 WARN → `make-zip.js` 打出 6 文件 / 33KB → 12.6KB 的 zip → `preflight --zip` 仍 0 FAIL
- - `templates/vite-app/`:`npm install` + `vite build` 通过(产物约 16KB),构建产物 preflight 0 FAIL 0 WARN → 打包后 6.7KB
- - 故意做错的输入会被拦下:图标 512×600 报「图标必须是 1:1」,封面 1000×1000 报「封面必须是 3:4」
- 未验证 / 会随平台变化的:
- - 真机(Android / iOS)扫码后的表现只能由真实设备确认,脚本不代替这一步
- - 小红书平台的表单限制、端能力权限、SkillHub 上传白名单都可能调整;`references/` 里的数值是写作时的实测结果,用之前建议核对一次官方文档
- ## 已知限制
- - 平台**不支持直接上传 mp3 / wav 等音频文件**,音频只能走 Web Audio 程序化合成(模板里已实现);改扩展名规避会被拒,且不要静音交付还标「通过」。
- - 容器内 CSP 禁止内联脚本、行内事件、外链资源、`fetch` / `XHR`、ESM 直出,JS 必须外置并用传统 IIFE。
- - 容器里 `env(safe-area-inset-*)` 恒为 0,安全区要靠 `getWindowInfo()` 取到再写成 CSS 变量(模板里已处理)。
- - 平台能力按「方法是否存在」判断,不要按版本号猜;SDK 缺失时页面必须完整可玩。
- ## 免责声明
- 本项目是**第三方个人工具**,与小红书官方无隶属或背书关系。所有平台接口、限制、审核标准以官方文档和实际控制台为准;使用本项目产生的内容、账号和合规责任由使用者承担。`references/06-builtin-commands.md` 里的安装口令来自官方发布页,仅作流程内引用。
- ## License
- MIT,见 [LICENSE.md](LICENSE.md)。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.