| name | design-strategic-goals |
| description | Define 3–5 long-term strategic goals that move the project toward the vision and North Star. Produces a goals document aligned with mission, vision, and NSM; persisted to docs. |
| description_zh | 定义 3–5 个推动项目走向 vision 与 North Star 的长期战略目标；产出 goals 文档。 |
| tags | ["documentation","workflow"] |
| version | 1.2.0 |
| license | MIT |
| recommended_scope | both |
| metadata | {"author":"ai-cortex"} |
| triggers | ["strategic goals","design goals","define goals"] |
| input_schema | {"type":"free-form","description":"Vision; North Star (or paths); project context; optional mission; existing goals or priorities"} |
| output_schema | {"type":"document-artifact","description":"Strategic goals document with 3–5 goals; written to docs/project-overview/strategic-goals.md (or project norms)","artifact_type":"strategic-goals","path_pattern":"docs/project-overview/strategic-goals.md","lifecycle":"living"} |
#技能 (Skill)：设计战略目标
目的 (Purpose)
定义 3-5 个长期战略目标，推动项目朝着愿景和北极星方向发展。制作一个以结果为中心的目标文档（不是任务列表或路线图）。不定义使命、愿景、北极星或里程碑。
核心目标（Core Objective）
首要目标：生成用户确认的战略目标文档，其中包含 3-5 个与愿景和北极星一致的以结果为中心的目标，并坚持项目商定的路径。
成功标准（必须满足所有要求）：
- ✅ 记录 3-5 个目标：正好 3-5 个战略目标，每个目标都有清晰的标题和简短描述。
- ✅ 以结果为中心：每个目标都描述可判断达成与否的结果，而不是任务列表、功能列表或支柱方向的重述。
- ✅ 与愿景保持一致：每个目标都支持愿景；对齐是明确的或明显的。
- ✅ 北极星联系：至少一个目标明确支持或移动北极星指标；可选：每个目标简要说明“这如何支持愿景/NSM”。
- ✅ 用户确认：用户明确批准（例如“已批准”、“看起来不错”、“继续”或同等内容）。
- ✅ 文档持久化：写入商定的路径（默认
docs/project-overview/strategic-goals.md 或每个项目规范）。
- ✅ 包含工程健康目标：长期项目（计划期 > 6 个月）必须包含一个"工程 / 治理健康可持续"类目标；短期 / 实验性项目可显式豁免并在文档中说明理由。依据：ADR 20260417-unified-value-driven-prioritization-model 决策 3.5。
验收测试：读者能否看到 3-5 个目标中的每一个如何推进愿景和北极星，而不需要日期或阶段（那些属于里程碑）？长期项目中是否有一个目标为治理 / 工程健康代言？
交接点：当目标被批准并坚持时，交接至“定义里程碑”以将目标分解为阶段检查点，或停止。
范围边界 (Scope Boundaries)
本技能负责：
- 引出并记录 3-5 个长期战略目标。
- 确保与愿景和北极星保持一致（从“define-vision”/“define-north-star”输出或现有文档中读取）。
- 坚持项目商定的路径（默认“docs/project-overview/strategic-goals.md”）。
- 可选：每个目标的说明，说明它如何支持愿景或北极星。
本技能不负责：
- 定义使命、愿景或北极星（使用“定义使命”、“定义愿景”、“定义北极星”）。
- 将目标分解为阶段或日期（使用“定义里程碑”）。
- 撰写需求、路线图或待办（使用“分析需求”、“项目计划”、“捕获工作项目”）。
使用场景（用例）
- 在愿景和北极星之后：设定 3-5 个战略成果，以推进愿景并推动 NSM。
- 年度或季度战略：定义或更新战略优先事项。
- 当待办缺乏目标一致性时：创建明确的目标，以便路线图和待办可以追踪它们。
- 战略链中的第四层：在构建完整的层次结构时遵循使命、愿景和北极星。
行为（行为）
交互（互动）政策
- 默认：项目规范的输出路径（如果存在）；否则为“docs/project-overview/strategic-goals.md”。如果有的话，请从“docs/project-overview/”中阅读愿景和北极星。
- 选择选项：如果用户有超过 5 个候选目标，请提供优先级或聚类为 3-5 个；要求用户确认最终设置。
- 确认：覆盖现有战略目标文件之前；在最终坚持之前。
执行过程
- 加载愿景、北极星和战略支柱：阅读
docs/project-overview/vision.md、docs/project-overview/north-star.md 和 docs/project-overview/strategic-pillars.md（如存在）或用户提供的摘要。
- 逆向拆解北极星指标：问"要让北极星指标增长，什么必须为真？"每个"必须为真"就是一个候选目标。目标从基础能力到完善逐层递进。
- 目标草案：注重结果（例如“将 80% 团队的部署时间减少到 5 分钟以下”）；不是任务列表或功能列表。
- 工程健康目标检查：
- 询问或判断项目计划期（> 6 个月视为长期项目）。
- 若长期项目且草案无工程 / 治理健康目标 → 提示用户是否引入默认模板（见下方"工程健康目标模板"）；用户可按项目实际调整关键结果。
- 若短期 / 实验性项目用户选择豁免 → 在文档末尾记录"豁免理由"。
- 检查一致性：每个目标都支持愿景；至少有一个明确支持北极星。
- 持久化：写入到项目约定的路径；如果缺少，请创建“docs/project-overview/”。可选：为每个目标添加“这如何支持愿景/NSM”。
工程健康目标模板（默认）
长期项目必含此类目标（具体关键结果按项目调整）：
## 目标 N: 工程与治理健康可持续
**描述**：确保项目的代码质量、文档一致性、治理机制持续演进，
支撑其他战略目标的长期可达成。
**关键结果**（示例，按项目调整）：
- 核心文档规范（ARTIFACT_NORMS）100% 合规
- ADR 覆盖率 ≥ 90%（所有架构决策有文档）
- 技术债 backlog 项数 ≤ X（按团队规模定）
- 治理健康矩阵通过率 ≥ 95%（plan-next 输出）
- 生产事故 MTTR ≤ Y 小时
此目标支持的是所有其他战略目标的长期可达成性，不是独立产品目标。它的存在保证治理 / 技术债 / 文档等基础工作在价值竞争中有合法战略位置（依据 ADR 1 决策 3.4 和 3.5：容量护栏按 strategic_goal 分配）。
输入与输出 (Input & Output)
输入：
- 必需：愿景；北极星（或通往愿景/北极星文档的路径）；项目背景。
- 可选：任务；时间范围；现有的目标或优先事项。
输出：
- 工件：战略目标文档。
- 位置：
docs/project-overview/strategic-goals.md（或每个项目规范）。
- 内容：3-5个战略目标（标题+简短描述）；可选：链接到愿景/NSM；每个目标“这如何支持愿景/NSM”。
- 生命周期：生活（在战略周期进行审查）。
限制（限制）
硬边界（Hard Boundaries）
- 不要在此技能中定义使命、愿景、北极星或里程碑。
- 不要在目标文档中包含日期或阶段（这些属于“定义里程碑”）。
- 文档中的战略目标不得少于 3 个或多于 5 个。
- 长期项目（计划期 > 6 个月）不得完全省略工程 / 治理健康类目标；若豁免必须在文档记录理由。
技能边界 (Skill Boundaries)（避免重叠）
不要做这些（其他技能可以处理它们）：
- 使命：我们为何存在→使用
define-mission。
- 愿景：我们构建什么样的未来→使用“定义愿景”。
- 北极星：单一指标 → 使用
define-north-star。
- 里程碑：阶段检查点→使用
define-里程碑。
- 需求或待办：使用“分析需求”、“捕获工作项目”、项目规划。
何时停止并交接：
- 用户说“已批准”或同等内容 → 目标完成；提供转交“定义里程碑”。
- 用户请求阶段或里程碑 → 移交给“定义里程碑”。
自检（Self-Check）
核心成功标准（必须满足所有标准）
流程质量检查
验收测试
读者能否在不需要日期或阶段的情况下了解每个目标如何推进愿景和北极星？
如果否：目标可能过于战术性或缺乏一致性。细化结果和状态一致性。
如果是：战略目标已完成。继续转交或停止。
示例（示例）
示例 1：完整的层次结构到位
背景：愿景和北极星存在。用户想要 3-5 个战略目标。
流程：阅读愿景和北极星文档。得出结果（例如“80% 的团队在 5 分钟内完成部署”、“标准部署零手动步骤”、“每次部署的完整审核跟踪”）。起草 3-5 个目标；说明每个人如何支持愿景/NSM。用户确认。写入“docs/project-overview/strategic-goals.md”。
结果：目标持续存在； 提供转交“定义里程碑”。
示例 2：用户提出六个目标
上下文：用户列出了六个候选目标；计划只允许 3-5 个。
流程：聚类或按优先级划分为 3-5 个（例如，合并两个相关目标，或放弃最低优先级）。展示第 3-5 组并附上理由；请用户确认或调整。确保每一项都以结果为中心并与愿景/NSM 保持一致。一旦确认就坚持。
结果：文档恰好包含 3-5 个目标；用户已明确批准该集。
示例 3：长期项目缺工程健康目标（边缘场景）
背景：用户草拟了 4 个战略目标，全部是用户 / 市场导向；项目计划期 12 个月（长期项目）。
流程：
- 检测到 4 个目标均无涉及工程 / 治理健康。
- 提示用户："这是长期项目，建议引入工程健康目标，否则技术债 / 治理工作长期无战略代言，容量护栏无处施加。"
- 展示默认模板；用户调整关键结果（如"技术债 backlog 项数 ≤ 20"改为"≤ 30"，基于团队规模）。
- 用户确认纳入为目标 5。
- 持久化 5 个目标。
结果：文档含 5 个战略目标，其中目标 5 是"工程与治理健康可持续"。容量护栏后续按 strategic_goal_id 分配（见 ADR 1 决策 3.4）时有合法位置。
