agent-workbench-pack/
├── AGENTS.md
├── docs/
│   ├── agent-rules.md
│   ├── reliability-policy.md
│   ├── handoff-protocol.md
│   └── reviewer-rubric.md
├── schemas/
│   ├── agent_state.schema.json
│   ├── task_board.schema.json
│   └── scope_contract.schema.json
├── scripts/
│   ├── init_agent.py
│   ├── run_with_feedback.py
│   ├── verify_agent.py
│   └── generate_handoff.py
├── bin/
│   └── install.sh
└── README.md

什么留下，什么去掉

留下：表面Schema（它们是契约）、四个脚本（它们是运行时）、四个文档（它们是规则和评分标准）。

去掉：项目特定任务（任务属于目标仓库的板，不是包中）、供应商SDK调用（包是框架无关的）、入职散文（包存在于团队现有入职旁边，不是内部）。

安装器

一个简短的 bin/install.sh：拒绝在没有 --force 的情况下覆盖现有包安装、将包复制到目标仓库、如果存在 .github/workflows/ 则连接CI、打印下一步。

版本控制

包携带 VERSION 文件。需要迁移的Schema升级和脚本变更提升主版本。仅文档变更提升补丁。目标仓库的 agent_state.json 记录它初始化时对应的包版本。

生产模式

VERSION 是契约，不是营销。 主版本升级需要状态迁移。次版本升级需要检查器重跑。补丁升级仅文档。安装器在每次安装时写入 .workbench-version。
跨工具分发的单一来源。 Nx发布一个 nx ai-setup，从单一配置铺设 AGENTS.md、CLAUDE.md、.cursor/rules/、.github/copilot-instructions.md 和MCP服务器。包应该做同样的事；安装器发出符号链接，使单一真相来源扇出到每个编码Agent。
uninstall.sh 在非平凡状态上拒绝。 卸载包绝不能删除用户的 agent_state.json、task_board.json 或 outputs/。卸载器移除Schema、脚本、文档和 AGENTS.md，如果状态文件有任何未提交变更则拒绝继续。
SkillKit风格分发。 包作为SkillKit技能发布：skillkit install agent-workbench-pack 从单一来源跨32个AI Agent铺设它。

实践

code/main.py将包组装到 outputs/agent-workbench-pack/，用迷你轨道之前课程的Schema和脚本以及你已经写的文档作为种子。

交付

outputs/skill-workbench-pack.md生成项目调整的包：规则锐化到团队历史、范围glob匹配仓库、评分标准维度扩展一个领域特定条目。

练习

决定哪个可选的第五文档值得提升到规范包中。辩护切割。
将安装器重写为带 --dry-run 标志的Python。比较与bash的人体工程学。
添加 bin/uninstall.sh，安全移除包并在状态文件有非平凡历史时拒绝。什么算非平凡？
添加 lint_pack.py，在包从 VERSION 漂移时失败。将它连接到包自己仓库的CI。
编写从手工作台到这个包的迁移手册。最小化停机时间的操作顺序是什么？

关键术语

术语	人们怎么说	实际含义
工作台包	”入门套件”	携带所有七种表面的版本化目录
安装器	”设置脚本”	幂等铺设包的 `bin/install.sh`
包版本	”VERSION”	Schema/脚本变更的主版本升级，仅文档的补丁
Drop-in包	”cp -r即可”	包在第一天无需每仓库自定义即可工作
可分叉模板	”GitHub模板”	GitHub的”Use this template”可以克隆的公共仓库

Agent工作台项目 — 可复用工作台包

Agent工作台项目 — 可复用工作台包

学习目标

问题所在

核心概念

包布局

什么留下，什么去掉

安装器

版本控制

生产模式

实践

交付

练习

关键术语

延伸阅读

知识检测

学习进度

Agent工作台项目 — 可复用工作台包

知识检测

学习进度

学习推荐