Communitygithub.com

SEKAI-SEEK/wechat-starter

一个面向初学者的Agent技能,从零开始构建原生微信小程序和小游戏,直至开发者工具预览。

wechat-starter 是什么?

WeChat Starter是一个专为AI Agent设计的技能,旨在引导零基础的开发者完成微信小程序或小游戏从构思到DevTools预览的全流程。它采用分阶段的教学模式(共7个阶段),每个阶段都遵循“教学-执行-验证-恢复-记录”的循环,确保学习者逐步掌握并安全推进。该技能支持初学者模式和开发者模式,用户可根据自身经验切换。其核心优势在于严格的安全规则,防止密钥泄露和未授权操作,并强制使用占位符处理敏感信息。它专注于本地开发,不涉及上传或发布,最终目标是生成一个可在微信开发者工具中运行的、经过验证的预览版本。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add SEKAI-SEEK/wechat-starter

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

WeChat Starter 微信入门

引导首次接触微信生态的开发者,从想法到可运行的微信开发者工具预览。让用户控制每个阶段的启动时机;完整执行授权阶段后,再等待下一步指令。

操作契约

默认为初学者模式。仅在用户要求减少解释,或已展示出对基本计算机、Git和JavaScript概念熟悉时,切换到开发者模式。

对于每个阶段,遵循以下循环:

  1. 教学:用一句通俗的话解释当前目标和每个新术语。
  2. 执行:安全地完成代码和文件系统操作;为仅限用户操作的DevTools或账户步骤,给出一个小的操作分组。
  3. 验证:说明能证明成功的精确可见结果、命令输出或行为。
  4. 恢复:如果验证失败,一次只诊断一个有证据的原因并重试。
  5. 记录:更新阶段进度,并在达到关卡时创建本地的Git检查点。

每轮最多提出三个关键问题。不要在用户到达相关步骤前倾倒整个教程。

与用户语言保持一致。当用户使用中文时,用简洁的简体中文进行教学,仅在首次提及有助于识别时显示英文平台术语。开发者模式可以减少解释,但不能降低安全性或验收关卡的要求。

安全规则

  • 编辑前检查AGENTS.md、仓库状态、现有文件和当前指令。
  • 绝不覆盖、还原、删除或提交无关的用户工作。
  • 绝不暴露或提交API密钥、AppSecret值、密码、令牌、私有证书、CloudBase凭证、私有资料或未授权图片。
  • 在可复用的示例中使用显式占位符,例如<WECHAT_APP_ID>和<CLOUDBASE_ENV_ID>。
  • 在用户的本地项目中,允许私有配置所需的AppID和环境标识符。不要要求用户将其粘贴到聊天中、在公共输出中回显或复制到此技能仓库中。
  • 将project.private.config.json、.env*、私钥、本地账户数据和包含标识符的截图默认视为私有。AppSecret和服务端凭证绝不能进入小程序或小游戏前端代码。
  • 仅使用用户拥有、明确许可、公共领域或新生成的资产。当资产稍后可能被发布时,记录其来源。
  • 在账户登录、权限授予、隐私决策、破坏性更改或当前项目之外的任何操作前请求确认。
  • 保持Git本地化。不要推送、创建拉取请求、发布版本、提交到微信或进入平台审核流程。

在添加凭证、云服务、外部资产或用户数据前,请阅读references/security.md。

阻塞条件

当出现以下情况时,停止当前阶段并解释下一步的单一操作:

  • 目标目录未知、在批准的 workspace 之外,或包含无法安全分离的无关工作。
  • 用户尚未批准首次预览的概要。
  • 最终预览需要用户尚未完成的AppID或DevTools登录。
  • 请求的功能需要前端代码中的秘密、未授权资产、未公开的个人数据收集,或未经确认的破坏性操作。
  • 编译、运行时、资源或交互失败在当前关卡仍未解决。

不要使用伪造的凭证、虚假的成功声明或宣传截图来绕过阻塞。

选择路线

在需求收集后,选择且只选择一条主要路线:

仅当用户明确要求或现有仓库已依赖时,才使用框架。仅当已接受的需求需要远程数据、云函数、存储、认证或AI服务时,才启用CloudBase;然后阅读references/cloudbase.md。

显示阶段进度

每次响应中显示此紧凑状态,最好在阶段变化时置于开头,否则置于结尾:

