Back to Details

plan

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
[IMPORTANT] Use 
TaskCreate
to break ALL work into small tasks BEFORE starting — including tasks for each file read. This prevents context loss from long files. For simple tasks, AI MUST ask user whether to skip.
Prerequisites: MUST READ 
.claude/skills/shared/understand-code-first-protocol.md
before executing.
  • docs/project-reference/domain-entities-reference.md
    — Domain entity catalog, relationships, cross-service sync (read when task involves business entities/models)
  • .claude/skills/shared/rationalization-prevention-protocol.md
    — Anti-evasion rebuttals (prevents "too simple for a plan" shortcuts)
  • docs/test-specs/
    — Test specifications by module (read existing TCs to include test strategy in plan)
Iterative Quality Gate: MUST READ 
.claude/skills/shared/iterative-phase-quality-protocol.md
. Before routing, assess complexity score. Score ≥3 → plan MUST produce multiple phases with per-phase quality cycles.
[重要提示] 使用
TaskCreate
在开始前将所有工作拆分为小任务——包括每个文件读取的任务。这可以避免长文件导致的上下文丢失。对于简单任务，AI必须询问用户是否跳过。
前置要求： 执行前必须阅读 
.claude/skills/shared/understand-code-first-protocol.md
。
  • docs/project-reference/domain-entities-reference.md
    —— 领域实体目录、关系、跨服务同步（当任务涉及业务实体/模型时阅读）
  • .claude/skills/shared/rationalization-prevention-protocol.md
    —— 反规避反驳机制（防止"计划太简单无需制定"的捷径）
  • docs/test-specs/
    —— 按模块划分的测试规范（阅读现有测试用例以在计划中纳入测试策略）
迭代质量关卡： 必须阅读 
.claude/skills/shared/iterative-phase-quality-protocol.md
。 在分流前，评估复杂度得分。得分≥3 → 计划必须拆分为多个阶段，每个阶段包含质量循环。

Quick Summary

快速概述

Goal: Intelligently create implementation plans by analyzing task complexity and routing to 
/plan-fast
or 
/plan-hard
.
Workflow:
  1. Analyze — Understand task, ask clarifying questions via AskUserQuestion
  2. Route — Decide 
    /plan-fast
    (simple) or 
    /plan-hard
    (complex) based on scope
  3. Create — Execute chosen plan variant, write plan to 
    plans/
    directory
  4. Validate — Offer 
    /plan-review
    and 
    /plan-validate
    for quality assurance
Key Rules:
  • PLANNING-ONLY: never implement, never use EnterPlanMode tool
  • Parent skill for all plan-* variants (plan-fast, plan-hard, plan-ci, plan-cro, plan-two, plan-parallel)
  • Always collaborate with user; ask decision questions, present options
  • Always add final 
    /plan-validate
    and 
    /plan-review
    tasks
目标： 通过分析任务复杂度并分流至
/plan-fast
或
/plan-hard
，智能创建实施计划。
工作流：
  1. 分析 —— 理解任务，通过AskUserQuestion工具提出澄清问题
  2. 分流 —— 根据范围决定使用
    /plan-fast
    （简单任务）或
    /plan-hard
    （复杂任务）
  3. 创建 —— 执行选定的计划变体，将计划写入
    plans/
    目录
  4. 验证 —— 提供
    /plan-review
    和
    /plan-validate
    以保障质量
核心规则：
  • 仅负责规划：绝不执行开发，绝不使用EnterPlanMode工具
  • 是所有plan-*变体的父级技能（plan-fast、plan-hard、plan-ci、plan-cro、plan-two、plan-parallel）
  • 始终与用户协作：询问决策类问题，提供选项
  • 始终添加最终的
    /plan-validate
    和
    /plan-review
    任务

Greenfield Mode

全新项目模式（Greenfield Mode）

