# 01 Intent Understanding

> Internal manual-only stage that normalizes a host SDK request into a V2 cognition intent.

- Skill: `didi/01-intent-understanding` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add didi/01-intent-understanding`
- Raw SKILL.md: https://api.skillmd.com/api/skills/didi/01-intent-understanding/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: didi (https://skillmd.com/u/didi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/didi/01-intent-understanding

---


# 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` 校验。接口名只能作为用户明确给出的约束保留，不能提前变成选择结果。只有会改变目标或验收结论的缺失信息才向入口返回阻塞问题。