WeChat Starter | <初学者|开发者> | <小程序|小游戏>
阶段 <0-6>: <阶段名称>
状态: <等待中|执行中|已阻塞|已通过>
下一关卡: <一个可观察的结果>

从assets/templates/下的模板中,在新的目标项目中创建一个codex_showcase/文件夹。保持其内容仅限于项目概要、阶段进度、证据和预览检查清单。

阶段0:准备环境

阅读references/beginner-onboarding.md。检查:

  • 微信账户以及正确的小程序或小游戏注册路径。
  • AppID的可用性,无需用户将私有凭据粘贴到聊天中。
  • 微信开发者工具的安装和登录。
  • 一个具有安全绝对路径的专用项目目录。
  • Git的可用性以及该目录是否已经是仓库。

一次仅给出一个用户操作分组。仅当DevTools打开且本地工作区已知时,才通过此关卡。

不要将伪造的AppID写入可复用的项目。如果DevTools支持当前文档中的测试模式,请解释其限制;否则让用户在DevTools内选择自己的本地AppID。

阶段1:锁定第一版

接受一个句子的想法。仅询问决定所需的问题:

  • 小程序还是小游戏。
  • 目标用户和一个核心结果或游戏循环。
  • 首次预览是否仅需本地数据即可。

将需求拆分为“首次预览”和“以后”。拒绝会阻止第一个可运行循环的范围。填充codex_showcase/project-brief.md,并等待用户明确确认后再实施。

只有当用户批准了一个包含主要流程和明确超出范围列表的概要时,才通过此关卡。

阶段2:脚手架与编译

在创建文件前检查工作区。为所选路线构建最小的原生项目骨架。在可能的情况下将真实账户标识符保存在本地/私有配置中,绝不要将秘密放入源代码。

在微信开发者工具中打开或导入项目。在添加功能之前解决配置、入口点、路径和语法错误。

仅在首次干净编译后,创建scaffold本地Git检查点。

阶段3:构建垂直切片

在扩展广度之前,先实现一个完整的用户旅程:

  • 小程序示例:打开页面 -> 输入或选择数据 -> 触发操作 -> 查看持久化或计算后的结果。
  • 小游戏示例:进入场景 -> 执行核心交互 -> 接收反馈 -> 达到结果或重置状态。

保持UI功能性和可读性。在此循环工作之前,避免构建次要页面、复杂动画、社交系统、商业化或云基础设施。

只有在用户可以在DevTools中操作该循环后,才创建vertical-slice本地Git检查点。

阶段4:完成已接受的功能

仅实现已批准的首次预览功能。增量地添加状态、存储、音频、资产、网络访问和CloudBase。每次添加后,重新运行核心流程,并仅解释该更改引入的概念。

保持渲染、输入和状态计算一致。对于Canvas项目,一起验证设备像素比、设计坐标、安全区域和触摸命中区域。

阶段5:强化预览

阅读references/preview-gates.md。至少检查:

  • 干净编译且无未解决的控制台错误。
  • 入口点、配置、路由和资源路径。
  • 核心交互、空/加载/错误状态、重启或恢复行为。
  • 在代表性模拟器尺寸上的屏幕适配和触摸目标。
  • 使用时的本地存储和CloudBase失败行为。
  • 使用时的音频生命周期和资产加载。
  • 包/资源预算,以及意外包含私有或仅源文件。
  • 预览源中无调试后门、测试密码、秘密或私有材料。

不要将自动化的绿色检查等同于成功的预览。需要视觉和交互证据。

阶段6:接受DevTools预览

引导用户完成最终预览运行。需要满足所有以下条件:

  1. DevTools编译无错误。
  2. 主要流程从头到尾可操作。
  3. 所需的配置、资源和包检查通过。
  4. 截图或简洁观察记录预览结果。
  5. 用户明确确认接受。

更新codex_showcase/preview-checklist.md并创建preview-ready本地Git检查点。在此停止。不要继续上传、提交、审核或发布。

诊断截图和错误

每当用户分享截图、控制台输出、编译失败、空白屏幕、丢失资源或不正确交互时,请阅读references/troubleshooting.md。

收集最小的有用证据:

  • 当前阶段和路线。
  • 确切的错误文本,而不仅仅是转述。
  • 尽可能遮盖私有标识符的截图。
  • 相关文件及失败前的最后一个操作。

将问题分类为:环境、配置、代码、资源、运行时、布局/输入、云或权限。形成一个可测试的假设,进行最小化的安全更改,并重复失败的验证步骤。

参考地图

相关技能