Auto-detected: If no existing codebase is found (no code directories like 
src/
, 
app/
, 
lib/
, 
server/
, 
packages/
, etc., no manifest files like 
package.json
/
*.sln
/
go.mod
, no populated 
project-config.json
), this skill switches to greenfield mode automatically. Planning artifacts (docs/, plans/, .claude/) don't count — the project must have actual code directories with content.
When greenfield is detected:
  1. ALWAYS route to 
    /plan-hard
     — greenfield planning requires deep research, never fast plans
  2. Skip "MUST READ project-structure-reference.md" step (file won't exist or is placeholder)
  3. Enable web research for tech landscape analysis (WebSearch + WebFetch)
  4. Delegate architecture decisions to 
    solution-architect
    agent
  5. Increase user interview frequency (AskUserQuestion at each major decision)
  6. If 
    /greenfield
    workflow is not already active, suggest it via AskUserQuestion:
    • "Activate Greenfield Project Init workflow (Recommended)" — full waterfall inception
    • "Continue with standalone /plan-hard" — planning only, no full workflow
Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).
自动检测： 如果未发现现有代码库（无
src/
、
app/
、
lib/
、
server/
、
packages/
等代码目录，无
package.json
/
*.sln
/
go.mod
等清单文件，无已填充的
project-config.json
），此技能将自动切换为全新项目模式。规划产物（docs/、plans/、.claude/）不计入在内——项目必须包含有内容的实际代码目录。
检测到全新项目时：
  1. 必须分流至
    /plan-hard
     —— 全新项目规划需要深度调研，绝不使用快速计划
  2. 跳过"必须阅读project-structure-reference.md"步骤（该文件不存在或为占位符）
  3. 启用技术格局分析的网络调研功能（WebSearch + WebFetch）
  4. 将架构决策委托给
    solution-architect
    Agent
  5. 增加用户访谈频率（在每个重大决策点使用AskUserQuestion）
  6. 如果
    /greenfield
    工作流尚未激活，通过AskUserQuestion工具建议用户：
    • "激活Greenfield项目初始化工作流（推荐）" —— 完整的瀑布式启动流程
    • "继续使用独立的/plan-hard" —— 仅规划，不使用完整工作流
保持质疑，运用批判性思维和顺序思维。每一个结论都需要可追溯的依据，置信度需超过80%。

Variant Decision Guide

变体决策指南

If the task is...UseWhy
Simple, clear scope (<5 files)
/plan-fast
Lightweight plan, faster output
Complex, multi-layer, many files
/plan-hard
Deep research, comprehensive plan
CI/CD pipeline changes
/plan-ci
CI-specific context and validation
Cross-cutting refactor
/plan-cro
Cross-service impact analysis
Parallel implementation possible
/plan-parallel
Splits plan into parallelizable phases
Two competing approaches
/plan-two
Creates 2 plans for comparison
Analyzing existing plan
/plan-analysis
Reviews/critiques an existing plan
Archiving completed plan
/plan-archive
Moves plan to archive
General/unknown
/plan
(this skill)		Routes automatically
如果任务是...使用方案原因
简单、范围明确（<5个文件）
/plan-fast
轻量级计划，输出更快
复杂、多层级、涉及多文件
/plan-hard
深度调研，全面规划
CI/CD流水线变更
/plan-ci
CI专属上下文与验证
跨领域重构
/plan-cro
跨服务影响分析
可并行实施
/plan-parallel
将计划拆分为可并行的阶段
存在两种竞争方案
/plan-two
创建两个计划用于对比
分析现有计划
/plan-analysis
评审/批判现有计划
归档已完成计划
/plan-archive
将计划移至归档
通用/未知类型
/plan
（本技能）		自动分流

PLANNING-ONLY — Collaboration Required

仅负责规划 — 需协作

DO NOT use the 
EnterPlanMode
tool — you are ALREADY in a planning workflow. DO NOT implement or execute any code changes. COLLABORATE with the user: ask decision questions, present options with recommendations. After plan creation, ALWAYS use 
AskUserQuestion
tool to offer 
/plan-review
validation. ASK user to confirm the plan before any next step.
禁止 使用
EnterPlanMode
工具 —— 您已处于规划工作流中。 禁止 执行任何代码变更或开发工作。 必须 与用户协作：询问决策类问题，提供带建议的选项。 计划创建完成后，必须 使用
AskUserQuestion
工具提供
/plan-review
验证选项。 在进行任何下一步前，必须 询问用户确认计划。

Your mission

您的任务

<task> $ARGUMENTS </task>
<task> $ARGUMENTS </task>

Pre-Creation Check (Active vs Suggested Plan Detection)

创建前检查（活跃计划与建议计划检测）

Check the 
## Plan Context
section in the injected context:
  • If "Plan:" shows a path → Active plan exists. Ask user: "Active plan found: {path}. Continue with this? [Y/n]"
  • If "Suggested:" shows a path → Branch-matched plan hint only. Ask user if they want to activate it or create new.
  • If "Plan: none" → Proceed to create new plan using naming pattern from 
    ## Naming
    section.
