naipi11 Agent-SkillOpt
用此 Skill 创建一个可版本控制、可离线验证的四宿主 Skill 包。创建与验证默认离线； 不得读取密钥、安装依赖、访问网络或执行用户提供的脚本。
收集最小规格
一次只询问一个缺失项，并把已回答的完整规格保留在当前对话记忆中。依次收集：
- 规范化的 Skill 名称。
- 预期结果与何时应使用此 Skill。
- 关键约束与授权边界。
- 项目本地的目标目录。
- 有意义的离线验证方式。
- 至少一个离线测试案例；如果任务有明确的失败边界，再补一个 negative case。
仅在有明确用途时加入 reference、script、asset 或测试资源；不要默认生成可选资源。 依据 portable-bundle-contract 和 skill-authoring-rubric 组织正文与资源。
预览、确认与创建
先解析当前正在阅读的 SKILL.md 的绝对路径，并令 SKILL_DIRECTORY 为该文件所在的绝对
目录。不要假定仓库检出目录、当前工作目录或任一宿主的安装路径。将完整 JSON 规格通过
标准输入交给紧邻当前 Skill 的确定性包装器；不要将规格写成临时文件：
<JSON specification> | python <absolute-SKILL-directory>/scripts/scaffold_bundle.py preview --spec -
展示预览 JSON 的 output_directory、全部 files 和 confirmation_token。可选资源是
files 中的路径条目，不存在顶层 resources 字段。随后立即停止，等待用户对该提案做出
明确批准。不得在用户批准前调用 apply。
批准后，使用同一份完整 JSON 规格和预览返回的完全一致令牌：
<JSON specification> | python <absolute-SKILL-directory>/scripts/scaffold_bundle.py apply --spec - --confirm <preview-token>
python <absolute-SKILL-directory>/scripts/scaffold_bundle.py validate --path <created-bundle>
令牌缺失、过期、规格或目标目录改变时，重新预览。确定性脚手架不可用时，报告该限制； 绝不能手写包文件作为替代方案。验证失败时不要安装。
test_cases 可声明每个案例的 prompt、required_contains 和 forbidden_contains。
如果没有声明，脚手架仍会生成一个明确标注的 smoke-test，但它没有断言，质量评分会提示
需要补充有效案例。每个生成包还会带 tests/README.md 和 tests/cases/*.json。
质量评分与安全审查
包创建并通过 validate 后，先生成静态质量和安全报告：
python <absolute-SKILL-directory>/scripts/scaffold_bundle.py review --path <created-bundle>
review 只读取已验证包，不执行 Skill、script、hook、model 或 network。它检查推荐的
When to use、Procedure、Output、Safety 章节，测试案例完整性，以及 secret-like
值、指令覆盖、shell、网络和破坏性操作模式。报告中的 quality_score 是可复现的静态
评分，不是模型运行效果证明；报告会明确包含 executed: false 和
network_accessed: false；高风险安全发现会阻断报告。
如果用户或宿主已经在独立授权下收集了响应，把响应保存为 JSON 后再评分：
{"responses": {"case-name": "response text"}}
python <absolute-SKILL-directory>/scripts/scaffold_bundle.py evaluate \
--path <created-bundle> --responses responses.json
evaluate 只对提供的文本做 required/forbidden 断言，不运行模型、宿主或生成 Skill。
仅渲染安装计划
离线验证成功后，询问用户选择一个宿主。Codex、Claude 和 OpenClaw 仅渲染本地包计划：
python <absolute-SKILL-directory>/scripts/scaffold_bundle.py install --host <codex|claude|openclaw> --path <created-bundle>
Hermes 必须声明明确的 <owner>/<repository> Git source；下面命令也只渲染计划，远端内容可变且在实际执行时需要网络。
如需把随后 Hermes 安装固定到已复核的精确内容身份，再提供可选 --source-ref <40-char-sha>：
python <absolute-SKILL-directory>/scripts/scaffold_bundle.py install --host hermes --path <created-bundle> --source <owner>/<repository> --source-ref <40-char-sha>
说明渲染出的命令和网络边界，参考 host-installation。
不得执行安装、启用、检查或重启。只有用户随后单独请求在选定宿主执行该计划，并提供
与该渲染计划匹配的确认令牌时，才可以请求带 --execute --confirm <install-token> 的执行。