@sushanglewis/lincoln 1.5.5 → 1.6.2

package/framework/.claude/stages/explore-opensource.yaml

@@ -1,4 +1,4 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: explore-opensource
 name: Explore Open Source
 description: 'Researches existing open-source projects that can inform
@@ -6,31 +6,34 @@ description: 'Researches existing open-source projects that can inform
   or solve the current requirement. Triggered by oss-first-design
 
   template after clarify.'
-templates:
+workflows:
 - oss-first-design
 prerequisite_stage: clarify
 next_stage: product-design-docs
 human_gate: false
+execution_mode: solo
+primary_action: lc-explore-opensource
+variables:
+- process_slug
+- change_name
 agent:
   primary: lc-researcher
   reviewers:
   - lc-engineer
   handoff_to: lc-pm
 skills:
-  required: []
+  required:
+  - lincoln:lc-explore-opensource
   optional: []
 artifacts:
   required:
   - '{process_slug}/docs/research/{change_name}-oss-options.md'
+references:
+  skill_prompt: .claude/skills/lc-explore-opensource/SKILL.md
+  agent_guide: .claude/agents/researcher.md
 context:
   goal: 在设计阶段探索开源方案，避免从零造轮子，并为实现提供参考。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-explore-opensource skill 调研可复用的开源方案，评估其适配性、许可与维护状况，产出 {process_slug}/docs/research/{change_name}-oss-options.md，为产品设计与实现提供决策参考。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/implement.yaml

@@ -1,4 +1,4 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: implement
 name: Implement
 description: 'Core implementation stage. Engineering executes tasks with TDD
@@ -8,10 +8,16 @@ description: 'Core implementation stage. Engineering executes tasks with TDD
   for human engineering work; test/verify and ship occur within
 
   this stage or as follow-up PR lifecycle steps.'
-templates: all
+workflows:
+- bug-fix
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: split
 next_stage: sync-knowledge
 human_gate: true
+execution_mode: both
+primary_action: implement
 agent:
   primary: lc-engineer
   reviewers:
@@ -40,17 +46,11 @@ skills:
   - oh-my-claudecode:ultrawork
 artifacts:
   required: []
+references:
+  agent_guide: .claude/agents/engineer.md
 context:
   goal: 人类研发团队基于已创建的 GitHub Issues 进行代码开发并提交 PR。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 本阶段设有 human_gate，必须获得人类 PM 显式确认后才能进入下一阶段。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: 人类研发团队基于 split 阶段创建的 GitHub Issues 按 TDD 纪律进行代码开发、评审与 PR 提交；Agent 在此阶段暂停主动驱动，由人类工程师主导实现工作，PR 合并后触发 sync-knowledge。
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/ingest.yaml

@@ -1,19 +1,25 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: ingest
 name: Ingest
 description: 'Ingests raw interview recordings and produces transcripts,
 
   summaries, and raw insights.'
-templates:
+workflows:
 - interview-to-knowledge
 prerequisite_stage: workflow-router
 next_stage: clarify
 human_gate: false
+execution_mode: team
+primary_action: process-interview
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-pm
   handoff_to: lc-pm
 skills:
-  required: []
+  required:
+  - lincoln:process-interview
   optional:
   - oh-my-claudecode:deep-interview
 artifacts:
@@ -22,15 +28,12 @@ artifacts:
   - '{process_slug}/interviews/{session_id}/transcript.md'
   - '{process_slug}/interviews/{session_id}/summary.md'
   - '{process_slug}/interviews/{session_id}/raw-insights.md'
+references:
+  skill_prompt: .claude/skills/process-interview/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 将音频访谈录音转写为结构化文本，生成带时间戳的逐字稿、摘要和初始洞察，为后续需求澄清阶段提供输入。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: 调用 process-interview skill 处理 {process_slug}/recordings/ 下的原始音频，生成带时间戳的逐字稿、摘要与初始洞察，写入 {process_slug}/interviews/{session_id}/ 目录作为 clarify 阶段的输入。
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-analyze-frameworks.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-analyze-frameworks
 name: 分析框架应用
