@sushanglewis/lincoln 1.5.4 → 1.6.1

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:
@@ -17,12 +35,12 @@ agent:
   handoff_to: lc-designer
 skills:
   required:
+  - lincoln:draft-product-design
   - superpowers:brainstorming
   - superpowers:writing-plans
   optional:
   - gsd:spec-phase
   - oh-my-claudecode:plan
-  - openspec:propose
 artifacts:
   required:
   - '{process_slug}/pages/docs/design-review.html'
@@ -34,22 +52,18 @@ artifacts:
   - '{process_slug}/pages/docs/page-map.html'
   - '{process_slug}/pages/docs/version-log.html'
   - '{process_slug}/pages/docs/api-list.html'
+  - '{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 / lc-frontend-engineer；接收方 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

package/framework/.claude/stages/product-prototype.yaml

@@ -1,15 +1,24 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: product-prototype
 name: Product Prototype
-description: Generates UI specs, field specs, and optionally Pencil prototypes (prototype.pen is produced by UI after the UX node).
-templates:
-- interview-to-knowledge
-- existing-project-iteration
+description: 基于已确认设计文档生成字段规格、UI 规格和可交互 HTML 原型（pages/prototype/**/*.html）。Pencil 原型（prototype.pen）为可选，由 UI 在 UX 节点之后按需产出。
+workflows:
 - design-spike
+- existing-project-iteration
+- interview-to-knowledge
 - oss-first-design
 prerequisite_stage: product-design-docs
 next_stage: tdd-development-plan
 human_gate: true
+execution_mode: both
+primary_action: build-product-prototype
+variables:
+- process_slug
+- design_id
+artifact_templates:
+  '{process_slug}/pages/docs/ui-spec.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/fields.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/prototype/**/*.html': .claude/templates/issue-package/page-prototype-structured.html.tpl
 agent:
   primary: lc-designer
   reviewers:
@@ -18,6 +27,7 @@ agent:
   handoff_to: lc-engineer
 skills:
   required:
+  - lincoln:build-product-prototype
   - superpowers:brainstorming
   optional:
   - gsd:ui-phase
@@ -27,22 +37,16 @@ artifacts:
   required:
   - '{process_slug}/pages/docs/ui-spec.html'
   - '{process_slug}/pages/docs/fields.html'
+  - '{process_slug}/pages/prototype/**/*.html'
   optional:
   - '{process_slug}/designs/{design_id}/prototype.pen'
-  - '{process_slug}/pages/prototype/**/*.html'
+references:
+  skill_prompt: .claude/skills/build-product-prototype/SKILL.md
+  agent_guide: .claude/agents/designer.md
 context:
-  goal: 将已确认的产品设计文档转化为开发可用的 UI/字段规格 HTML 文档；`prototype.pen` 由 UI 在 UX 节点之后产出，因此在本阶段 PM→UX 交接中视为 optional。所有产物通过 {process_slug}/index.html 门户访问。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 本阶段设有 human_gate，必须获得人类 PM 显式确认后才能进入下一阶段。
-
-    - `prototype.pen` 为 UI 阶段产物，在 PM→UX 交接中不作为 required artifact。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  goal: 将已确认的产品设计文档转化为开发可用的 UI/字段规格 HTML 文档与高保真 HTML 交互原型。HTML 原型是本阶段的主要评审产物；`prototype.pen` 由 UI 在 UX 节点之后按需产出，在本阶段视为 optional。所有产物通过 {process_slug}/index.html 门户访问。
+  execution: 调用 build-product-prototype skill 基于已确认的设计文档生成 fields.html、ui-spec.html 以及 pages/prototype/ 下的高保真 HTML 交互原型；Pencil 原型（prototype.pen）为 optional，仅在 PM 明确要求时由 UI 在 UX 节点之后产出。
+  constraints: '- `{process_slug}/pages/prototype/**/*.html` 为 required 高保真 HTML 交互原型；`prototype.pen` 为 optional UI 阶段产物。'
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/propose.yaml

@@ -1,13 +1,22 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: propose
 name: Propose
 description: 'Generates a complete OpenSpec change proposal including
 
   proposal.md, design.md, tasks.md, and specs/ directory.'
-templates: all
+workflows:
+- bug-fix
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: tdd-development-plan
 next_stage: split
 human_gate: false
+execution_mode: both
+primary_action: propose-with-openspec
+variables:
+- process_slug
+- change_name
 agent:
   primary: lc-engineer
   reviewers:
@@ -16,6 +25,7 @@ agent:
   handoff_to: lc-pm
 skills:
   required:
+  - lincoln:propose-with-openspec
   - openspec:propose
   optional:
   - superpowers:verification-before-completion
