[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DMEDN6MJ24CXJK2DAKFQPV":3,"skill-same:01M7DMEDN6MJ24CXJK2DAKFQPV":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":29,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":31,"install":32,"resources":44},"01M7DMEDN6MJ24CXJK2DAKFQPV","create-verification-skill",null,"生成一个只属于当前项目的验证 skill，像用户一样操作你的应用，不限语言、框架或平台。用于 \u002Fcreate-verification-skill、「给这个仓库做个 control skill」，或者项目还没有用脚本证明 UI、CLI 或服务行为的办法时。","fenfenxu\u002Fpstack-zh","fenfenxu","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F2194243?v=4","01M7DMDSWBASX3NXC18FPHDJ8G","01M7DMDSWV8ASCZ4PH6YFXHPSJ",3,"MIT","https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Fcreate-verification-skill\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: create-verification-skill\ndescription: \"生成一个只属于当前项目的验证 skill，像用户一样操作你的应用，不限语言、框架或平台。用于 \u002Fcreate-verification-skill、「给这个仓库做个 control skill」，或者项目还没有用脚本证明 UI、CLI 或服务行为的办法时。\"\ndisable-model-invocation: true\n---\n\n# 创建验证 skill\n\n每个认真的项目都需要一种用脚本操作真实应用、证明其行为的办法：启动应用，像用户那样用一遍某个功能，再留下证据。这个 skill 把这套办法生成为一个按仓库定制的项目本地 skill（`.cursor\u002Fskills\u002Fverify-\u003Capp>\u002F`）。你写的东西是给下一个 agent 看的，不是给人看的：读它的 agent 从没见过这个应用，会在任务进行到一半时毫无背景地读它。\n\n## 1. 问仓库，不问用户\n\n下面这些问题从代码库里找答案，只有观察不到的才问用户：\n\n- **界面：** 用户实际接触的是什么？网页 UI、CLI 或 TUI、桌面应用、API、移动应用，还是一个库？一个仓库可能有好几种。挑主要的那一种，其余的记下来。\n- **运行：** 应用在本地怎么启动？优先用仓库自己写明的开发命令（package 脚本、Makefile、README 里的快速上手）。记下端口、环境变量、种子数据、鉴权。\n- **操作：** agent 怎样用程序和它交互？先找现成的 harness（测试和操作用的脚手架）：Playwright 或 Cypress 的 spec、expect 脚本、PTY 辅助工具、能用 curl 访问的端点、调试端口。都没有，再选一套通用做法：网页和 Electron 用浏览器或 CDP，CLI 和 TUI 用 tmux 或 PTY harness，服务用普通 HTTP。\n- **观察：** 能留下什么证据？截图、终端记录、响应正文、日志、退出码、数据库状态。\n- **隔离：** 能不能同时跑两个实例（端口、数据目录、配置档）？不能的话，在生成的 skill 里写明：宁可拒绝两边同时操作一个共享实例，也不要弄坏用户的会话。\n\n如果当前代码原样无法构建或启动，先修好（或者把问题说准确），再生成 skill。照着坏掉的基础写出来的 skill，教的步骤就是错的。如果启动被一个无关的缺失文件挡住（API 根本不提供的静态目录、一份示例配置），生成的 skill 可以把它建出来，清楚标明这是验证用的临时脚手架，并在清理时删掉。\n\n## 2. 生成 skill\n\n写 `.cursor\u002Fskills\u002Fverify-\u003Capp>\u002FSKILL.md`。文件带 YAML front matter（`name: verify-\u003Capp>`，以及一段写明应用、界面和何时该用的 `description`。没有 front matter，skill 根本不会被注册），并包含下面这些部分，每一部分都要基于前面实际查到的东西（不留任何占位符）：\n\n- **Launch：** 为验证启动应用的确切命令，以及怎么判断它已就绪（某行日志、出现提示符）。Launch 必须从空的数据目录走到可用状态，包括该做的迁移和种子数据。就绪指的是能用，不只是有个进程在应答。数据库的健康检查可以通过，而它的初始化脚本还在跑。写上怎么关掉。对于短命的 CLI 或 TUI，没有需要一直开着的服务：launch 指的是先构建一次二进制（或者装一次依赖），之后每次操作都在独立的 PTY 或 tmux 会话里启动。\n- **Doctor：** 一次只读检查，回答「这个实例值得操作吗？」：进程在跑、版本或构建正确、端口归我们、鉴权有效。只要有哪里不对劲，agent 就先跑这一步。\n- **Drive：** harness 的操作步骤，用这个仓库里真实的选择器和命令，不是举例。优先用稳定的抓手（ARIA 标签、data 属性、提示字符串、路由路径），不要靠坐标和 Tab 顺序。\n- **Evidence：** 证明一件事要留下什么、放在哪里。写明证明的标准：走真实的用户路径，不走内部的 setter 或只供测试用的端点；记录操作本身和操作后的状态，不只是最后一屏；除了看得见的结果，还要验证副作用（写了文件、插了行、发了消息）；只有在生产环境本来就有边界把外部系统隔开的地方，才用 mock。当安全的做法是 dry-run 或测试模式时，要靠观察（文件、网络、git ref）确认它实际跳过了什么，不要看名字就信：有些 dry-run 照样会访问网络或打开浏览器。\n- **Cleanup：** 怎样关掉这次运行开起来的实例。绝不按进程名去杀，只杀你自己启动的。清理只删实例和临时状态，绝不删证据：证明材料在关掉实例后依然保留，放在 skill 指定的位置。\n- **Helpers：** skill 附带的任何脚本都必须可执行，并在 skill 正文里写出调用方式。读的人还得自己反推怎么用的辅助脚本，不算辅助脚本。\n\n## 3. 先建起功能地图\n\n创建 `.cursor\u002Fskills\u002Fverify-\u003Capp>\u002Ffeatures\u002FREADME.md`，再给你能找出的每个面向用户的功能各建一个文件（先从路由、命令、菜单或文档里挑最重要的 3 到 5 个）。照 [`references\u002Ffeature-map-example\u002F`](.\u002Freferences\u002Ffeature-map-example\u002FREADME.md) 的结构来：一个 README 索引，加上每个功能一个文件。每个文件都从用户的角度回答：这个功能是什么，怎么找到它，怎么用 harness 操作它，以及看到什么样的最终状态就能证明它正常。四个二级标题是 `Sub-features`、`How to get to it (user POV)`、`Driving it with \u003Charness>` 和 `Gotchas`。如果种子数据缺了某条路径需要的前提，这条路径就报失败，原因写进该功能的 `Gotchas`。绝不要为了让它通过而把路径放宽。这份地图是仓库持续维护的验证依据。地图里列了别的入口，证明却只走了一个方便的入口，这份证明就不完整。\n\n## 4. 交出去之前先证明生成的 skill 能用\n\n照它自己的说明完整跑一遍：launch、doctor、操作地图里的一个功能（一个就够，地图就是留给以后的运行去覆盖其余功能的）、留下证据、清理。清理之后，确认证据还在指定的位置。清理把证明删了，这一步就算失败。哪里失败就修哪里，每次失败之后也都要跑一遍生成的清理步骤，免得失败的尝试留下没关的进程和占着的端口。一个从没执行过的生成 skill 只是草稿，不是交付物。如果你是在真实目标的替身上证明的（用容器代替一台全新的虚拟机，用本地的一套服务代替远程的），把替身做了、而目标不会做的每一步设置都列出来。这些步骤在真实目标上跑过之前，都还没验证。\n\n## 5. 告诉用户怎么持续维护\n\n告诉用户用 `\u002Fmaintain-verification-skill` 来让地图随着应用变化保持真实。只有用户问起，才建议多久跑一次。\n","# 创建验证 skill\n\n每个认真的项目都需要一种用脚本操作真实应用、证明其行为的办法：启动应用，像用户那样用一遍某个功能，再留下证据。这个 skill 把这套办法生成为一个按仓库定制的项目本地 skill（`.cursor\u002Fskills\u002Fverify-\u003Capp>\u002F`）。你写的东西是给下一个 agent 看的，不是给人看的：读它的 agent 从没见过这个应用，会在任务进行到一半时毫无背景地读它。\n\n## 1. 问仓库，不问用户\n\n下面这些问题从代码库里找答案，只有观察不到的才问用户：\n\n- **界面：** 用户实际接触的是什么？网页 UI、CLI 或 TUI、桌面应用、API、移动应用，还是一个库？一个仓库可能有好几种。挑主要的那一种，其余的记下来。\n- **运行：** 应用在本地怎么启动？优先用仓库自己写明的开发命令（package 脚本、Makefile、README 里的快速上手）。记下端口、环境变量、种子数据、鉴权。\n- **操作：** agent 怎样用程序和它交互？先找现成的 harness（测试和操作用的脚手架）：Playwright 或 Cypress 的 spec、expect 脚本、PTY 辅助工具、能用 curl 访问的端点、调试端口。都没有，再选一套通用做法：网页和 Electron 用浏览器或 CDP，CLI 和 TUI 用 tmux 或 PTY harness，服务用普通 HTTP。\n- **观察：** 能留下什么证据？截图、终端记录、响应正文、日志、退出码、数据库状态。\n- **隔离：** 能不能同时跑两个实例（端口、数据目录、配置档）？不能的话，在生成的 skill 里写明：宁可拒绝两边同时操作一个共享实例，也不要弄坏用户的会话。\n\n如果当前代码原样无法构建或启动，先修好（或者把问题说准确），再生成 skill。照着坏掉的基础写出来的 skill，教的步骤就是错的。如果启动被一个无关的缺失文件挡住（API 根本不提供的静态目录、一份示例配置），生成的 skill 可以把它建出来，清楚标明这是验证用的临时脚手架，并在清理时删掉。\n\n## 2. 生成 skill\n\n写 `.cursor\u002Fskills\u002Fverify-\u003Capp>\u002FSKILL.md`。文件带 YAML front matter（`name: verify-\u003Capp>`，以及一段写明应用、界面和何时该用的 `description`。没有 front matter，skill 根本不会被注册），并包含下面这些部分，每一部分都要基于前面实际查到的东西（不留任何占位符）：\n\n- **Launch：** 为验证启动应用的确切命令，以及怎么判断它已就绪（某行日志、出现提示符）。Launch 必须从空的数据目录走到可用状态，包括该做的迁移和种子数据。就绪指的是能用，不只是有个进程在应答。数据库的健康检查可以通过，而它的初始化脚本还在跑。写上怎么关掉。对于短命的 CLI 或 TUI，没有需要一直开着的服务：launch 指的是先构建一次二进制（或者装一次依赖），之后每次操作都在独立的 PTY 或 tmux 会话里启动。\n- **Doctor：** 一次只读检查，回答「这个实例值得操作吗？」：进程在跑、版本或构建正确、端口归我们、鉴权有效。只要有哪里不对劲，agent 就先跑这一步。\n- **Drive：** harness 的操作步骤，用这个仓库里真实的选择器和命令，不是举例。优先用稳定的抓手（ARIA 标签、data 属性、提示字符串、路由路径），不要靠坐标和 Tab 顺序。\n- **Evidence：** 证明一件事要留下什么、放在哪里。写明证明的标准：走真实的用户路径，不走内部的 setter 或只供测试用的端点；记录操作本身和操作后的状态，不只是最后一屏；除了看得见的结果，还要验证副作用（写了文件、插了行、发了消息）；只有在生产环境本来就有边界把外部系统隔开的地方，才用 mock。当安全的做法是 dry-run 或测试模式时，要靠观察（文件、网络、git ref）确认它实际跳过了什么，不要看名字就信：有些 dry-run 照样会访问网络或打开浏览器。\n- **Cleanup：** 怎样关掉这次运行开起来的实例。绝不按进程名去杀，只杀你自己启动的。清理只删实例和临时状态，绝不删证据：证明材料在关掉实例后依然保留，放在 skill 指定的位置。\n- **Helpers：** skill 附带的任何脚本都必须可执行，并在 skill 正文里写出调用方式。读的人还得自己反推怎么用的辅助脚本，不算辅助脚本。\n\n## 3. 先建起功能地图\n\n创建 `.cursor\u002Fskills\u002Fverify-\u003Capp>\u002Ffeatures\u002FREADME.md`，再给你能找出的每个面向用户的功能各建一个文件（先从路由、命令、菜单或文档里挑最重要的 3 到 5 个）。照 [`references\u002Ffeature-map-example\u002F`](.\u002Freferences\u002Ffeature-map-example\u002FREADME.md) 的结构来：一个 README 索引，加上每个功能一个文件。每个文件都从用户的角度回答：这个功能是什么，怎么找到它，怎么用 harness 操作它，以及看到什么样的最终状态就能证明它正常。四个二级标题是 `Sub-features`、`How to get to it (user POV)`、`Driving it with \u003Charness>` 和 `Gotchas`。如果种子数据缺了某条路径需要的前提，这条路径就报失败，原因写进该功能的 `Gotchas`。绝不要为了让它通过而把路径放宽。这份地图是仓库持续维护的验证依据。地图里列了别的入口，证明却只走了一个方便的入口，这份证明就不完整。\n\n## 4. 交出去之前先证明生成的 skill 能用\n\n照它自己的说明完整跑一遍：launch、doctor、操作地图里的一个功能（一个就够，地图就是留给以后的运行去覆盖其余功能的）、留下证据、清理。清理之后，确认证据还在指定的位置。清理把证明删了，这一步就算失败。哪里失败就修哪里，每次失败之后也都要跑一遍生成的清理步骤，免得失败的尝试留下没关的进程和占着的端口。一个从没执行过的生成 skill 只是草稿，不是交付物。如果你是在真实目标的替身上证明的（用容器代替一台全新的虚拟机，用本地的一套服务代替远程的），把替身做了、而目标不会做的每一步设置都列出来。这些步骤在真实目标上跑过之前，都还没验证。\n\n## 5. 告诉用户怎么持续维护\n\n告诉用户用 `\u002Fmaintain-verification-skill` 来让地图随着应用变化保持真实。只有用户问起，才建议多久跑一次。\n",{"name":5,"description":7,"disable-model-invocation":23},true,"main","e4477188d43269545432a83e4ac5d0733a812d09","skills\u002Fcreate-verification-skill",0,"https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh","http:\u002F\u002Fpstack.ganhai.cloud","https:\u002F\u002Fgithub.com\u002Ffenfenxu","2026-10-21 12:14:41",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":23},[34,37,40],{"tool":35,"command":36},"npx","npx skills add fenfenxu\u002Fpstack-zh --skill create-verification-skill",{"tool":38,"command":39},"bunx","bunx skills add fenfenxu\u002Fpstack-zh --skill create-verification-skill",{"tool":41,"command":42},"pnpm","pnpm dlx skills add fenfenxu\u002Fpstack-zh --skill create-verification-skill","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Fcreate-verification-skill\u002FSKILL.md",[45,51,55],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"references\u002Ffeature-map-example\u002Fcreate-note.md","REFERENCE","参考文档",3068,"https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Fcreate-verification-skill\u002Freferences\u002Ffeature-map-example\u002Fcreate-note.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Ffeature-map-example\u002FREADME.md",2611,"https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Fcreate-verification-skill\u002Freferences\u002Ffeature-map-example\u002FREADME.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Ffeature-map-example\u002Fsearch.md",3534,"https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Fcreate-verification-skill\u002Freferences\u002Ffeature-map-example\u002Fsearch.md",[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M7DMHJV7QMEE1F43FFW98FV8","why","用于「为什么 X 是这样实现的」「为什么选了 Y」、设计理由、回归、事后复盘，或数据支撑的阈值问题。发现可用 MCP 并并行查询各证据类别（源码控制、工单跟踪、长文文档、实时聊天、基础设施可观测性、错误跟踪、产品分析数仓），然后返回带引用的决策与权衡解读。运行时行为请用 how。","https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7DMHHRSS2SCZN6HWSANBJ35","unslop","从任意写作中剔除 AI 痕迹。","https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M7DMHGFGH2YT86WQ6A53693W","typescript-best-practices","TypeScript 最佳实践。读取或编辑任意 .ts 或 .tsx 文件时使用。","https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Ftypescript-best-practices\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M7DMHEA1EGG2D9XQ33N66GDS","technical-writing","分层技术写作标准：Diátaxis 结构、Google 开发者风格句子、STE 指令规则、Global English 句法。用于 \u002Ftechnical-writing，或撰写\u002F审查文档、RFC、README、PR 描述、commit message 时。","https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Ftechnical-writing\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":18},"01M7DMHCEXE1YRDR6XC1RXBG76","teach","用平实语言解释一段工作，让人真正理解。运行 how 与 why skill，把发现织成一份清晰说明。用于「teach me this」「help me really understand X」「explain this change or subsystem to me」。","https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Fteach\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M7DMH9KNBP83SHAW4TGZ4713","tdd","仅当用户明确要求 TDD、失败测试或回归测试时使用，或 bug 有明显且廉价的本地测试目标时使用。测试路径不清、昂贵、偏集成或未要求时跳过。","https:\u002F\u002Fgithub.com\u002Ffenfenxu\u002Fpstack-zh\u002Fblob\u002Fmain\u002Fskills\u002Ftdd\u002FSKILL.md",[],[]]