运行时依赖
安装命令
点击复制本土化适配说明
Taku Plan — Taku 计划 安装说明: 安装命令:["openclaw skills install taku-plan"]
技能文档
Taku 计划 — 审查 + 计划流水线规则标签: [IRON LAW] 表示不可商量的正确性约束。 [GUIDANCE] 表示可能根据上下文进行调整的强烈默认值。 [GUIDANCE] 默认路径:按顺序运行三个步骤。除非项目状态明确显示步骤已经完成,否则每个门槛必须通过后才能进行下一步。
步骤检测 检查项目状态以确定从哪里开始: DESIGN.md 存在但未审查 → 从步骤 1(范围 + 架构审查)开始 设计已审查,UI 项目,设计审查未完成 → 从步骤 2(设计审查)开始 所有审查已完成或不需要 → 转到步骤 3(编写计划) 宣布从哪个步骤开始。
步骤 1:范围 + 架构审查 在设计尚未经过战略和技术审查时运行。 捕获范围错误(现在修复成本低,后期修复成本高)和架构缺陷,在编写代码之前。 输出目的地:审查文档(范围评估、架构图、边界情况、故障模式、测试映射)附加到 DESIGN.md,而不是 PLAN.md。 计划文档是纯执行内容。 完整流程在 references/plan-review.md 中。 加载并按照说明进行。 快速摘要: 范围审查:挑战前提,识别盲点,选择范围模式(EXPANSION / SELECTIVE EXPANSION / HOLD / REDUCTION) 架构审查:组件边界、数据流、边界情况、故障模式、测试映射 默认:按顺序运行两个审查。 自动检测范围仅或架构仅从措辞中。 如果审查产生关键缺陷 → 停止并在继续之前与用户一起解决它们。
步骤 2:设计审查(仅 UI 项目) 仅适用于具有 UI/UX 组件的项目。 对于 CLI、API、后端、基础设施项目,完全跳过。 输出目的地:设计审查评分和修复附加到 DESIGN.md,而不是 PLAN.md。 评分 9 个维度(美观、排版、颜色、间距、布局、运动、响应性、可访问性、内容层次)。 每个维度评分 0-10,任何低于 8 的评分都有具体的修复措施。 完整流程在 references/design-review.md 中。 加载并按照说明进行。 在没有 UI 或项目使用现有设计系统而无需自定义时跳过。
步骤 3:编写计划 模板选择 使用 DEPTH_TIER(由思考阶段或用户设置)来选择计划模板: 等级 标准 模板 轻量级 <50 个文件或单文件更改(1 个目录更改) 最小 — 目标、文件、每个任务的规格 标准 50-500 个文件,中等范围 具有执行提示的完整模板 深度 >500 个文件或跨越多个目录的更改(3+ 个目录更改) 标准 + 强制性架构图在标题中 自动重新分类: 如果范围在 sprint 中期扩大(例如,“简单 bug 修复”跨越 3 个模块的 6 个文件),则升级一个等级。 日志:深度升级:轻量级 -> 标准(原因:范围扩大到 N 个文件跨越 M 个模块)。
前提条件 已批准的 DESIGN.md 存在 已完成审查(范围、架构、设计 — 根据适用性) 在编写单个任务之前,彻底阅读设计文档 文件结构映射 在编写任务之前,映射将要创建或修改的每个文件: 具有明确边界和良好定义接口的设计单元 更喜欢较小、专注的文件 — 更容易推理、更可靠的编辑 更改在一起的文件应该一起生活(根据职责划分,而不是层) 在现有代码库中,遵循已建立的模式
任务粒度 每个任务都是一个连贯的工作单元 — 一个职责、一个文件集、一个 TDD 锚点。 TDD 循环(编写测试 -> 验证失败 -> 实现 -> 验证成功)由 /taku-build 在构建时强制执行,而不是在每个任务中重复。 与其枚举每个任务的每个 TDD 步骤,不如定义任务必须交付的内容:行为、合同、关键断言和边界情况。 构建代理从规格中读取并应用 TDD。 为什么选择规格而不是步骤: 具有每个任务全 TDD 步骤的 5 任务计划会产生 25 个待办事项,其中 ~15 个是样板。 规格使计划专注于重要的内容 — 构建什么以及如何验证它 — 而构建代理处理如何构建。
计划文档标题 使用 references/plan.md 作为标准和深度计划的本地起始脚手架。 以下规则覆盖脚手架,如果它们有所不同。 每个计划从以下开始: # [功能名称] 实现计划
对于代理工作者: 使用 /taku-build 实现此计划。
构建代理应选择顺序、并行或混合执行,除非用户显式覆盖它。
>
审查上下文: 范围和架构审查在 DESIGN.md 中。
此文档仅为执行内容。
>
构建代理合同:
- 必需: 目标、技术栈、执行提示(如果存在)、所有任务(取决于 + 规格 + 文件)
- 可选: 架构详细信息(在 DESIGN.md 中)、审查文档(在 DESIGN.md 中)
- 执行时跳过: 范围审查、架构审查部分(已经在 DESIGN.md 中)