skills/cc-switch-dev-workflow/references/knowledge-base/sources/README.md

Sources Index And Traceability

Purpose

建立知识库的来源索引、追溯矩阵和冲突处理规则，确保所有核心规则可回溯。

When to Use

• 新增或修改知识库规则前
• 发现两份来源说法不一致时
• 需要证明某条 SOP 来自哪里时

Inputs

• 20260306-基于规范编程的开发模式与工作流.md
• 20260304-AI自动化开发流水线与可靠性工程(1).md
• 20260202-ralphy任务清单开发流程(3).md
• workflow.zip
• skills.zip

Outputs

• 源资产摘要索引
• 规则追溯矩阵
• 冲突处理顺序

Primary Agent/Model

GPT-5.4 Pro xhigh

Secondary Agent/Model

Claude Opus 4.6

Required Skills

• 无强制 skill；必要时参考 spec-reviewing 的一致性思路

Steps

1. 先看每个源资产对应的 digest 页面。
2. 判断这条规则是阶段骨架、质量原则、技能约束还是执行经验。
3. 若多个来源重叠，按“更具体、更晚、更新、更可执行”的顺序裁决。
4. 若裁决影响主流程或白名单，写 ADR 后再更新知识库正文。

Exit Criteria

• 每条核心规则都能指向至少一个源资产
• 冲突规则已记录取舍和去向
• 不需要回看原始大段会议文本即可找到规则入口

Failure Recovery

• 如果某条规则找不到来源，先降级为“待确认”，不要写入正式 SOP
• 如果来源冲突无法消解，写 ADR 并保留冲突说明

Related Templates

• ../templates/analysis-template.md
• ../templates/agent-handoff-template.md

Source Digest 列表

源资产	Digest
20260306-基于规范编程的开发模式与工作流.md	2026-03-06-spec-driven-workflow.md
20260304-AI自动化开发流水线与可靠性工程(1).md	2026-03-04-ai-pipeline-reliability.md
20260202-ralphy任务清单开发流程(3).md	2026-02-02-ralphy-task-list-flow.md
workflow.zip	workflow-zip-digest.md
skills.zip	skills-zip-digest.md

追溯矩阵

主题	主要来源	落点
Spec 驱动、CLAUDE.md、调研到实施的链路	20260306...md	foundations/spec-driven-development.md, workflows/stage-0-setup.md, playbooks/new-project-from-scaffold.md
可靠性数学、Gap、简化与重构收敛	20260304...md	foundations/reliability-and-convergence.md, foundations/refactoring-and-gap-closure.md, workflows/stage-4-alignment.md, workflows/stage-5-refinement.md
Ralphy 自包含任务标题与配置规则	20260202...md, skills.zip	templates/todo-yaml-template.md, workflows/stage-3-code.md
7 阶段流程骨架	workflow.zip	workflows/README.md 与全部阶段页
技能到阶段的映射	skills.zip	workflows/, templates/, orchestration/

冲突处理顺序

1. skills.zip 中技能规则优先于泛化的阶段口述，前提是它更具体。
2. 两份会议整理冲突时，优先更晚的文档。
3. workflow.zip 提供流程骨架，不覆盖后续更具体的技能行为约束。
4. 一切正式取舍写入 ../decisions/ADR-2026-03-21-source-precedence-and-conflict-resolution.md。