-description: '选择并应用 SWOT、波特五力、商业模式画布、PEST 等分析框架，规划可视化方案。'
-templates:
+description: 选择并应用 SWOT、波特五力、商业模式画布、PEST 等分析框架，规划可视化方案。
+workflows:
 - pm-research
 prerequisite_stage: lc-competitive-analysis
 next_stage: lc-collect-intelligence
 human_gate: false
+execution_mode: solo
+primary_action: lc-analyze-frameworks
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-researcher
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/analysis-frameworks.md'
+references:
+  skill_prompt: .claude/skills/lc-analyze-frameworks/SKILL.md
+  agent_guide: .claude/agents/researcher.md
 context:
   goal: 选择并应用 SWOT、波特五力、商业模式画布、PEST 等分析框架，规划可视化方案。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-analyze-frameworks skill 基于已收集的研究材料选择并应用合适的分析框架（SWOT、波特五力、商业模式画布、PEST 等），输出 analysis-frameworks.md 并规划 ECharts/HTML 可视化方案。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-collect-intelligence.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-collect-intelligence
 name: 信息收集
-description: '基于权威报告、官方动态、开放 API 等渠道体系化收集研究证据并标注来源。'
-templates:
+description: 基于权威报告、官方动态、开放 API 等渠道体系化收集研究证据并标注来源。
+workflows:
 - pm-research
 prerequisite_stage: lc-analyze-frameworks
 next_stage: lc-storytelling
 human_gate: false
+execution_mode: solo
+primary_action: lc-collect-intelligence
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-researcher
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/collected-intelligence.md'
+references:
+  skill_prompt: .claude/skills/lc-collect-intelligence/SKILL.md
+  agent_guide: .claude/agents/researcher.md
 context:
   goal: 基于权威报告、官方动态、开放 API 等渠道体系化收集研究证据并标注来源。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-collect-intelligence skill 基于权威报告、官方动态、开放 API、官网等渠道体系化收集研究证据，标注来源并写入 collected-intelligence.md。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-competitive-analysis.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-competitive-analysis
 name: 竞品分析
-description: '分析竞争格局、竞争对手定位与差异化机会。'
-templates:
+description: 分析竞争格局、竞争对手定位与差异化机会。
+workflows:
 - pm-research
 prerequisite_stage: lc-product-research
 next_stage: lc-analyze-frameworks
 human_gate: false
+execution_mode: solo
+primary_action: lc-competitive-analysis
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-researcher
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/competitive.md'
+references:
+  skill_prompt: .claude/skills/lc-competitive-analysis/SKILL.md
+  agent_guide: .claude/agents/researcher.md
 context:
   goal: 分析竞争格局、竞争对手定位与差异化机会。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-competitive-analysis skill 分析竞争格局、竞争对手定位、能力与差异化机会，输出 competitive.md。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-first-principles.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-first-principles
 name: 第一性原理探索
-description: '挑战现有假设，挖掘底层真相，为研究建立第一性原理基础。'
-templates:
+description: 挑战现有假设，挖掘底层真相，为研究建立第一性原理基础。
+workflows:
 - pm-research
 prerequisite_stage: lc-research-scope
 next_stage: lc-stakeholder-research
 human_gate: false
+execution_mode: solo
+primary_action: lc-first-principles
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-pm
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/first-principles.md'
+references:
+  skill_prompt: .claude/skills/lc-first-principles/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 挑战现有假设，挖掘底层真相，为研究建立第一性原理基础。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-first-principles skill 帮助 PM 回归底层真相、挑战假设、识别第一性原理，输出 first-principles.md 作为研究的基础。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-market-research.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-market-research
 name: 市场研究
-description: '分析市场规模、趋势、细分与动态，为产品定位提供事实基础。'
-templates:
+description: 分析市场规模、趋势、细分与动态，为产品定位提供事实基础。
+workflows:
 - pm-research
 prerequisite_stage: lc-stakeholder-research
 next_stage: lc-product-research
 human_gate: false
