技能：定义愿景

目的

定义并记录愿景：项目旨在创造的长期未来。愿景声明回答「我们正在建设什么样的未来？」并与使命保持一致。不定义指标、目标或里程碑。

愿景不同于：

使命：项目存在的根本目的（使用 define-mission）。
北极星：表示交付价值的单个指标（使用 define-north-star）。
战略目标：实现愿景的 3–5 个结果（使用 design-strategic-goals）。
里程碑：执行的阶段检查点（使用 define-roadmap）。

核心目标

首要目标：生成与使命一致的、经用户确认的愿景声明，并持久化到项目商定的路径。

成功标准（必须满足所有要求）：

✅ 存在愿景陈述：一到三句话仅描述期望的未来状态（没有指标、OKR、路线图）。
✅ 与使命一致：愿景与使命不矛盾；若缺少使命，建议先运行 define-mission 或说明假定目的。
✅ 用户确认：用户明确批准（如「已批准」「看起来不错」「继续」或同等内容）。
✅ 文档持久化：写入商定的路径（默认 docs/project-overview/vision.md 或项目规范）。
✅ 尊重范围：声明未定义北极星指标、战略目标或里程碑。
✅ YAGNI/DRY/简洁：遵循 spec §4 文档制品原则；愿景陈述即核心，避免不必要的可选段落（如与使命对齐、时间范围的显式说明）。

验收测试：读者能否理解该项目试图创造什么样的长期未来，并看到其与使命一致？

交接点：愿景批准并持久化后，交接至 define-north-star 或 design-strategic-goals；若仅请求愿景则停止。

范围边界

本技能必须做什么

阐明项目或产品期望的长期未来状态。
制作愿景声明（1–3 句话）。
确保与使命一致（从 define-mission 输出或现有文档读取使命）。
持久化到项目约定的路径（默认 docs/project-overview/vision.md）。

本技能不能做什么

定义根本目的（使用 define-mission）。
定义北极星指标或战略目标（使用 define-north-star、design-strategic-goals）。
定义里程碑（使用 define-roadmap）。
书写路线图、需求或待办（使用 analyze-requirements、capture-work-items 等）。

愿景质量指南

强有力的愿景声明应具备：

简洁：1–3 句话；聚焦未来状态。
与使命一致：支持使命中的根本目的；不引入新目的。
可想象：2–5 年后的成功画面；读者可勾勒具体景象。
无指标：不包含 KPI、OKR 或数字目标；指标由 define-north-star 或 design-strategic-goals 负责。

愿景中应避免：

实施细节：技术、可交付成果或「如何」做到。
流行语：模糊术语，无法阐明未来状态。

使用场景

使命完成后：明确「我们为何存在」后，建立「我们构建的未来」。
战略或方向重置：根据长期目标重新对齐团队。
路线图缺乏目标时：创建清晰的愿景，使路线图与目标一致。
战略链第二层：构建完整层次结构时，在 define-mission 之后运行。

行为

第 0 阶段：Norms Resolution（v1.3 新增）

按 specs/artifact-contract.md §8 Runtime Norms Resolution Protocol 的 §8.2 / §8.3 / §8.5 实现：读项目规范若声明了 vision artifact_type 的 path_pattern，则使用项目值；否则 fall through 到技能默认（docs/project-overview/vision.md）。本技能为固定路径治理产出，只用 path_pattern 覆盖机制。

交互策略

默认：项目规范的输出路径（docs/ARTIFACT_NORMS.md 或 .ai-cortex/artifact-norms.yaml）；否则为 docs/project-overview/vision.md。从 docs/project-overview/mission.md 或用户处推断使命。
选择选项：若存在多个可能的未来，提供 1–3 个候选陈述并要求用户选择或完善。
确认：覆盖现有愿景文件前；最终持久化前。若缺少使命，确认是否假定目的或建议先运行 define-mission。

执行过程

加载使命：从 docs/project-overview/mission.md 或用户提供的摘要中读取使命。
引出：2–5 年后「成功」会是什么样子？我们正在为用户创造什么样的世界？
草案：愿景陈述（1–3 句）；仅未来状态，无指标或 KPI。
检查一致性：确保愿景支持使命；必要时与用户一起完善。
持久化：写入项目约定的路径；若缺少，创建 docs/project-overview/。

