| name | 01-intent-understanding |
| description | Internal manual-only stage that normalizes a host SDK request into a V2 cognition intent. |
V2 意图与功能树
仅供入口 Skill 内部读取。提取用户目标、交付模式、已有条件、硬约束和逐条验收标准。先形成目标树,再把每个可独立验收的目标拆成原子功能节点,显式记录父子关系、数据依赖、所需输入、可观察输出和验收条件;每条必需验收要求都必须显式映射到一个或多个功能节点。每个节点还要标记 implementation_source:需要 SDK 公共能力的是 sdk_cognition;去抖、状态机、请求身份、布局和宿主生命周期等通用工程职责是 host_design。不得用宿主设计节点绕过任何 SDK 调用,也不得强迫纯宿主逻辑去匹配 SDK 节点。不得按 SDK 名、接口名或当前代码中的偶然调用反向拆树,也不得把同一 SDK 的多个功能合并为一个宽泛节点。
调用 runtime/interactive-cognition-planner.mjs 的 normalizeFunctionTree,输出 application.function-tree/v2,并用 protocol/schemas/function-tree-v2.schema.json 校验。接口名只能作为用户明确给出的约束保留,不能提前变成选择结果。只有会改变目标或验收结论的缺失信息才向入口返回阻塞问题。