Preflight 是一个方法论类技能,核心问题是“如果直接开始编码,我会在哪些地方默默做错”。它不产出独立交付物,输出留在对话上下文中供后续技能使用。
用途:在构建前明确假设与成功标准,适用于基础设施代码、API 端点与服务、后期难以修复的任务,以及质量优先于速度的场景。不适合快速原型、琐碎任务、紧急热修复、已有极详细规格或需求仍在探索的任务(后者应使用 plan-interviewer)。
主要流程:Phase 0 选择范围模式 EXPAND/HOLD/REDUCE,未选默认 HOLD。Phase 1 先花最多 5 分钟检查 .agents/ 下的 spec.md、system-architecture.md、product-context.md、.agents/experience/{domain}.md、.agents/meta/learned-rules.md 及 CLAUDE.md,再生成 5 个按影响排序的澄清问题,每个问题需说明默认假设与重要性,等待回答后才进入下一阶段。Phase 2 生成并校验契约,包含 SCOPE MODE、GOAL、CONSTRAINTS、FORMAT、FAILURE、NOT IN SCOPE、EXISTING 七部分,FAILURE 条款用于防止走捷径。Phase 3 将契约交给实现方,并附验证模板与契约状态格式。
配置项包括 question_count(默认 5,范围 3-7)、contract_template(standard/minimal/detailed)、verify(默认 true)、strict(默认 true)、experience_doc(默认无)。边界情况:用户说“直接做”时跳过 Phase 1,列出假设并继续;上下文已回答全部问题时跳到 Phase 2;契约不完整时用合理默认补全并确认;FAILURE 与 GOAL 冲突时需指出并询问优先级;无法验证的条件标记为 UNVERIFIABLE。重复任务领域可将问答追加到 .agents/experience/{domain}.md,形成经验飞轮。具体安装命令与收费信息暂未提供。