unknowns-discovery

未知项发现

当 Agent 应在制定计划、实施、审查或合并之前，发现用户、规范、提示词或代码库中缺少的信息时，使用此技能。

提示词、技能、工单、截图和上下文窗口是地图。真实的代码库、产品、用户、数据、约束、历史和审查者预期是疆域。两者之间的差距就是任务的未知项。

未知项类型

类型	含义	Agent 的做法
已知的已知项	提示词中明确的事实和约束	保留并简要重述
已知的未知项	已意识到尚未解决的问题	提问、研究、参数化或设置门槛
未知的已知项	用户只有看到结果后才会意识到的隐性标准	制作原型、模拟、比较或访谈
未知的未知项	无人提及的隐藏约束、缺失术语、先例、陷阱或质量上限	进行盲点排查、检查参考资料、搜索代码和历史，并指出潜在问题

何时启用

符合以下任一条件时，启用此技能：

• 工作包含多个步骤、存在歧义、不熟悉、风险较高，或可能需要判断。
• 用户提到“盲点排查”“未知的未知项”“我遗漏了什么”“采访我”“先做原型”“实施说明”“争取认同的文档”“考考我”或类似表达。
• 用户缺乏领域术语，或不知道什么才算好。
• 任务涉及代码库历史、架构、数据模型、权限、迁移、UX、视觉设计、产品范围、发布或审查者批准。
• Agent 即将开始长期实施，或已发现计划与代码库不一致。

对于探索只会增加阻力的小型确定性任务，不要启用，例如修复拼写错误、重命名变量，或回答没有实质性未知项的直接问题。

核心循环

1. 说明地图。 重述任务、约束，以及用户表示自己已知的内容。
2. 检查疆域。 阅读相关文件、文档、示例、数据、截图、参考资料、过往工作或用户提供的上下文。
3. 建立未知项矩阵。 区分已知的已知项、已知的未知项、未知的已知项和未知的未知项。
4. 选择成本最低且有用的产物。 选择最能尽早暴露影响范围最大的未知项的方式。
5. 设置实施门槛。 只有在危险的未知项已解决、明确接受，或隔离在可逆决策之后时，才继续。
6. 延续发现成果。 将发现纳入更完善的提示词、计划、实施说明、争取认同的文档、测验、测试或审查产物中。

Artifact 模式选择器

模式	适用场景	输出
blindspot-pass	不熟悉代码库、领域或设计区域；可能存在未知的未知项	盲点卡片 + 更完善的实现提示词
teach-me-my-unknowns	用户缺乏相关词汇或质量标准	心智模型 + 词汇阶梯 + 改进后的提示词
brainstorm-prototype	用户看到后才能判断是否合适	发散式原型/选项 + 反馈模板
mock-before-wire	需要在修改后端、状态或应用之前先查看 UI/流程	使用假数据的临时模拟 + 接线计划
option-space-brainstorm	问题的界定可能过窄或过宽	按成本从低到高排序的干预方案
one-question-interview	探索后仍有歧义	一次问一个问题，并按影响范围排序
reference-semantics-map	现有代码、设计或文档是最佳描述	移植/改编前先制作语义映射
tweakable-plan	已准备好实施，但人类应审核容易变动的部分	按可能需要人工调整的程度排序计划，然后再按执行顺序排列
implementation-notes	实施正在进行，且出现意外情况	持续记录偏差和保守选择
buy-in-doc	工作需要审批或利益相关方达成一致	以演示为先的提案/说明，包含异议和签核
merge-readiness-quiz	合并/发布前，人类必须理解一项复杂变更	报告 + 测验，并设定通过标准

详细流程见 references/WORKFLOWS.md。可复制的提示词卡片见 references/PROMPT_PATTERNS.md。输出架构见 references/OUTPUT_SCHEMAS.md。

默认输出约定

每份未知项产物都应包含：

1. 范围解读： 检查了什么或做了哪些假设。
2. 发现的未知项： 按未知项类型和严重程度标注。
3. 影响范围： 若对此未知项作出不同回答，会有哪些变化。
4. 保守默认方案： 若必须继续，Agent 将采取什么做法。
5. 待定决策： 用户需要作出哪些选择（如有）。
6. 提示词升级： 纳入发现内容后修订的提示词/指令。
7. 停止条件： 不可猜测的情况。

自主性规则

• 当未知项可能影响架构、数据模型、身份验证、隐私、合规、成本、公共 API、迁移、发布或面向用户的行为时，先询问再采取行动。
• 当未知项风险低、可逆，且用户要求不要打断时，采取保守做法继续。将假设标记为 ASSUMED。
• 当反馈取决于审美、布局、文案语气、交互流程、信息架构或数据密度时，先做原型，再接线。
• 如果行为已在其他位置存在，优先引用源内容，而非用文字描述。
• 实施期间，继续之前先记录所有实质性偏差。
• 不要仅凭快速浏览差异就合并复杂的 Agent 工作；如果理解很重要，应创建报告和测验。

出现以下情况时立即停止

• 当前方向与任务目标相矛盾。
• 未知项可能导致数据丢失、身份验证绕过、隐私泄露、计费影响、破坏性迁移、公共 API 中断或合规失败。
• 发现先前失败/回滚的尝试，且其原因仍然适用。
• 用户要求精确的法律/安全/合规行为，但缺少权威来源。

最简示例

Do a blindspot pass before implementation. Find unknown unknowns, explain why each matters, and rewrite my prompt with the discoveries folded in.

Before touching the app, make a single HTML mock with fake data so I can react to layout and product decisions.

Keep implementation-notes.md as you build. If code forces a plan deviation, choose the conservative option, log it under Deviations, and continue unless it affects security/data/migrations/API/compliance.

Give me a merge-readiness report with a quiz at the bottom. I should not merge until I pass it perfectly.

打包资源

• references/ARTICLE_DIGEST.md — 对所提供文章的忠实提取摘要。
• references/WORKFLOWS.md — 各类产物模式的详细流程。
• references/PROMPT_PATTERNS.md — 可复用的提示词卡片。
• references/OUTPUT_SCHEMAS.md — 产物架构和关卡。
• references/EVALUATION.md — 评估提示词和质量标准。
• references/SOURCE_INDEX.md — 来源和格式参考。
• assets/templates/ — 可复用的 Markdown 模板。
• examples/ — 涵盖编码、产品/设计和研究的应用示例。
• scripts/ — 用于生成和验证模板的可选辅助脚本。