create-plan
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseCreate Plan
创建计划
Turn an approved structure outline and its evidence into the final
implementation contract. This skill writes the plan; it does not implement it.
将已批准的结构大纲及其证据转化为最终实现契约。此 skill 负责编写计划,而不负责实施。
Steps
步骤
1. Establish the evidence set
1. 确定证据集
Read artifact-inputs.md before locating or
reading task artifacts. Resolve one task directory, inventory every eligible
artifact in it, and read every eligible artifact to completion. Apply the
precedence rules to every conflict and record any unresolved decision that
prevents an implementation-ready plan.
If the task directory cannot be identified, ask the user for the artifact path
and stop. If a material decision remains unresolved after reading the evidence,
ask the smallest question that resolves it and stop.
Complete when: exactly one task directory is known; every eligible artifact
has been fully read; every excluded artifact is accounted for; and every
conflict is either resolved by precedence or surfaced as a blocking question.
在定位或读取任务工件之前,先阅读 artifact-inputs.md。确定唯一一个任务目录,清点其中每个符合条件的工件,并完整读取每个符合条件的工件。对每处冲突应用优先级规则,并记录任何妨碍形成可直接实施计划的未决决策。
如果无法确定任务目录,请向用户询问工件路径并停止。如果阅读证据后仍有实质性决策未解决,请提出能够解决该问题的最小问题并停止。
完成条件: 已确定唯一一个任务目录;每个符合条件的工件均已完整读取;每个被排除的工件都有明确说明;每处冲突均已通过优先级规则解决,或已作为阻塞问题提出。
2. Verify implementation facts in the repository
2. 在仓库中验证实现事实
Inspect the source, configuration, schema, migration, and test files named by
the artifacts. Follow their imports and local conventions far enough to validate
every file path, symbol, integration boundary, code example, test location, and
proposed verification command the plan will rely on. Resolve repository-relative
locations from the repository root.
When an artifact and the current repository disagree, treat the repository as
the authority for current mechanics while preserving the latest approved product
and design intent. State the discrepancy in the plan instead of silently copying
stale details.
Complete when: every planned change is anchored to verified repository
evidence, every example matches the current language and local patterns, every
affected testing surface has been checked, and no command in the plan is an
unverified guess.
检查工件中指定的源代码、配置、schema、migration 和测试文件。沿 imports 追踪并遵循本地约定,直至足以验证计划将依赖的每个文件路径、符号、集成边界、代码示例、测试位置和拟议验证命令。相对于仓库的位置均以仓库根目录为基准解析。
当工件与当前仓库不一致时,应以仓库作为当前实现机制的权威依据,同时保留最新批准的产品和设计意图。应在计划中说明该差异,而不是直接复制过期细节。
完成条件: 每项计划变更均以已验证的仓库证据为依据;每个示例均与当前编程语言和本地模式一致;每个受影响的测试范围均已检查;计划中没有任何未经验证、仅凭猜测给出的命令。
3. Refine the phase contract
3. 细化阶段契约
Use the approved structure outline as the phase backbone. Expand each phase into
an independently verifiable vertical slice. A phase may depend on completed
earlier phases; it must not require a later phase to build, run, or verify its
promised behavior. Preserve approved ordering and scope unless repository
evidence proves a change is necessary, in which case explain the adjustment in
the plan.
For every phase, identify all implementation units, tests, automated checks, any
genuinely human-only validation, and the human confirmation gate before the next
phase. Include test changes whenever the evidence reveals an established test
pattern for the affected behavior.
Complete when: every approved requirement and every structure-outline phase
maps to exactly one or more plan items; each phase has an observable end state
and can be verified before the next begins; and no requirement, dependency, or
test surface is left unmapped.
使用已批准的结构大纲作为阶段主干。将每个阶段扩展为可独立验证的垂直切片。某一阶段可以依赖已完成的较早阶段;但不得要求后续阶段才能构建、运行或验证其承诺的行为。除非仓库证据证明必须进行调整,否则应保留已批准的顺序和范围;如需调整,应在计划中说明原因。
针对每个阶段,确定所有实现单元、测试、自动化检查、确实只能由人工完成的验证,以及进入下一阶段前的人工确认关卡。只要证据显示受影响行为已有既定测试模式,就应纳入测试变更。
完成条件: 每项已批准需求和结构大纲中的每个阶段都恰好映射到一个或多个计划项;每个阶段都有可观察的最终状态,并可在下一阶段开始前完成验证;没有需求、依赖关系或测试范围被遗漏。
4. Write the indexed plan artifact
4. 编写带索引的计划工件
Read plan_template.md in full and follow its
content contract. List the resolved task directory with , extract every
leading numeric document index, and choose one greater than the highest value.
Render it with at least two digits; use when there is no indexed artifact.
Write the result as:
ls -La01text
.agent-work/tasks/<task-slug>/NN-plan-<two-to-four-word-slug>.mdPopulate repository, branch, and commit metadata from the current checkout.
Replace every instructional placeholder; optional sections are either completed
or removed. When a code example itself contains Markdown fences, use a
four-backtick outer fence.
Complete when: the artifact exists at the next chronological path; its
frontmatter and every required section satisfy the template; every phase
contains concrete, ordered changes and checkable verification; and no template
marker or unsupported claim remains.
完整阅读 plan_template.md,并遵循其内容契约。使用 列出已确定的任务目录,提取每个文档开头的数字索引,并选择一个大于最高值的数字。至少渲染为两位数字;如果不存在带索引的工件,则使用 。将结果写入:
ls -La01text
.agent-work/tasks/<task-slug>/NN-plan-<two-to-four-word-slug>.md从当前 checkout 中填充 repository、branch 和 commit 元数据。替换所有说明性占位符;可选章节要么填写完整,要么删除。如果代码示例本身包含 Markdown 围栏,则使用四个反引号作为外层围栏。
完成条件: 工件存在于按编号顺序确定的下一个路径;其 frontmatter 和每个必需章节均满足模板要求;每个阶段都包含具体、有序的变更和可检查的验证;不存在任何模板标记或缺乏依据的主张。
5. Audit the plan as an implementation handoff
5. 将计划作为实现交接进行审计
Read the artifact from disk after writing it. Check every path, symbol, phase
number, cross-reference, code fence, command, checklist, and phase gate against
the evidence collected in Steps 1–3. Confirm the plan's scope exclusions and
desired end state agree with the approved artifacts.
Complete when: every phase and requirement passes the audit, all Markdown
fences are balanced, all artifact-local references resolve, all automated checks
are runnable as written, and every manual check requires human observation
rather than automation.
写入后从磁盘读取该工件。根据步骤 1–3 收集的证据,检查每个路径、符号、阶段编号、交叉引用、代码围栏、命令、检查清单和阶段关卡。确认计划的范围排除项和预期最终状态与已批准工件一致。
完成条件: 每个阶段和需求均通过审计;所有 Markdown 围栏均成对闭合;所有工件内引用均可解析;所有自动化检查均可按原样运行;每项手动检查都需要人工观察,而非自动化执行。
6. Route the handoff
6. 路由交接
Read handoff-routing.md and execute exactly one
of its workspace branches. Then read the selected final-answer template and
substitute every placeholder. Return only that rendered template.
Complete when: workspace state and effective configuration select one
unambiguous branch; any required task branch is checked out safely; the artifact
location is rendered with a host-provided permalink when available; and the response
contains the selected template with no extra summary or commentary.
阅读 handoff-routing.md,并严格执行其中唯一一个 workspace 分支。然后读取选定的 final-answer 模板,替换其中每个占位符。仅返回渲染后的模板。
完成条件: workspace 状态和生效配置共同选定一个明确无歧义的分支;任何必要的 task branch 均已安全检出;可用时,工件位置使用 host 提供的 permalink 呈现;响应仅包含选定模板,不附加任何额外摘要或评论。