#Skills 起步项目

一个由 Skill、资源、一条命令和一条规则组成的静态插件。它证明：有用的宿主内容不需要 MCP 服务器、App 路由、状态所有者或可执行渲染器。

• 在仓库根目录运行： pnpm example:skills
• 包名： @agent-bundle-example/skills-starter
• 公开依赖： agent-bundle（workspace:*）
• Target： portable、codex、cursor
• 凭据： 不需要，两个 eval 套件都是确定性的，只读取签入的夹具
• 源码： examples/skills-starter

#它证明什么

• 约定发现。 agent-bundle.config.ts 声明插件与三个 target。src/ 下的 Skill、命令和规则 都按约定发现。这正是 Skills 中描述的编写模型。
• 一份源码，三种宿主投影。 同一批文档为复合插件根目录中的 portable、Codex 与 Cursor 投影分别降级，skills/ 只输出一份，由所有选中宿主共同读取。Workbench 的 Source 与 Generated 视图 会显示某个宿主究竟是复制还是改写了一份文档。
• 不虚构运行时。 构建产物没有 MCP 可执行文件、App 运行时、Flight worker、状态所有者或 notice kernel。Workbench 直接打开静态叶子，并如实说明不支持的宿主投影，而不是伪造调用。
• 确定性的 eval 证据。 eval 套件通过确定性 harness 针对签入夹具运行，因此某个 Skill 的覆盖是一次 记录下来的运行，而不是一句断言。覆盖被标记为间接，因为确定性 harness 无法观察宿主端的 Skill 激活。

#编写了什么

每个 Skill 都链接自己的 references/ 清单或运行手册，以及一份可复用的 assets/ 交接或规划模板， 因此 Skill 正文保持简短，长篇材料只在需要时才被加载。

dependency-upgrade Skill 区分计划、实施与发布就绪，按受影响的范围选择验证，而不是要求计划任务 运行全部构建或消费者检查。发布就绪仍需当前候选版本的证据，以及规定的回滚和消费者检查；缺少证据 必须明确报告，不能当作成功。

#在 Workbench 中操作

1. Application → Skills 列出 dependency-upgrade、incident-triage 与 release-review。 选中其中一个以渲染其文档，然后用检查器浏览链接的清单与报告模板，或对比 Source 与 Generated 输出。
2. Application → Rules / Commands 直接打开编写内容和每个宿主投影。不支持的宿主显示能力原因， 且没有 Run 操作或插件进程。
3. Advanced → Artifact 显示复合插件根目录和每个文件的 provenance。
4. Advanced → Evals → Runs 默认选中 release-readiness 套件。运行 release-artifact-is-ready 并查看通过的试次； 它只消费签入的证据夹具。
5. 想演练修复，就对发布策略做一处可逆修改，按 Rebuild，并等待 Failed 或 Idle 结果，而不是 Building 状态。失败时从页眉计数打开 Problems，同时 Application 保留上一个可用的树。恢复签入的策略 并重建。此时先前那次 eval 对改动后的构建已经过期，重新运行 release-readiness，记录当前已修复 状态下的证据。

#非交互检查

在仓库级 pnpm build 之后：

cd examples/skills-starter
pnpm validate
pnpm build
pnpm exec agent-bundle eval --case release-artifact-is-ready --trials 1

pnpm check 就是不打开 Workbench 的“校验加构建”这一对。生成的输出落在 artifact/，其根契约是 artifact/agent-bundle.manifest.json。.agent-bundle/ 目录存放开发期状态，不是源码材料。