@@ -26,16 +36,13 @@ artifacts:
   - '{process_slug}/openspec/changes/{change_name}/design.md'
   - '{process_slug}/openspec/changes/{change_name}/tasks.md'
   - '{process_slug}/openspec/changes/{change_name}/specs/'
+references:
+  skill_prompt: .claude/skills/propose-with-openspec/SKILL.md
+  agent_guide: .claude/agents/engineer.md
 context:
   goal: 基于已确认的 TDD 研发计划，调用 OpenSpec CLI 生成标准变更提案 artifact 目录（`{process_slug}/openspec/changes/{change_name}/`），将
     TDD 计划转化为结构化的 OpenSpec 变更提案，作为后续 GitHub Issues 拆分和研发实现的依据。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: 调用 propose-with-openspec skill，通过 OpenSpec CLI 读取 tdd-plan.html 并生成标准变更提案目录，包含 proposal.md、design.md、tasks.md 与 specs/，作为后续 GitHub Issues 拆分与研发实现的依据。
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/split.yaml

@@ -1,13 +1,19 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: split
 name: Split
 description: 'Breaks OpenSpec tasks into parallel, independently implementable
 
   GitHub Issues with clear boundaries and acceptance criteria.'
-templates: all
+workflows:
+- bug-fix
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: propose
 next_stage: implement
 human_gate: false
+execution_mode: both
+primary_action: split-to-github
 agent:
   primary: lc-pm
   reviewers:
@@ -16,6 +22,7 @@ agent:
   handoff_to: lc-engineer
 skills:
   required:
+  - lincoln:split-to-github
   - superpowers:dispatching-parallel-agents
   optional:
   - gsd:phase
@@ -23,15 +30,12 @@ skills:
 artifacts:
   required:
   - .github/linked-issues.yaml
+references:
+  skill_prompt: .claude/skills/split-to-github/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 将 OpenSpec 变更提案中的 tasks 拆分为可执行的 GitHub Issues，建立从需求到代码追踪的完整链路。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: 调用 split-to-github skill 读取 OpenSpec 变更提案中的 tasks，拆分为边界清晰、可独立实施的 GitHub Issues，并写入 .github/linked-issues.yaml 维护任务与 issue 的双向映射。
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/sync-knowledge.yaml

@@ -1,4 +1,4 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: sync-knowledge
 name: Sync Knowledge
 description: 'After PR merge, updates Obsidian vault and archives milestone
@@ -6,16 +6,30 @@ description: 'After PR merge, updates Obsidian vault and archives milestone
   artifacts, generating feature docs, decision docs, and interview
 
   summaries.'
-templates: all
+workflows:
+- bug-fix
+- design-spike
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: implement
 next_stage: null
 human_gate: false
+execution_mode: both
+primary_action: sync-to-knowledge
+variables:
+- pr_number
+- session_id
+- requirement_id
+- feature_slug
+- decision_id
 agent:
   primary: lc-knowledge-curator
   reviewers:
   - lc-release-coordinator
 skills:
   required:
+  - lincoln:sync-to-knowledge
   - gsd:docs-update
   optional:
   - gsd:forensics
@@ -31,15 +45,12 @@ artifacts:
   - knowledge/02-requirements/{requirement_id}.md
   - knowledge/03-features/{feature_slug}.md
   - knowledge/04-decisions/{decision_id}.md
+references:
+  skill_prompt: .claude/skills/sync-to-knowledge/SKILL.md
+  agent_guide: .claude/agents/knowledge-curator.md
 context:
   goal: PR 合并后，将代码变更、Issue 讨论、设计决策沉淀到项目 Obsidian 知识库，确保业务知识和技术知识双轨保存，形成可追溯的知识资产。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 sync-to-knowledge skill 在 PR 合并后将代码变更、Issue 讨论与设计决策写入 Obsidian vault（knowledge/01-interviews、02-requirements、03-features、04-decisions），并在 .github/lincoln-sync-queue/pr-{pr_number}.yaml 记录同步状态。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/tdd-development-plan.yaml

@@ -1,13 +1,23 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: tdd-development-plan
 name: TDD Development Plan
 description: 'Produces tdd-plan.html with red/green/refactor sequences,
 
   test scenarios, and task slices ready for OpenSpec proposal.'
-templates: all
+workflows:
+- bug-fix
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: product-prototype
 next_stage: propose
 human_gate: false
+execution_mode: both
+primary_action: plan-tdd-development
+variables:
+- process_slug
+artifact_templates:
+  '{process_slug}/pages/docs/tdd-plan.html': .claude/templates/issue-package/page-doc.html.tpl
 agent:
   primary: lc-engineer
   reviewers:
