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

Source Digest: skills.zip

Purpose

提炼 skills.zip 中与知识库直接相关的 skill 行为约束，尤其是任务结构、审查门禁、检查点和计划模板。

When to Use

• 需要把阶段流程落到可执行技能时
• 需要定义 TODO.yaml、Plan/Impl 对、审查门禁和重构检查点时
• 需要确认“流程说法”和“技能行为”哪个更具体时

Inputs

• skills.zip

Outputs

• 技能级执行约束摘要
• 阶段到 skill 的映射
• 审查与计划模板约束

Primary Agent/Model

GPT-5.4 Pro xhigh

Secondary Agent/Model

Claude Opus 4.6

Required Skills

• spec-tasking
• spec-gap-tasking
• spec-reviewing
• ralphy-initializing
• tdd-planning
• tdd-implementing
• code-simplifying
• code-refactoring
• architecture-audit

Steps

1. 找出直接约束阶段流程的 skill。
2. 把技能规则转成知识库里的固定结构。
3. 将可变化的策略和命名差异转移到 ADR。

Exit Criteria

• 阶段和模板里的行为约束与 skill 真实定义一致

Failure Recovery

• 如果阶段文档与 skill 描述冲突，以 skill 描述定义的任务结构、检查点和门禁为准

Related Templates

• ../templates/tdd-plan-template.md
• ../templates/todo-yaml-template.md
• ../templates/spec-template.md

Core Conclusions

• spec-tasking 先审计 ANALYSIS.md，再生成 TODO.yaml，避免为已存在内容重复派工。
• spec-gap-tasking 必须先对照真实实现再生成 Plan/Impl 对，并按批次插入质量检查点。
• spec-reviewing 是 Spec 进入实施前的硬门禁，重点看结构、语义、可实施性和过度设计。
• code-simplifying 关注刚改过的代码，优先删除“伪代码化文档”和不必要抽象。
• code-refactoring 从最近变更出发，但会跨代码库追查重复、职责错位和依赖反转问题。
• architecture-audit 是系统级全库健康检查，不等同于最近修改的重构。

Reusable Rules

• TODO.yaml 的标题必须是一行内可执行说明。
• 对 Gap 和实现类任务，默认是 Plan -> Implement -> Simplify -> Checkpoint Refactor。
• 审查和重构任务都要以现有代码和现有文档为前提，不允许忽略现状直接重写。

Background Only

• skill 内部的示例路径、年份占位和具体范例文本
• 与当前知识库无关的语言特定参考文件细节

Conflict Notes

• 部分 skill 的文案更偏代码项目；知识库已经把这些规则重写为 CC Switch 可执行版，但不会改变核心任务结构。

Traceability Targets

• workflows/stage-2-spec.md
• workflows/stage-3-code.md
• workflows/stage-4-alignment.md
• workflows/stage-5-refinement.md
• templates/todo-yaml-template.md
• templates/tdd-plan-template.md