用途
duck-adapt 是一个元技能（meta-skill），它操作的对象是技能定义本身，而不是直接的代码库。它的主要目标是把外部技能或工作流转化为以 rubber-duck 理念为基础的版本，在保留原有意图的同时加入一整套纪律约束，包括苏格拉底式提问流程、证据优先、Duck Ladder 最小改动思维、执行审批门以及提示词顺序标准合规。
主要能力
- 外部技能适配：将外部技能、工作流文档或概念描述转化为 duck-* 技能草稿。
- 技能合规审计：检查已有技能是否符合理念护栏、提示词顺序标准、执行审批门、资产约定与 Duck Ladder 纪律。
- 重叠检测：比较技能意图、范围与工作流模式，区分语义重叠与互补组合，给出新增、扩展、拒绝或组合模式的建议。
- 理念映射：加载理念资产（philosophy-core、socratic-patterns、approval-gate-spec、adaptation-checklist），应用决策归属、证据优先、Duck Ladder、执行审批、苏格拉底流程等转换。
- 结构转换：按提示词顺序标准组织技能章节（Purpose、Philosophy Guardrails、Activation、Method、Boundaries），识别 assets 与 references 候选，生成 frontmatter。
- 输出生成：输出完整目录结构（SKILL.md、assets、references、evals 骨架）以及适配、审计或重叠分析报告。
使用方式
用户提供要适配的外部技能、要转换的工作流描述，或要求审计某个已有技能、判断是否重叠时激活。方法分六步：接入与分类（最多提 3 个澄清问题）、证据收集、理念映射、结构转换、重叠分析、输出生成。输出形式视场景而定：技能适配输出目录结构与适配报告（含重叠分析、理念转换清单、SKILL.md 内容、资产、下一步）；技能审计输出合规检查、按优先级排列的发现与审计建议；重叠检测输出现有覆盖、差距分析与推荐。
适用场景
- 用户提供外部技能需要适配。
- 用户描述某个工作流、流程希望转成技能。
- 用户要求审计已有技能是否符合理念。
- 用户询问“是否应该新增这个技能”或“是否重叠”。
限制
不生成会削弱安全边界（信任边界、安全、数据保护、可访问性）的技能；不适配会在无明确审批门的情况下自动化剥夺用户决策权的技能；若外部技能理念与 duck 原则不可调和地冲突，建议拒绝并给出理由。重叠分析仅为建议，最终是否新增由用户决定；生成的技能只是草稿，需用户审阅后再提交；不自动执行 make build-skills，由用户在批准后运行。
交接
用户批准新技能后，提示运行 make build-skills 生成产物；审计发现问题后，小修建议 duck-patch，重构建议 duck-refactor；重叠度高时建议使用现有技能并明确工作流。