@@ -16,6 +26,7 @@ agent:
   handoff_to: lc-engineer
 skills:
   required:
+  - lincoln:plan-tdd-development
   - superpowers:writing-plans
   - superpowers:test-driven-development
   optional:
@@ -25,15 +36,12 @@ skills:
 artifacts:
   required:
   - '{process_slug}/pages/docs/tdd-plan.html'
+references:
+  skill_prompt: .claude/skills/plan-tdd-development/SKILL.md
+  agent_guide: .claude/agents/engineer.md
 context:
   goal: 基于已确认的产品设计文档、字段规格、UI 规格和 Pencil 原型，生成可执行的测试驱动研发计划（`tdd-plan.html`），作为从产品设计到 OpenSpec 变更提案的桥梁。所有产物通过 {process_slug}/index.html 门户访问。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 plan-tdd-development skill 基于已确认的产品设计文档、字段规格、UI 规格和 Pencil 原型，生成包含验收映射、测试场景与任务切片的 tdd-plan.html，作为 OpenSpec 提案的输入。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/workflow-router.yaml

@@ -1,4 +1,4 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: workflow-router
 name: Workflow Router
 description: 'Entry point. Runs session intake (overview recon, situation judgment,
@@ -6,10 +6,19 @@ description: 'Entry point. Runs session intake (overview recon, situation judgme
   Johari confirmation) on cold start, assesses repository context, selects the most
 
   appropriate workflow template, and initializes workflow-stage.'
-templates: all
+workflows:
+- bug-fix
+- design-spike
+- existing-project-iteration
+- oss-first-design
+- pm-research
 prerequisite_stage: null
 next_stage: null
 human_gate: true
+execution_mode: both
+primary_action: lc-workflow-router
+variables:
+- process_slug
 agent:
   primary: lc-pm
   reviewers:
@@ -17,6 +26,7 @@ agent:
   handoff_to: lc-pm
 skills:
   required:
+  - lincoln:lc-workflow-router
   - superpowers:bootstrap
   optional:
   - gsd:new-project
@@ -25,19 +35,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/workflow-stage.yaml'
+references:
+  skill_prompt: .claude/skills/lc-workflow-router/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 在会话启动时先做概览级摸排与处境判断（冷启动开场引导），经用户确认后选择最适合的 Lincoln 工作流模板。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 开场摸排为概览级：只读操作 ≤ 8 次，不读源码实现，不做深度扫描（禁用 lc-build-codebase-knowledge）。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 本阶段设有 human_gate，必须获得人类 PM 显式确认后才能进入下一阶段。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: 调用 lc-workflow-router skill 的 intake 流程：执行概览级摸排与处境判断，向人类 PM 提出 Johari 确认问题，经用户确认目标与执行路径后选择最匹配的工作流模板并初始化 {process_slug}/workflow-stage.yaml。
+  constraints: '- 开场摸排为概览级：只读操作 ≤ 8 次，不读源码实现，不做深度扫描（禁用 lc-build-codebase-knowledge）。'
 gates:
   entry: []
   exit:

package/framework/.claude/workflows/README.md

@@ -73,13 +73,35 @@
 - **Skill（技能）**：阶段可调用的方法论子技能或 Lincoln 原生技能，由阶段 yaml 的 `skills` 字段声明。
 - **Role（角色）**：阶段默认 Agent 角色（pm、designer、engineer、qa、researcher、knowledge-curator、release-coordinator）。
 
+## 单一权威来源（SSOT）与产物路径一致性
+
+Lincoln 有四层配置可能引用同一产物路径，修改时必须同步，否则 Agent 会拿到脱钩的指引：
+
+| 事实 | 权威来源 | 副本（必须与权威一致） |
+|---|---|---|
+| 产物路径 / 必交性 | `.claude/stages/<stage>.yaml` 的 `artifacts` | workflow `.yaml` 的 `artifacts`/`optional_artifacts`、对应 skill 的 `SKILL.md` `outputs`、agent `.md` 的产物规范 |
+| 阶段顺序 | workflow `.yaml` 的 `steps` | stage `.yaml` 的 `prerequisite_stage` / `next_stage` |
+| 主执行 skill | workflow step 的 `action` | stage `.yaml` `skills.required` 首位、agent `.md` 可调用技能 |
+| 外部 skill 依赖 | `.claude/skills/dependencies.yaml` | stage `.yaml` `skills.required/optional` 中的 namespaced skill |
+
+仓库提供 `scripts/check-prompt-drift.py` 自动校验以上四层一致性。本地修改后、提交前必须运行：
+
+```bash
+./scripts/check-prompt-drift.py --strict --focus pm   # PM 三阶段必须绿
+./scripts/check-prompt-drift.py --strict               # 全量校验（逐步推进）
+```
+
+PM 三阶段（`clarify` / `product-design-docs` / `product-prototype`）的 drift 为阻塞项，其余阶段可在严格模式外先报告后治理。
+
 ## 如何新增工作流
 
 1. 在本目录创建 `<workflow-name>.yaml`，声明 `execution_mode: solo|team`。
 2. 遵循 [`workflow-template.schema.json`](../schemas/workflow-template.schema.json) 的字段约定（`execution_mode` 为必填）。
