文件
skills/cc-switch-dev-workflow/references/knowledge-base/sources

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 并保留冲突说明

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