用途
craft-survey 用于研究可比较的提示词、技能或仓库资产，提取其中最好的模式，并将其转化为可执行的改进。
有依据的调研之所以重要，是因为从零开始凭空发明的智能体，往往会重新发现社区早已淘汰的不良形态。一次聚焦的先行研究能够浮现出少数真正经得起检验的模式，同时——同样重要的是——识别出那些不应被复制的模式。
适用场景
- 存在值得学习的旧资产
- 新技能应建立在经过验证的模式之上
- 当前产物感觉信息不足
- 应纳入最佳实践，但不做盲目照搬（cargo-culting）
- 用户询问“别人是怎么做的？”，或希望在投入前做一次文献综述式调研
输入
- 目标产物或问题
- 本地参考资料（如有）
- 可选的公开参考资料（如允许）
- 约束条件与目标受众
步骤
- 先从本地或仓库内参考入手。它们最贴近当前上下文，验证成本也最低。
- 识别可比较的资产，并按用途分组。分组能让反复出现的形态变得可见。
- 提取看起来真正有用的重复模式。优先选择在多个来源中都出现的模式。
- 将核心模式与可选的风格选择区分开。混淆二者正是盲目照搬的开端。
- 综合出一小组推荐改动。综合优于引用——不要只是从来源中粘贴。
- 只推荐能提升清晰度、复用性或质量的改动。仅凭新颖性不足以成为采纳某个模式的理由。
输出格式
调研目标 用一两句话说明正在改进的具体产物，以及驱动本次调研的具体调研问题。只看这一部分的读者应当知道什么才算是有用的答案——而不是泛泛的“强化产物”。
参考模式 在可比较资产中发现的模式简短列表。每个模式都必须标注其来源——可以是逐项内联标注，也可以通过章节开头的来源映射，将每个模式绑定到其来源文件与章节。没有可追溯来源的模式不应出现在列表中。
采纳 值得引入 CraftKit 的模式。每一项包含两部分：模式（简短标识）以及说明具体收益的理由从句——它防止了什么失败、消除了什么摩擦、提升了什么质量。仅有短语不满足本节要求；那只是示范而没有依据。
避免 不应被复制的模式。每一项包含两部分：模式以及说明具体危害的理由从句——它破坏了什么、引入了什么耦合、牺牲了什么可移植性。仅有短语不满足本节要求。
推荐编辑 具体的文件或章节改动。每一项必须说明三件事：(a) 目标文件（路径或技能名），(b) 该文件中的具体章节/标题/位置，(c) 编辑动词（add / tighten / remove / replace / refactor）。编辑数量应与研究请求的范围相匹配——一个狭窄的问题值得 1–3 处编辑，而不是一份完整的重写清单。
风险 仅限本次调研特有的风险。至少有一项风险必须引用实际调研的来源集合，或目标产物的某个具名约束。那些在任何先行研究中都能逐字出现的通用风险不算数——如果该风险可以原样移植到不相关的调研中，那它就没有真正参与本次调研。
护栏
- 优先进行第一性原理的综合，而非复制粘贴
- 不要将特定提供方的怪癖引入核心资产
- 在相关时于文档中标注来源
- 使用少数几个强有力的模式，而不是一份冗长的清单
失败模式
- 把一个强有力的参考当作模板，并过度拟合其怪癖
- 把输出变成文献综述，而不是可执行的编辑
- 引入特定提供方的措辞，破坏可移植性
- 跳过“避免”清单，不加批判地复制每一个模式
示例
输入 使用较旧的 prompt-builder 资产和 meta-skills 作为参考，改进一个 tuning 技能。
输出
调研目标 强化 tuning 技能，使其产生更一致、更可移植的编辑。
参考模式
- 显式输入与输出 — 来源：skills/craft-autoresearch/SKILL.md § Inputs / Final artifact
- 最小差异编辑 — 来源：skills/craft-prompt/references/shared-principles.md（cut order, right-sized）
- 先批评后修订 — 来源：skills/craft-critique/SKILL.md § Steps
- 文档中嵌入示例 — 来源：skills/craft-prompt/references/prompt-patterns.md § Review prompts
采纳
- 修订产物加变更日志结构 — 防止用户收到无法审计的编辑
- 失败模式说明 — 暴露调优后的提示词仍会漂移的条件
- 保留原始意图 — 防止清理过程悄悄改变提示词的职责
避免
- 过度特定于厂商的措辞 — 会使技能耦合到单一运行时，削弱跨智能体复用
- 巨型一体化指令 — 使始终加载的 SKILL.md 更难检查和维护
推荐编辑
- tuning 技能的 § Final output — 收紧变更日志字段，使每条记录都说明 changed / why / effect
- tuning 技能的 § Failure modes — 添加一条关于重复编辑期间范围漂移的简短说明
- tuning 技能的 § Example — 用一个紧凑的完整循环运行替换通用示例
风险
- 所调研的来源都与 CraftKit 相邻，因此建议可能过度拟合本仓库的命名约定