-3. 运行 `python3 "${CLAUDE_PLUGIN_ROOT:-${LINCOLN_HOME:-$HOME/.lincoln/current}}/scripts/lincoln_command_map.py" --refresh` 自动在 `.claude/harnesses/command-map.yaml` 登记 `lc-wf-<name>` 等命令，并同步 `.claude-plugin/plugin.json`，然后运行 `python3 "${CLAUDE_PLUGIN_ROOT:-${LINCOLN_HOME:-$HOME/.lincoln/current}}/scripts/lincoln-setup.py" generate-harness --harness codex --harness opencode` 重新生成适配产物。
-4. 在 `.claude/skills/lc-wf/SKILL.md` 的命令映射表中补充触发词。
-5. 更新本 README 的**快速路由表**和**工作流详解**。
+3. 若工作流使用已有 stage，必须保持该 stage 的 `artifacts` 与 workflow step 的 `artifacts`/`optional_artifacts` 一致；新增 stage 时同步更新 `.claude/skills/dependencies.yaml` 中引用的 skill。
+4. 运行 `./scripts/check-prompt-drift.py --strict --focus pm` 确认无漂移。
+5. 运行 `python3 "${CLAUDE_PLUGIN_ROOT:-${LINCOLN_HOME:-$HOME/.lincoln/current}}/scripts/lincoln_command_map.py" --refresh` 自动在 `.claude/harnesses/command-map.yaml` 登记 `lc-wf-<name>` 等命令，并同步 `.claude-plugin/plugin.json`，然后运行 `python3 "${CLAUDE_PLUGIN_ROOT:-${LINCOLN_HOME:-$HOME/.lincoln/current}}/scripts/lincoln-setup.py" generate-harness --harness codex --harness opencode` 重新生成适配产物。
+6. 在 `.claude/skills/lc-wf/SKILL.md` 的命令映射表中补充触发词。
+7. 更新本 README 的**快速路由表**和**工作流详解**。
 
 ## 相关文件
 

package/framework/.claude/workflows/bug-fix.yaml

@@ -66,6 +66,7 @@ workflow:
     - id: implement
       name: 研发实现
       description: 按 TDD 实施并完成验证
+      action: implement
       human_gate: true
 
     - id: sync-knowledge

package/framework/.claude/workflows/existing-project-iteration.yaml

@@ -91,6 +91,7 @@ workflow:
     - id: implement
       name: 研发实现
       description: 按 TDD 实施并完成验证
+      action: implement
       human_gate: true
 
     - id: sync-knowledge

package/framework/.claude/workflows/interview-to-knowledge.yaml

@@ -78,6 +78,7 @@ workflow:
         - "{process_slug}/pages/docs/api-list.html"
         - "{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"
       exit_checks:
         - check: design_docs_complete
           args: ["{design_id}"]
@@ -86,7 +87,7 @@ workflow:
 
     - id: product-prototype
       name: 产品原型
-      description: 基于已确认设计文档生成字段、界面规格；prototype.pen 由 UI 在 UX 节点之后产出，本阶段 optional
+      description: 基于已确认设计文档生成字段、界面规格与高保真 HTML 交互原型；Pencil 原型 optional
       entry_checks:
         - check: product_design_approved
           args: ["{design_id}"]
@@ -95,8 +96,8 @@ workflow:
       artifacts:
         - "{process_slug}/pages/docs/ui-spec.html"
         - "{process_slug}/pages/docs/fields.html"
-      optional_artifacts:
         - "{process_slug}/pages/prototype/**/*.html"
+      optional_artifacts:
         - "{process_slug}/designs/{design_id}/prototype.pen"
       exit_checks:
         - check: prototype_artifact_complete
@@ -153,6 +154,7 @@ workflow:
     - id: implement
       name: 研发实现
       description: 人类研发团队基于 Issues 开发并提交 PR
+      action: implement
       entry_checks:
         - check: issues_ready
           args: ["{session_id}"]

package/framework/.claude/workflows/oss-first-design.yaml

@@ -85,6 +85,7 @@ workflow:
     - id: implement
       name: 研发实现
       description: 按 TDD 实施并完成验证
+      action: implement
       human_gate: true
 
     - id: sync-knowledge