# 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/tdd-plan-template.md)
- [`../templates/todo-yaml-template.md`](../templates/todo-yaml-template.md)
- [`../templates/spec-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`