skill-studio 元技能的唯一工作目录（source of truth）。
- 源码在此编辑：
skill-studio/（SKILL.md + references/ + scripts/） - 文档在此维护：
docs/（需求/设计/测试/使用/成果物/跨 Agent） - 打包产物在此产出：
dist/skill-studio.zip
当前版本：v1.0.0 — 2026-08-31
- 质量门全过：
validate.pyALL PASS /audit.py0 ERROR / dogfood 通过 / 跨 Agent--target安装成功。 - 本次发布范围：源码（skill-studio/）+ 文档（docs/7 份）+ 打包产物（dist/）+ dogfood 示例，均已脱敏（无 O6/claw 等内部 skill 名）。
- 1.0.0 关键变更：
--target安装设计重构——由"9 宿主硬编码目录"改为"规范标准位置（agents/claude/workbuddy/coze…）+ agent 别名（codex/copilot/…→agents）"，默认装共享位~/.agents/skills/即覆盖大多数合规 agent。详见docs/07§3 与docs/04§6。 - 已知边界（非阻塞）：Gemini CLI 实验性需手动开启；豆包/Coze 上架需
.skill云端打包；反触发率测试集未测。
详见 CHANGELOG.md。
skill-studio-workshop/
├── README.md # 本文件
├── skill-studio/ # ★ skill 源码（唯一编辑地 / source of truth）
│ ├── SKILL.md # 元技能入口（≤500行，自举通过）
│ ├── references/ # 渐进式披露：SOP + 5 模式 + 哲学 + 反模式
│ │ ├── sop.md # 完整 SOP（唯一权威，22KB）
│ │ ├── architecture.md # 哲学层（Skill本质/Tool辨析/三要素）
│ │ ├── pattern-tool-wrapper.md # 知识封装
│ │ ├── pattern-generator.md # 生成器（6步输出契约）
│ │ ├── pattern-reviewer.md # 审查员（证据4要素）
│ │ ├── pattern-inversion.md # 反转访谈
│ │ ├── pattern-pipeline.md # 流水线（8要素+门槛）
│ │ └── anti-patterns.md # 反模式 11 项 + 已知误报说明
│ └── scripts/ # 5 个 Python 脚本（纯标准库，零依赖）
│ ├── init_skill.py # 骨架生成（按 pattern 选建目录）
│ ├── diagnose.py # 模式决策树（5类不确定性→5模式）
│ ├── validate.py # 硬钳校验（7项，FAIL 拒出包）
│ ├── audit.py # 病灶诊断（11+项，只报告不拒）
│ └── package_skill.py # 打包 + 跨 Agent --target 导出
├── docs/ # 完整文档体系
│ ├── 01-requirements.md # 需求文档
│ ├── 02-design.md # 设计文档（含三层防跑偏钳制）
│ ├── 03-test-report.md # 测试文档（自举+闭环+dogfood）
│ ├── 04-usage-guide.md # 使用指南
│ ├── 05-deliverables.md # 成果物清单
│ ├── 06-dogfood-report.md # dogfood 报告（P0 验证）
│ └── 07-cross-agent-compatibility.md # 跨 Agent 通用性（三层边界+9宿主特征）
├── dist/ # 打包产物
│ └── skill-studio.zip # 从本目录 skill-studio/ 构建
├── dogfood/ # dogfood 产物（用 skill-studio 造的真实 skill）
│ └── scenario-narrative-ad/ # 场景叙事广告脚本生成器（Generator 模式）
└── test-init2/ # 早期 dogfood 测试产物（合规示例 skill，历史留存）
# 1) 编辑源码：直接改 skill-studio/SKILL.md、references/、scripts/
# 2) 自校验（硬钳，退出码 1 即失败）
python skill-studio/scripts/validate.py skill-studio
# 3) 打包 + 跨 Agent 导出（先自动跑 validate，FAIL 拒出包）
python skill-studio/scripts/package_skill.py skill-studio dist [--target all]
# 4) 部署到本机 （让 skill 真正生效）
cp -r skill-studio/* ~/.agent/skills/skill-studio/铁律：编辑只在
skill-studio/做；~/.agent/skills/skill-studio/由第 4 步同步，不要直接在那边改，否则下次 deploy 会覆盖。
| 项 | 位置 | 状态 |
|---|---|---|
| SOP 主文档（唯一权威） | skill-studio/references/sop.md |
✅ 已落地（随 skill 自动加载） |
| 元技能入口 SKILL.md | skill-studio/SKILL.md |
✅ 已落地（自举通过） |
| validate.py 硬钳 | skill-studio/scripts/validate.py |
✅ 已写 + 自举通过 + 占位符检测 |
| diagnose.py 决策树 | skill-studio/scripts/diagnose.py |
✅ 已写 + 三场景测试通过 |
| init_skill.py | skill-studio/scripts/init_skill.py |
✅ 已完成（按 pattern 选建目录） |
| package_skill.py | skill-studio/scripts/package_skill.py |
✅ 已完成（--target 跨 Agent 导出） |
| 5 份 pattern-*.md + architecture.md + anti-patterns.md | skill-studio/references/ |
✅ 已落地 |
| audit.py 病灶诊断 | skill-studio/scripts/audit.py |
✅ 已完成（自举 ERROR=0） |
| 文档体系 | docs/ |
✅ 已落地（7 份） |
| 改名 skill-creator→skill-studio | 全链 35 处替换 | ✅ 已完成 |
| dogfood（P0） | dogfood/scenario-narrative-ad/ |
✅ 已完成 |
| 跨 Agent 无缝导出 | --target（6 标准位置 + agent 别名） |
✅ 已完成（重构） |
| 跨 Agent 兼容性设计文档 | docs/07-cross-agent-compatibility.md |
✅ 已完成 |
| 单工作目录整合 | 源码+文档+打包产物统一到本目录 | ✅ 已完成（2026-08-31） |
详见 docs/02-design.md 第 3 节。要点：
| 层 | 钳 | 强制力来源 |
|---|---|---|
| 钳 1 | diagnose.py 决策树 | 5类不确定性→5模式映射 |
| 钳 2 | validate.py 硬钳 | 退出码 1 拒出包 |
| 钳 3 | package_skill.py 闭环 | 先调 validate，FAIL 即拒 |
| 软约束 | SOP 11 项设计 / 4 道熔断 / dogfood | 人工对照，脚本管不到 |
关键：强制力靠脚本不靠词汇（铁律第 2 条）。marketplace 版用 "MUST reject" 措辞靠不住；skill-studio 用 validate.py 真跑校验。
- 自举：skill-studio 自己必须符合它教别人的规范。validate.py 已通过自身校验，audit.py 自举发现 5 病灶已修复至 ERROR=0。
- 强制力靠脚本：格式/命名/长度校验走
validate.py，不靠 prompt 词汇。 - 详节挪 references/：SKILL.md 只做索引+编排；哲学层挪 architecture.md。
- 真实素材优先：反例用自己踩过的坑，不编造。但具体本地 skill 实测数据不写入可分发 SOP（安全考量），由
audit.py跑出当前值。 - 安全边界：本地路径、具体 skill 名字、KB 大小不写入
references/sop.md（防泄露本地资产结构）。O6 实测对照表已从可分发文档移除。
用户级原 skill-creator 与 marketplace 版同名撞车（触发关键词重叠）。决策改名 skill-studio：
- 工作室感，含设计+校验+打包全流程
- 与 marketplace 的 creator 形成互补（studio > creator）
- marketplace 版真名
skill-creator在文档中作为对照保留
marketplace 版解决"怎么打包"——init/package 脚本。
本目录产出的用户级 skill-studio 解决"怎么设计"——诊断访谈、模式选择、反巨型 prompt 诊断、硬钳校验、病灶诊断。
两者合并：marketplace 版的 init/package 脚本迁移到 skill-studio/scripts/，加上 validate/diagnose/audit 形成"先设计后打包"完整闭环。