+execution_mode: solo
+primary_action: lc-market-research
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-researcher
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/market.md'
+references:
+  skill_prompt: .claude/skills/lc-market-research/SKILL.md
+  agent_guide: .claude/agents/researcher.md
 context:
   goal: 分析市场规模、趋势、细分与动态，为产品定位提供事实基础。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-market-research skill 分析市场规模、趋势、细分与动态，输出 market.md，为产品定位与机会判断提供事实基础。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-product-research.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-product-research
 name: 产品研究
-description: '研究相关产品与解决方案的能力、价值主张、使用场景与优劣势。'
-templates:
+description: 研究相关产品与解决方案的能力、价值主张、使用场景与优劣势。
+workflows:
 - pm-research
 prerequisite_stage: lc-market-research
 next_stage: lc-competitive-analysis
 human_gate: false
+execution_mode: solo
+primary_action: lc-product-research
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-researcher
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/product-research.md'
+references:
+  skill_prompt: .claude/skills/lc-product-research/SKILL.md
+  agent_guide: .claude/agents/researcher.md
 context:
   goal: 研究相关产品与解决方案的能力、价值主张、使用场景与优劣势。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-product-research skill 研究相关产品与解决方案的能力、价值主张、使用场景与优劣势，输出 product-research.md。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-research-report.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-research-report
 name: 研究报告
-description: '整合全流程产物，输出可交付、可沉淀的最终研究报告。'
-templates:
+description: 整合全流程产物，输出可交付、可沉淀的最终研究报告。
+workflows:
 - pm-research
 prerequisite_stage: lc-storytelling
 next_stage: null
 human_gate: true
+execution_mode: solo
+primary_action: lc-research-report
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-pm
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/report.md'
+references:
+  skill_prompt: .claude/skills/lc-research-report/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 整合全流程产物，输出可交付、可沉淀的最终研究报告。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-research-report skill 整合研究全流程产物（scope/first-principles/stakeholders/market/product-research/competitive/analysis-frameworks/collected-intelligence/narrative），输出可交付、可沉淀的 report.md。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-research-scope.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-research-scope
 name: 界定研究范围
-description: '与 PM 澄清研究目标、问题、范围与验收标准，输出已确认的研究 brief。'
-templates:
+description: 与 PM 澄清研究目标、问题、范围与验收标准，输出已确认的研究 brief。
+workflows:
 - pm-research
 prerequisite_stage: workflow-router
 next_stage: lc-first-principles
 human_gate: true
+execution_mode: solo
+primary_action: lc-research-scope
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-pm
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/scope.md'
+references:
+  skill_prompt: .claude/skills/lc-research-scope/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 与 PM 澄清研究目标、问题、范围与验收标准，输出已确认的研究 brief。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-research-scope skill 与 PM 多轮澄清研究目标、问题、范围与验收标准，输出已确认的 scope.md，作为后续各研究阶段的单一事实来源。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-stakeholder-research.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-stakeholder-research
 name: 相关者研究
-description: '识别并研究用户、买单方、建设方、维护方等关键相关者及其诉求。'
-templates:
+description: 识别并研究用户、买单方、建设方、维护方等关键相关者及其诉求。
+workflows:
 - pm-research
 prerequisite_stage: lc-first-principles
 next_stage: lc-market-research
 human_gate: false
+execution_mode: solo
+primary_action: lc-stakeholder-research
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-researcher
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/stakeholders.md'
+references:
+  skill_prompt: .claude/skills/lc-stakeholder-research/SKILL.md
+  agent_guide: .claude/agents/researcher.md
 context:
   goal: 识别并研究用户、买单方、建设方、维护方等关键相关者及其诉求。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-stakeholder-research skill 识别并研究用户、买单方、建设方、维护方等关键相关者，找到他们的发声渠道并分析其诉求，输出 stakeholders.md。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/lc-storytelling.yaml

@@ -1,12 +1,17 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: lc-storytelling
 name: 体系化论述
-description: '基于金字塔原理将研究成果结构化为可说服决策者的故事体系。'
-templates:
+description: 基于金字塔原理将研究成果结构化为可说服决策者的故事体系。
+workflows:
 - pm-research
 prerequisite_stage: lc-collect-intelligence
 next_stage: lc-research-report
 human_gate: false
