[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7538E2VYSTYGR7XR90MAH7K":3,"skill-same:01M7538E2VYSTYGR7XR90MAH7K":70},{"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":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":29,"install":30,"resources":43},"01M7538E2VYSTYGR7XR90MAH7K","agent-skillopt",null,"Create review-gated portable Skill packages for coding agents.","naipi11\u002FAgent-SkillOpt","naipi11","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F101078423?v=4","01M7538C5GX9CSY4AD6N97SVSJ","01M7538C6QGCDZ9DDDZQNJQKM4",3,"MIT","https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt\u002Fblob\u002Fmain\u002Fskills\u002Fagent-skillopt\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: agent-skillopt\ndescription: Create review-gated portable Skill packages for coding agents.\n---\n\n# Agent-SkillOpt\n\n用此 Skill 创建一个可版本控制、可离线验证的四宿主 Skill 包。创建与验证默认离线；\n不得读取密钥、安装依赖、访问网络或执行用户提供的脚本。\n\n## 收集最小规格\n\n一次只询问一个缺失项，并把已回答的完整规格保留在当前对话记忆中。依次收集：\n\n1. 规范化的 Skill 名称。\n2. 预期结果与何时应使用此 Skill。\n3. 关键约束与授权边界。\n4. 项目本地的目标目录。\n5. 有意义的离线验证方式。\n6. 至少一个离线测试案例；如果任务有明确的失败边界，再补一个 negative case。\n\n仅在有明确用途时加入 reference、script、asset 或测试资源；不要默认生成可选资源。\n依据 [portable-bundle-contract](references\u002Fportable-bundle-contract.md) 和\n[skill-authoring-rubric](references\u002Fskill-authoring-rubric.md) 组织正文与资源。\n\n## 预览、确认与创建\n\n先解析当前正在阅读的 SKILL.md 的绝对路径，并令 `SKILL_DIRECTORY` 为该文件所在的绝对\n目录。不要假定仓库检出目录、当前工作目录或任一宿主的安装路径。将完整 JSON 规格通过\n标准输入交给紧邻当前 Skill 的确定性包装器；不要将规格写成临时文件：\n\n```text\n\u003CJSON specification> | python \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py preview --spec -\n```\n\n展示预览 JSON 的 `output_directory`、全部 `files` 和 `confirmation_token`。可选资源是\n`files` 中的路径条目，不存在顶层 `resources` 字段。随后立即停止，等待用户对该提案做出\n明确批准。不得在用户批准前调用 apply。\n\n批准后，使用同一份完整 JSON 规格和预览返回的完全一致令牌：\n\n```text\n\u003CJSON specification> | python \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py apply --spec - --confirm \u003Cpreview-token>\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py validate --path \u003Ccreated-bundle>\n```\n\n令牌缺失、过期、规格或目标目录改变时，重新预览。确定性脚手架不可用时，报告该限制；\n绝不能手写包文件作为替代方案。验证失败时不要安装。\n\n`test_cases` 可声明每个案例的 `prompt`、`required_contains` 和 `forbidden_contains`。\n如果没有声明，脚手架仍会生成一个明确标注的 `smoke-test`，但它没有断言，质量评分会提示\n需要补充有效案例。每个生成包还会带 `tests\u002FREADME.md` 和 `tests\u002Fcases\u002F*.json`。\n\n## 质量评分与安全审查\n\n包创建并通过 `validate` 后，先生成静态质量和安全报告：\n\n```text\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py review --path \u003Ccreated-bundle>\n```\n\n`review` 只读取已验证包，不执行 Skill、script、hook、model 或 network。它检查推荐的\n`When to use`、`Procedure`、`Output`、`Safety` 章节，测试案例完整性，以及 secret-like\n值、指令覆盖、shell、网络和破坏性操作模式。报告中的 `quality_score` 是可复现的静态\n评分，不是模型运行效果证明；报告会明确包含 `executed: false` 和\n`network_accessed: false`；高风险安全发现会阻断报告。\n\n如果用户或宿主已经在独立授权下收集了响应，把响应保存为 JSON 后再评分：\n\n```json\n{\"responses\": {\"case-name\": \"response text\"}}\n```\n\n```text\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py evaluate \\\n  --path \u003Ccreated-bundle> --responses responses.json\n```\n\n`evaluate` 只对提供的文本做 required\u002Fforbidden 断言，不运行模型、宿主或生成 Skill。\n\n## 仅渲染安装计划\n\n离线验证成功后，询问用户选择一个宿主。Codex、Claude 和 OpenClaw 仅渲染本地包计划：\n\n```text\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py install --host \u003Ccodex|claude|openclaw> --path \u003Ccreated-bundle>\n```\n\nHermes 必须声明明确的 `\u003Cowner>\u002F\u003Crepository>` Git source；下面命令也只渲染计划，远端内容可变且在实际执行时需要网络。\n如需把随后 Hermes 安装固定到已复核的精确内容身份，再提供可选 `--source-ref \u003C40-char-sha>`：\n\n```text\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py install --host hermes --path \u003Ccreated-bundle> --source \u003Cowner>\u002F\u003Crepository> --source-ref \u003C40-char-sha>\n```\n\n说明渲染出的命令和网络边界，参考 [host-installation](references\u002Fhost-installation.md)。\n不得执行安装、启用、检查或重启。只有用户随后单独请求在选定宿主执行该计划，并提供\n与该渲染计划匹配的确认令牌时，才可以请求带 `--execute --confirm \u003Cinstall-token>` 的执行。\n","# Agent-SkillOpt\n\n用此 Skill 创建一个可版本控制、可离线验证的四宿主 Skill 包。创建与验证默认离线；\n不得读取密钥、安装依赖、访问网络或执行用户提供的脚本。\n\n## 收集最小规格\n\n一次只询问一个缺失项，并把已回答的完整规格保留在当前对话记忆中。依次收集：\n\n1. 规范化的 Skill 名称。\n2. 预期结果与何时应使用此 Skill。\n3. 关键约束与授权边界。\n4. 项目本地的目标目录。\n5. 有意义的离线验证方式。\n6. 至少一个离线测试案例；如果任务有明确的失败边界，再补一个 negative case。\n\n仅在有明确用途时加入 reference、script、asset 或测试资源；不要默认生成可选资源。\n依据 [portable-bundle-contract](references\u002Fportable-bundle-contract.md) 和\n[skill-authoring-rubric](references\u002Fskill-authoring-rubric.md) 组织正文与资源。\n\n## 预览、确认与创建\n\n先解析当前正在阅读的 SKILL.md 的绝对路径，并令 `SKILL_DIRECTORY` 为该文件所在的绝对\n目录。不要假定仓库检出目录、当前工作目录或任一宿主的安装路径。将完整 JSON 规格通过\n标准输入交给紧邻当前 Skill 的确定性包装器；不要将规格写成临时文件：\n\n```text\n\u003CJSON specification> | python \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py preview --spec -\n```\n\n展示预览 JSON 的 `output_directory`、全部 `files` 和 `confirmation_token`。可选资源是\n`files` 中的路径条目，不存在顶层 `resources` 字段。随后立即停止，等待用户对该提案做出\n明确批准。不得在用户批准前调用 apply。\n\n批准后，使用同一份完整 JSON 规格和预览返回的完全一致令牌：\n\n```text\n\u003CJSON specification> | python \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py apply --spec - --confirm \u003Cpreview-token>\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py validate --path \u003Ccreated-bundle>\n```\n\n令牌缺失、过期、规格或目标目录改变时，重新预览。确定性脚手架不可用时，报告该限制；\n绝不能手写包文件作为替代方案。验证失败时不要安装。\n\n`test_cases` 可声明每个案例的 `prompt`、`required_contains` 和 `forbidden_contains`。\n如果没有声明，脚手架仍会生成一个明确标注的 `smoke-test`，但它没有断言，质量评分会提示\n需要补充有效案例。每个生成包还会带 `tests\u002FREADME.md` 和 `tests\u002Fcases\u002F*.json`。\n\n## 质量评分与安全审查\n\n包创建并通过 `validate` 后，先生成静态质量和安全报告：\n\n```text\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py review --path \u003Ccreated-bundle>\n```\n\n`review` 只读取已验证包，不执行 Skill、script、hook、model 或 network。它检查推荐的\n`When to use`、`Procedure`、`Output`、`Safety` 章节，测试案例完整性，以及 secret-like\n值、指令覆盖、shell、网络和破坏性操作模式。报告中的 `quality_score` 是可复现的静态\n评分，不是模型运行效果证明；报告会明确包含 `executed: false` 和\n`network_accessed: false`；高风险安全发现会阻断报告。\n\n如果用户或宿主已经在独立授权下收集了响应，把响应保存为 JSON 后再评分：\n\n```json\n{\"responses\": {\"case-name\": \"response text\"}}\n```\n\n```text\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py evaluate \\\n  --path \u003Ccreated-bundle> --responses responses.json\n```\n\n`evaluate` 只对提供的文本做 required\u002Fforbidden 断言，不运行模型、宿主或生成 Skill。\n\n## 仅渲染安装计划\n\n离线验证成功后，询问用户选择一个宿主。Codex、Claude 和 OpenClaw 仅渲染本地包计划：\n\n```text\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py install --host \u003Ccodex|claude|openclaw> --path \u003Ccreated-bundle>\n```\n\nHermes 必须声明明确的 `\u003Cowner>\u002F\u003Crepository>` Git source；下面命令也只渲染计划，远端内容可变且在实际执行时需要网络。\n如需把随后 Hermes 安装固定到已复核的精确内容身份，再提供可选 `--source-ref \u003C40-char-sha>`：\n\n```text\npython \u003Cabsolute-SKILL-directory>\u002Fscripts\u002Fscaffold_bundle.py install --host hermes --path \u003Ccreated-bundle> --source \u003Cowner>\u002F\u003Crepository> --source-ref \u003C40-char-sha>\n```\n\n说明渲染出的命令和网络边界，参考 [host-installation](references\u002Fhost-installation.md)。\n不得执行安装、启用、检查或重启。只有用户随后单独请求在选定宿主执行该计划，并提供\n与该渲染计划匹配的确认令牌时，才可以请求带 `--execute --confirm \u003Cinstall-token>` 的执行。\n",{"name":5,"description":7},"main","a12c2b5f73dfcee78409033158906c4958241e27","skills\u002Fagent-skillopt",0,"https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt","https:\u002F\u002Fgithub.com\u002Fnaipi11","2026-08-26 16:04:31",{"source":8,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add naipi11\u002FAgent-SkillOpt --skill agent-skillopt",{"tool":36,"command":37},"bunx","bunx skills add naipi11\u002FAgent-SkillOpt --skill agent-skillopt",{"tool":39,"command":40},"pnpm","pnpm dlx skills add naipi11\u002FAgent-SkillOpt --skill agent-skillopt","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt\u002Fblob\u002Fmain\u002Fskills\u002Fagent-skillopt\u002FSKILL.md",true,[44,50,56,60,64],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"assets\u002Fskill-package-template\u002FREADME.md","ASSET","资产文件",570,"https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt\u002Fblob\u002Fmain\u002Fskills\u002Fagent-skillopt\u002Fassets\u002Fskill-package-template\u002FREADME.md",{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fhost-installation.md","REFERENCE","参考文档",2422,"https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt\u002Fblob\u002Fmain\u002Fskills\u002Fagent-skillopt\u002Freferences\u002Fhost-installation.md",{"path":57,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":58,"sourceHtmlUrl":59},"references\u002Fportable-bundle-contract.md",1320,"https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt\u002Fblob\u002Fmain\u002Fskills\u002Fagent-skillopt\u002Freferences\u002Fportable-bundle-contract.md",{"path":61,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":62,"sourceHtmlUrl":63},"references\u002Fskill-authoring-rubric.md",862,"https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt\u002Fblob\u002Fmain\u002Fskills\u002Fagent-skillopt\u002Freferences\u002Fskill-authoring-rubric.md",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"scripts\u002Fscaffold_bundle.py","SCRIPT","脚本",1014,"https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt\u002Fblob\u002Fmain\u002Fskills\u002Fagent-skillopt\u002Fscripts\u002Fscaffold_bundle.py",[71],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M7538JV1GJ1BX05J0YMQZVPZ","minimal-skill","Valid description.","https:\u002F\u002Fgithub.com\u002Fnaipi11\u002FAgent-SkillOpt\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fminimal-skill\u002Fskills\u002Fminimal-skill\u002FSKILL.md",[],[]]