caomeiyouren Skill Creator
铁律：不要再维护第二套技能创建规范。skill-creator 就是唯一的技能设计、重构、评测与打包入口。
工作流
- Step 1: 明确技能目标 ⚠️ REQUIRED
- 1.1 提炼用户真正要沉淀的能力边界、触发语句和输出类型。
- 1.2 至少收集 3 个真实使用场景，优先从当前对话、历史技能或 git diff 中提取。
- 1.3 如果需求本质上是在创建角色、上下文隔离流程或治理型编排者，转交 agent-creator，而不是继续创建 skill。
- Step 2: 审计现状与文本资产 ⚠️ REQUIRED
- 2.1 如果是改造现有技能，先比对 git diff 或提交历史，找出被删掉但仍有价值的规则、示例、术语和资源引用。
- 2.2 决定哪些内容保留在主 SKILL.md，哪些拆进 references/，哪些下沉到 scripts/。
- Step 3: 设计技能架构 ⚠️ REQUIRED
- 3.1 先决定 description、铁律、工作流、确认门、反模式和交付前检查。
- 3.2 再决定是否需要参数系统、eval、benchmark 和 viewer。
- Step 4: 编写触发面
- 4.1 先写 description，覆盖真实触发语句和近义表达。
- 4.2 所有 when-to-use 信息都放在 description，不放在正文。
- Step 5: 编写 SKILL.md 主体 ⚠️ REQUIRED
- 5.1 保持正文精炼，只保留骨架与关键约束。
- 5.2 长清单、案例、技巧说明和 schema 拆到 references/。
- Step 6: 构建资源
- 6.1 确定性、可复用操作写入 scripts/。
- 6.2 设计方法、长清单和格式定义写入 references/。
- 6.3 模板或评审页面等输出资源写入 assets/ 或 eval-viewer/。
- Step 7: 选择评测模式 (conditional)
- 7.1 简单改动可只做人工 review。
- 7.2 复杂技能用 references/schemas.md、scripts/run_eval.mjs、scripts/aggregate_benchmark.mjs、scripts/run_loop.mjs 和 eval-viewer/generate_review.mjs 做评测与触发优化。
- Step 8: 打包与收口 ⚠️ REQUIRED
- 8.1 使用 scripts/quick_validate.mjs 做快速结构检查。
- 8.2 需要新建技能时，使用 scripts/init_skill.mjs 初始化骨架。
- 8.3 需要交付时，使用 scripts/package_skill.mjs 打包。
- 8.4 总结保留、迁移、删除和兼容策略。
本目录资源
- references/skill-design-overview.md：快速理解技能设计的 12 个核心技巧。
- references/description-guide.md：写 description 前加载。
- references/workflow-patterns.md：设计工作流、确认门和交付检查时加载。
- references/writing-techniques.md：写铁律、问题式指令和反模式时加载。
- references/output-patterns.md：设计输出模板与交付清单时加载。
- references/parameter-system.md：需要参数系统时加载。
- references/architecture-guide.md：规划 references/、scripts/、assets/ 分层时加载。
- references/schemas.md：编写 evals、grading 和 benchmark 数据时加载。
- scripts/init_skill.mjs：初始化技能骨架。
- scripts/quick_validate.mjs：快速校验 frontmatter 与目录结构。
- scripts/package_skill.mjs：打包技能。
- scripts/run_eval.mjs、scripts/aggregate_benchmark.mjs、scripts/run_loop.mjs：评测、聚合和触发优化。
- agents/analyzer.md、agents/grader.md、agents/comparator.md：做 benchmark 分析、断言评分和盲测时加载。
正文与 references 的拆分原则
- 放在 SKILL.md：铁律、工作流主干、确认门、反模式、交付前检查。
- 放在 references/：长清单、案例、设计理论、schema、评测说明。
- 放在 scripts/：确定性、重复性高且值得节省 token 的操作。
设计原则
- 不要让正文变成第二份 README。
- 不要为了追求完整度把所有内容塞回 SKILL.md。
- 不要只做骨架改写而丢掉原技能里的项目特化规则。
- 不要把 benchmark 当成所有技能的必选项。
- 当需求本质是 agent 时，不要硬塞进 skill-creator 处理。
反模式
- 不比对旧版本文本，直接用新模板覆盖一切。
- 同时保留两个 canonical skill，造成职责分叉。
- 只保留抽象流程，不保留有价值的具体规则和术语。
- 只看 benchmark 分数，不看真实输出和用户反馈。
交付前检查
- 已通过 git diff 或历史版本比对回收有价值的旧文本。
- description 已覆盖触发场景和真实语句。
- 正文只保留骨架，长文本已合理拆入 references/。
- 如运行 eval，JSON schema 与目录结构已对齐。
- benchmark 结果已和真实输出一起分析，而不是只看分数。
- 当前目录就是唯一 canonical skill 入口。