Skip to content
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
findsafeskills safety rating

Markdown

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.