# Source Digest: 2026-02-02 Ralphy Task List Flow

## Purpose
提炼 `20260202-ralphy任务清单开发流程(3).md` 中关于设计先行、Ralphy 配置和任务标题质量的最小执行规则。

## When to Use
- 需要快速解释为什么先写设计文档再让 AI 执行循环时
- 需要生成 `tasks.md` 或 `TODO.yaml` 的命名与约束时
- 需要初始化 `.ralphy/config.yaml` 时

## Inputs
- `20260202-ralphy任务清单开发流程(3).md`

## Outputs
- Ralphy 最小可执行规则
- 配置基线
- 任务文案要求

## Primary Agent/Model
`GPT-5.4 Pro xhigh`

## Secondary Agent/Model
`Claude Opus 4.6`

## Required Skills
- `ralphy-initializing`
- `spec-tasking`

## Steps
1. 提取最小流程和配置要求。
2. 将 `tasks.md` 规则折叠进 `TODO.yaml` 模板。
3. 保留必要配置项，去掉一次性案例细节。

## Exit Criteria
- Ralphy 初始化与任务标题规则都已有固定模板

## Failure Recovery
- 如果项目已不使用 Ralphy CLI，本页仍保留任务标题的自包含规则，不依赖具体工具

## Related Templates
- [`../templates/todo-yaml-template.md`](../templates/todo-yaml-template.md)
- [`../templates/claude-md-template.md`](../templates/claude-md-template.md)

## Core Conclusions
- 先写设计哲学与规范，再让 AI 进入执行循环，杠杆最大。
- 用法文档和设计文档属于低成本试错层，必须在代码前反复打磨。
- Ralphy 的规则配置要写死到项目配置里，而不是靠口头提醒。
- 默认 `TypeScript strict mode`、`KISS`、`DRY`、`YAGNI`、最大化复用。

## Reusable Rules
- `.ralphy/config.yaml` 至少要固定 `test/lint/build` 命令和项目规则。
- AI 执行前先读 `.references/`，如果有参考至少对照两个。
- 任务列表要能独立被执行，不能依赖任务正文的隐含语境。

## Background Only
- “几十轮打磨用法文档”的经验性描述
- 示例里的具体组件库和项目名

## Conflict Notes
- 本文使用 `tasks.md` 作为示例文件名；知识库统一使用 `TODO.yaml`，以 `workflow.zip` 和 `skills.zip` 为准。

## Traceability Targets
- `workflows/stage-0-setup.md`
- `workflows/stage-3-code.md`
- `templates/todo-yaml-template.md`