用途:为智能体编程提供一套行为准则,在实施前、实施中和交付后主动识别并处理未知信息,降低因上下文缺失造成的失败。资料称其源自 Thariq Shihipar 关于发现未知信息的实战指南。
主要能力与做法: 一、映射未知。把提示词看作地图,把代码库、产品、用户与约束看作实地,显式列出已知的已知、已知的未知、未知的已知,并主动询问未知的未知(盲点、既有方案、边界情况、隐藏风险或更优结果)。若未知占主导,不立即执行,先探索、访谈、做原型或查看参考资料。 二、编码前发现。用最小产物暴露不确定性:不熟悉领域时请求盲点扫描;无法判断“好”的标准时让智能体讲解领域词汇、质量标准和失败模式;只有看到才能判断时生成多个具体原型;让智能体逐题访谈,优先回答会改变架构、API、数据模型、用户体验或安全边界的问题;用源码、示例、截图、文档或既有实现代替模糊表述;索取可调整的计划,把易变决策前置、机械性工作后置。多步任务需写明发现循环,如“某产物→揭示某未知”“某问题→改变某决策”“某计划→编码前验证某检查项”。 三、实施中跟踪。维护 implementation-notes.md 或 .html 草稿记录。现实迫使偏离时选保守路径,记入 Deviations 并说明证据;新未知使计划失效时停下并暴露决策,不要静默转向;把新发现转化为下一次提示、规格、清单、测试或项目说明。检验标准是后续尝试应比当前尝试有更好的地图。 四、闭环。合并、交接或批准前,把原型、规格、决策、实施记录与证据打包成简明说明;先演示或行为,再回应评审可能提出的异议;变更过大难以仅凭 diff 理解时,索取测验或评审指南;只有当负责人明白改了什么、为何改、还剩哪些风险时才合并。
适用场景:规划模糊任务、进入不熟悉代码库、多步或长时间运行的智能体编程工作。
限制:资料明确说明该准则偏向执行前先澄清,对琐碎任务需自行判断;未提供具体命令、安装方式、收费或平台信息。