输入与输出

输入：

必填：使命（使命文档的声明或路径）；项目/产品背景。
可选：现有愿景草案、时间范围、受众。

输出：

Artifact：愿景陈述（1–3 句话）。
位置：docs/project-overview/vision.md（或按项目规范）。
内容：愿景声明；可选（YAGNI：仅当确有需要时）「与使命一致」「时间范围」说明。
生命周期：living（战略方向改变时更新）。

限制

硬边界（Hard Boundaries）

请勿在愿景声明中包含北极星指标、战略目标、OKR 或里程碑。
未经用户明确确认，请勿覆盖现有愿景文件。
请勿生产超过一份愿景文档；该技能仅生成愿景制品。
YAGNI：愿景文档以陈述为核心；不添加不必要的可选段落。

Skill Boundaries（避免重叠）

不要做这些（其他技能负责）：

使命：根本目的 → Use define-mission
北极星指标：单关键指标 → Use define-north-star
战略目标：3–5 个结果 → Use design-strategic-goals
里程碑：阶段检查点 → Use define-roadmap
路线图、需求或待办 → Use analyze-requirements、capture-work-items 等

何时停止并交接：

用户说「已批准」或同等内容 → 愿景完成，hand off to define-north-star 或 design-strategic-goals
用户请求「一个指标」或「北极星」 → Hand off to define-north-star
用户询问目标或里程碑 → Hand off to design-strategic-goals 或 define-roadmap

自检

核心成功标准（必须满足所有标准）

存在愿景陈述：一到三句话，仅未来状态（无指标、目标、里程碑）。
与使命一致：与使命不矛盾；或已注明使命缺失并由用户确认。
用户确认：用户说「已批准」「看起来不错」「继续」或类似内容。
文档持久化：写入约定路径（默认 docs/project-overview/vision.md 或项目规范）。
尊重范围：声明中没有北极星、目标或里程碑。
YAGNI/DRY/简洁：遵循 spec §4 文档制品原则。

流程质量检查

使用使命：起草愿景前是否阅读或请求了使命？
仅未来状态：是否避免混合指标或 OKR？
质量指南：是否应用了愿景质量指南（简洁、与使命一致、可想象、无流行语）？
文档制品原则：是否遵循 YAGNI、DRY、简洁（spec §4）？

验收测试

读者能否理解该项目试图创造什么样的长期未来，并看到其支持使命？

如果否：愿景不完整或错位。根据使命进行细化和重新检查。如果是：愿景完成。继续交接或停止。

示例

示例 1：使命已存在时定义愿景

背景：使命为「我们的存在是为工程团队提供单一、可靠的方式将服务从代码部署到生产。」用户要求定义愿景。

流程：引出 2–5 年目标，如「每个团队仅需一键，即可在 5 分钟内交付生产，并具备全面审核与回滚。」起草愿景；检查是否支持使命。用户确认。写入 docs/project-overview/vision.md。

结果：愿景持久化；交接至 define-north-star（如「每周 5 分钟内成功部署数」）或 design-strategic-goals。

示例 2：使命尚未定义（边界场景）

背景：用户要求「定义我们的愿景」，但不存在使命文档。

流程：询问是否从 README 或上下文中假定目的，或建议先运行 define-mission。若用户同意继续，在愿景文档中注明假定目的；起草愿景并与用户确认。持久化；建议稍后补充使命以完善战略链。

结果：愿景持久化，附可选「假定目的」注释；用户可稍后运行 define-mission 完成链。

附录：输出合约 (Appendix: Output Contract)

本技能产出 Vision Statement：

元素	格式	必填字段	路径模式
文档主体	Markdown	front-matter（artifact_type=vision / lifecycle=living）；章节：愿景陈述 / 时间视野 / 与 mission 的关系 / 反例	docs/project-overview/vision.md
愿景陈述	单段	不超过 3 句；含未来时态、可想象画面、与 mission 一致	「愿景陈述」节
时间视野	标量	horizon_years（建议 3-10）/ rationale	「时间视野」节

define-vision