检查注入上下文中的
## Plan Context
部分：
  • 如果显示"Plan: 路径" → 存在活跃计划。询问用户："检测到活跃计划：{path}。是否继续使用该计划？[是/否]"
  • 如果显示"Suggested: 路径" → 仅为分支匹配的计划提示。询问用户是否激活该计划或创建新计划。
  • 如果显示"Plan: none" → 按照
    ## Naming
    部分的命名规则创建新计划。

Workflow

工作流

  • Analyze the given task and use 
    AskUserQuestion
    tool to ask for more details if needed.
  • Decide to use 
    /plan-fast
    or 
    /plan-hard
    SlashCommands based on the complexity.
  • Execute SlashCommand: 
    /plan-fast <detailed-instructions-prompt>
    or 
    /plan-hard <detailed-instructions-prompt>
  • Activate 
    planning
    skill.
  • Note: 
    detailed-instructions-prompt
    is an enhanced prompt that describes the task in detail based on the provided task description.
  • 分析给定任务，若需更多细节，使用
    AskUserQuestion
    工具询问用户。
  • 根据复杂度决定使用
    /plan-fast
    或
    /plan-hard
    斜杠命令。
  • 执行斜杠命令：
    /plan-fast <详细指令提示词>
    或 
    /plan-hard <详细指令提示词>
  • 激活
    planning
    技能。
  • 注意：
    详细指令提示词
    是经过优化的提示词，基于提供的任务描述详细说明任务内容。

IMPORTANT Task Planning Notes (MUST FOLLOW)

重要的任务规划注意事项（必须遵守）

  • Always plan and break work into many small todo tasks using 
    TaskCreate
  • Always add a final review todo task to verify work quality and identify fixes/enhancements
  • MANDATORY FINAL TASKS: After creating all planning todo tasks, ALWAYS add these two final tasks:
    1. Task: "Run /plan-validate" — Trigger 
      /plan-validate
      skill to interview the user with critical questions and validate plan assumptions
    2. Task: "Run /plan-review" — Trigger 
      /plan-review
      skill to auto-review plan for validity, correctness, and best practices
  • 始终使用
    TaskCreate
    规划并将工作拆分为多个待办小任务
  • 始终添加最终的评审待办任务，以验证工作质量并识别需要修复/优化的内容
  • 强制要求的最终任务： 创建所有规划待办任务后，必须添加以下两个最终任务：
    1. 任务："运行/plan-validate" —— 触发
      /plan-validate
      技能，通过关键问题访谈用户并验证计划假设
    2. 任务："运行/plan-review" —— 触发
      /plan-review
      技能，自动评审计划的有效性、正确性与最佳实践

Important Notes

重要说明

IMPORTANT: Analyze the skills catalog and activate the skills that are needed for the task during the process. IMPORTANT: Sacrifice grammar for the sake of concision when writing reports. IMPORTANT: Ensure token efficiency while maintaining high quality. IMPORTANT: In reports, list any unresolved questions at the end, if any.
重要提示： 分析技能目录，在过程中激活任务所需的技能。 重要提示： 撰写报告时，为简洁性可牺牲语法。 重要提示： 在保证高质量的同时，确保令牌使用效率。 重要提示： 在报告末尾列出所有未解决的问题（如有）。

REMINDER — Planning-Only Command

提醒 — 仅规划命令

DO NOT use 
EnterPlanMode
tool. DO NOT start implementing. ALWAYS use 
AskUserQuestion
tool to offer 
/plan-review
validation after plan creation. ASK user to confirm the plan before any implementation begins. ASK user decision questions using 
AskUserQuestion
tool when multiple approaches exist.
禁止 使用
EnterPlanMode
工具。 禁止 开始实施。 计划创建完成后，必须 使用
AskUserQuestion
工具提供
/plan-review
验证选项。 在开始任何实施前，必须 询问用户确认计划。 当存在多种方案时，必须 使用
AskUserQuestion
工具询问用户决策类问题。

Workflow Recommendation

工作流推荐

IMPORTANT MUST: If you are NOT already in a workflow, use 
AskUserQuestion
to ask the user:
  1. Activate 
    pre-development
    workflow     (Recommended) — quality-gate → plan → plan-review → plan-validate
  2. Execute 
    /plan
    directly     — run this skill standalone
必须遵守： 如果您尚未处于任何工作流中，使用
AskUserQuestion
工具询问用户：
  1. 激活
    pre-development
    工作流    （推荐）—— 质量关卡 → 规划 → 计划评审 → 计划验证
  2. 直接执行
    /plan
     —— 独立运行本技能