+execution_mode: solo
+primary_action: lc-storytelling
+variables:
+- process_slug
+- session_id
 agent:
   primary: lc-pm
   reviewers:
@@ -19,15 +24,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/research/{session_id}/narrative.md'
+references:
+  skill_prompt: .claude/skills/lc-storytelling/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 基于金字塔原理将研究成果结构化为可说服决策者的故事体系。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml 或 .context/workflow/pm-research.yaml。
-
-    - 本阶段产物写入 {process_slug}/research/{session_id}/。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 lc-storytelling skill 基于金字塔原理与科学论述逻辑，将研究成果结构化为可说服决策者的故事，输出 narrative.md。"
+  constraints: "- 本阶段产物写入 {process_slug}/research/{session_id}/。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/product-design-docs.yaml

@@ -1,13 +1,31 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: product-design-docs
 name: Product Design Docs
-description: 'Produces the design-review package based on confirmed
-
-  requirements. May include early OpenSpec drafts.'
-templates: all
+description: 基于已确认需求生成产品设计评审文档包（design-review、scenarios、feature-catalog、data-model、flows、feasibility、page-map、version-log、api-list 等 HTML），并完成 PM→UX 交接产物。
+workflows:
+- bug-fix
+- design-spike
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: clarify
 next_stage: product-prototype
 human_gate: true
+execution_mode: both
+primary_action: draft-product-design
+variables:
+- process_slug
+artifact_templates:
+  '{process_slug}/pages/docs/design-review.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/scenarios.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/feature-catalog.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/data-model.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/flows.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/feasibility.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/page-map.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/version-log.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/api-list.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/handoff-pm-to-ux-v*.html': .claude/templates/issue-package/page-doc-structured.html.tpl
 agent:
   primary: lc-pm
   reviewers:
@@ -37,21 +55,15 @@ artifacts:
   - '{process_slug}/pages/docs/handoff-pm-to-ux-v*.html'
   - '{process_slug}/handoffs/pm-to-ux/pm-to-ux.handoff.yaml'
   - '{process_slug}/handoffs/pm-to-ux/master-handoff-pm-to-ux-v*.md'
+references:
+  skill_prompt: .claude/skills/draft-product-design/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
-  goal: 将已确认的需求转化为面向人类 PM 评审的简洁产品设计文档包，并完成 PM→UX 交接产物（agent-agent 契约），使人类 UX 能基于统一认知驱动 UX Agent。所有产物通过 {process_slug}/index.html 门户访问。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 本阶段设有 human_gate，必须获得人类 PM 显式确认后才能进入下一阶段。
-
-    - 本阶段 exit gate 要求 `handoffs/pm-to-ux/pm-to-ux.handoff.yaml` 存在。
-
-    - handoff_to 为 lc-designer；接收方 Agent 必须从 `handoffs/pm-to-ux/pm-to-ux.handoff.yaml` 开始读取，再按 `context_pack` 顺序读取 Tier-2 文档。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
+  goal: 将已确认的需求转化为面向人类 PM 评审的简洁产品设计文档包（design-review/scenarios/feature-catalog/data-model/flows/feasibility/page-map/version-log/api-list 等 HTML），并完成 PM→UX 交接产物（agent-agent 契约），使人类 UX 能基于统一认知驱动 UX Agent。所有产物通过 {process_slug}/index.html 门户访问。
+  execution: 调用 draft-product-design skill 基于已确认的需求生成设计文档包（HTML 页面），并产出 PM→UX handoff 契约（pm-to-ux.handoff.yaml + master-handoff-pm-to-ux-v*.md），作为 UX 阶段接收方的入口。UI 规范、字段规范与可交互原型由下一阶段的 product-prototype 负责，不在本阶段产出。
+  constraints: '- 本阶段 exit gate 要求 `handoffs/pm-to-ux/pm-to-ux.handoff.yaml` 存在。
 
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+    - handoff_to 为 lc-designer；接收方 Agent 必须从 `handoffs/pm-to-ux/pm-to-ux.handoff.yaml` 开始读取，再按 `context_pack` 顺序读取 Tier-2 文档。'
 gates:
   entry:
   - check: previous_stage_completed