79 行
2.9 KiB
Markdown
79 行
2.9 KiB
Markdown
# 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`
|