[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AV22KNP7VXV3XHPX8JF0KB":3,"skill-same:01M7AV22KNP7VXV3XHPX8JF0KB":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":14,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7AV22KNP7VXV3XHPX8JF0KB","wizard",null,"生成一个交互式 bash 向导，引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘，或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。","muscaestar\u002Fskills","muscaestar","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F34506351?v=4","01M7ATZNAAQJBTZZXCPKAWJQTH","Musca","01M7ATZNBG6JAV06HKBCBPM152",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwizard\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: wizard\ndescription: 生成一个交互式 bash 向导，引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘，或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。\ncommit_version: 321658273cb1d20b76026717d027d505790106d4\n---\n\n# Wizard\n\n**向导（wizard）**是一个 bash 脚本，一步一步地引导人类完成一个手工流程——这种流程手工做很繁琐，每次向 AI 重新解释也很繁琐。它打开每个 URL，精确说明要点哪里、复制什么，捕获这些值，把它们写到该去的地方（`.env`、GitHub secrets），在每个阶段进行确认，并显示还剩多少个阶段。它可能配置第三方服务、执行一次性迁移，或把项目从一种状态迁移到另一种状态。\n\n令人愉悦的 UX 已经由 [template.sh](template.sh) 解决了：逐阶段进度、确认闸门、跨平台 URL 打开（包括 WSL）、隐藏式 secret 输入、幂等的 `.env` 更新、`gh secret`\u002F`gh variable` 写入，以及结尾总结。**你的工作只是界定流程范围并编写它的各个阶段。** `STAGES` 标记以上的库在每个向导中都完全相同；这种一致性正是意义所在：永远不要手工编辑它。\n\n向导默认是临时的：为一次运行而建，保存到 scratch 或 `scripts\u002F` 路径，任务完成后删除。只有当用户想要一个应该留在仓库里的可重复设置路径时才提交它。\n\n## 流程\n\n### 1. 界定流程范围\n\n理出人类必须执行的每一个手工步骤，以及沿途捕获的每一个值。先读仓库，不要空着手问：\n\n- 对于设置类：`.env`、`.env.example`、`.env.*`、`README`、`docker-compose*`、框架配置，以及 `.github\u002Fworkflows\u002F*`（每个 `secrets.*` \u002F `vars.*` 引用都是向导必须产出的一个值）。\n- 对于迁移或切换类：当前状态、目标状态，以及两者之间不可逆的操作。\n\n然后向用户展示按序排列的阶段列表和每个阶段产出的值，并确认：他们可能会增删或调整顺序。\n\n**完成标准：** 每个阶段都按序命名，并且对于每个被捕获的值，你知道 (a) 人类从哪里得到它，(b) 它写到哪里（`.env`、GitHub secret、两者，或都不写；有些阶段是纯操作），以及 (c) 它是 secret（隐藏输入）还是公开值。\n\n### 2. 绘制每个阶段的路径\n\n为每个阶段写出人类要走的精确路径：打开哪个 URL、在那里做什么、值显示在哪里、它填入哪个变量：例如 \"Dashboard → Developers → API keys → Reveal test key → copy\"。在你并不真正了解当前 UI 或确切命令的地方，明说并询问用户或查阅文档：永远不要编造可能不存在的步骤。\n\n**完成标准：** 每个阶段都能追溯到陌生人也能照着做的具体指示。\n\n### 3. 编写向导\n\n把 `template.sh` 复制到目标路径。用每一步一个 `stage` 替换示例阶段，按依赖顺序排列。使用库提供的辅助函数：`stage`、`say`\u002F`step`、`open_url`、`ask`\u002F`ask_secret`、`write_env`、`set_secret`\u002F`set_var`、`pause`\u002F`confirm`。把 `TOTAL_STAGES` 设为你写出的阶段数。\n\n坚守模板设定的标准：先打开 URL 再索要它的值；任何 secret 都用 `ask_secret`；每个要持久化的值都 `write_env`；只有 CI 真正需要的值才 `set_secret`；任何不可逆操作之前都 `confirm`。每个 `stage` 会清屏，让只有当前步骤可见：让一个阶段只聚焦一个任务，这样人类需要的任何内容都不会滚出屏幕。不要动标记以上的库。\n\n### 4. 验证并交接\n\n- `bash -n \u003Cscript>`；如果有 `shellcheck` 就运行它。\n- `chmod +x \u003Cscript>`。\n- 不要自己端到端运行它：它会打开浏览器并阻塞等待人类输入。改为静态追踪：第 1 步中的每个值都被捕获并落到了第 1 步指定的位置，且每个 `set_secret` 的名字与 CI 中的 `secrets.*` 引用精确匹配。\n- 告诉用户如何运行它。如果它是一个可重复的设置路径，提交它并从 README 链接过去，让下一个人运行脚本而不是去问 AI。\n","# Wizard\n\n**向导（wizard）**是一个 bash 脚本，一步一步地引导人类完成一个手工流程——这种流程手工做很繁琐，每次向 AI 重新解释也很繁琐。它打开每个 URL，精确说明要点哪里、复制什么，捕获这些值，把它们写到该去的地方（`.env`、GitHub secrets），在每个阶段进行确认，并显示还剩多少个阶段。它可能配置第三方服务、执行一次性迁移，或把项目从一种状态迁移到另一种状态。\n\n令人愉悦的 UX 已经由 [template.sh](template.sh) 解决了：逐阶段进度、确认闸门、跨平台 URL 打开（包括 WSL）、隐藏式 secret 输入、幂等的 `.env` 更新、`gh secret`\u002F`gh variable` 写入，以及结尾总结。**你的工作只是界定流程范围并编写它的各个阶段。** `STAGES` 标记以上的库在每个向导中都完全相同；这种一致性正是意义所在：永远不要手工编辑它。\n\n向导默认是临时的：为一次运行而建，保存到 scratch 或 `scripts\u002F` 路径，任务完成后删除。只有当用户想要一个应该留在仓库里的可重复设置路径时才提交它。\n\n## 流程\n\n### 1. 界定流程范围\n\n理出人类必须执行的每一个手工步骤，以及沿途捕获的每一个值。先读仓库，不要空着手问：\n\n- 对于设置类：`.env`、`.env.example`、`.env.*`、`README`、`docker-compose*`、框架配置，以及 `.github\u002Fworkflows\u002F*`（每个 `secrets.*` \u002F `vars.*` 引用都是向导必须产出的一个值）。\n- 对于迁移或切换类：当前状态、目标状态，以及两者之间不可逆的操作。\n\n然后向用户展示按序排列的阶段列表和每个阶段产出的值，并确认：他们可能会增删或调整顺序。\n\n**完成标准：** 每个阶段都按序命名，并且对于每个被捕获的值，你知道 (a) 人类从哪里得到它，(b) 它写到哪里（`.env`、GitHub secret、两者，或都不写；有些阶段是纯操作），以及 (c) 它是 secret（隐藏输入）还是公开值。\n\n### 2. 绘制每个阶段的路径\n\n为每个阶段写出人类要走的精确路径：打开哪个 URL、在那里做什么、值显示在哪里、它填入哪个变量：例如 \"Dashboard → Developers → API keys → Reveal test key → copy\"。在你并不真正了解当前 UI 或确切命令的地方，明说并询问用户或查阅文档：永远不要编造可能不存在的步骤。\n\n**完成标准：** 每个阶段都能追溯到陌生人也能照着做的具体指示。\n\n### 3. 编写向导\n\n把 `template.sh` 复制到目标路径。用每一步一个 `stage` 替换示例阶段，按依赖顺序排列。使用库提供的辅助函数：`stage`、`say`\u002F`step`、`open_url`、`ask`\u002F`ask_secret`、`write_env`、`set_secret`\u002F`set_var`、`pause`\u002F`confirm`。把 `TOTAL_STAGES` 设为你写出的阶段数。\n\n坚守模板设定的标准：先打开 URL 再索要它的值；任何 secret 都用 `ask_secret`；每个要持久化的值都 `write_env`；只有 CI 真正需要的值才 `set_secret`；任何不可逆操作之前都 `confirm`。每个 `stage` 会清屏，让只有当前步骤可见：让一个阶段只聚焦一个任务，这样人类需要的任何内容都不会滚出屏幕。不要动标记以上的库。\n\n### 4. 验证并交接\n\n- `bash -n \u003Cscript>`；如果有 `shellcheck` 就运行它。\n- `chmod +x \u003Cscript>`。\n- 不要自己端到端运行它：它会打开浏览器并阻塞等待人类输入。改为静态追踪：第 1 步中的每个值都被捕获并落到了第 1 步指定的位置，且每个 `set_secret` 的名字与 CI 中的 `secrets.*` 引用精确匹配。\n- 告诉用户如何运行它。如果它是一个可重复的设置路径，提交它并从 README 链接过去，让下一个人运行脚本而不是去问 AI。\n",{"name":5,"description":7,"commit_version":24},"321658273cb1d20b76026717d027d505790106d4","main","d198f74688d91ee205dcb8e96649a988a256ea4d","matt\u002Fwizard","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills","https:\u002F\u002Fgithub.com\u002Fmuscaestar","muscaestar.xyz","2026-10-19 17:04:10",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add muscaestar\u002Fskills --skill wizard",{"tool":38,"command":39},"bunx","bunx skills add muscaestar\u002Fskills --skill wizard",{"tool":41,"command":42},"pnpm","pnpm dlx skills add muscaestar\u002Fskills --skill wizard","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwizard\u002FSKILL.md",true,[46,52],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"agents\u002Fopenai.yaml","REFERENCE","参考文档",87,"https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwizard\u002Fagents\u002Fopenai.yaml",{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"template.sh","SCRIPT","脚本",8596,"https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwizard\u002Ftemplate.sh",[59,66,73,80,87,94],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":19},"01M7AV2CSM2X530JCZZZMB9G25","skills-link","管理 muscaestar\u002Fskills 仓库的 skill 安装。当用户想安装\u002F卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问\"这个 skill 装了没有\"时使用。也用于向用户解释三层结构与全局\u002F项目双范围安装策略。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fown\u002Fskills-link\u002FSKILL.md",[],[],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AV2B8WFCKB3B8KVBYPVA3N","writing-shape","写作之 exploit：把原始素材塑形成一篇文章，逐段进行。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-shape\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AV2A090EYE2BY7G33GW05X","writing-fragments","写作之 explore：开采原始碎片，还没有结构。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-fragments\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AV281H5H6TDYGPFNH3ZM29","writing-for-agents","为 agents 编写文档。在创建或编辑技能，或修改 AGENTS.md 或 CLAUDE.md 时使用。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7AV24MDVDQV8C67Y65DA9KC","writing-beats","写作之 exploit；把原始素材组装成一段由节拍（beat）构成的旅程，在每个节拍倚赖某个术语之前先把它落地。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwriting-beats\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M7AV20Q86HA3V6F4Q746E5JS","wayfinder","把一大块工作（超过一个 agent 会话能装下的）规划为 issue 跟踪器上一张由决策 ticket 构成的共享地图，然后一次解决一个，直到通往目的地的路清晰可见。","https:\u002F\u002Fgithub.com\u002Fmuscaestar\u002Fskills\u002Fblob\u002Fmain\u002Fmatt\u002Fwayfinder\u002FSKILL.md",[],[]]