skills/cc-switch-dev-workflow/references/knowledge-base/sources/2026-02-02-ralphy-task-list-flow.md

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/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