用途
create-plan 用于把关于某个任务已知的信息,转化为一份可供人工逐行审阅的实施计划文件。计划存放在任务目录中,评论写入文件本身,因此审阅历史随计划保留,并能跨新会话存续。
主要能力
- 生成固定布局的计划文件:路径、文件名、front matter、评论块以及“完成”信号,布局定义在 references/artifact-layout.md 中。
- 只有 scripts/artifact.mjs 会写入 front matter。
- 计划正文按 references/plan-template.md 编写,每个阶段可独立测试,标明其改动的文件,并以可运行的自动化检查结尾。
- 支持读取任务目录中已有的全部工件(按 NN 顺序),包括研究、早期计划及其评论块。
使用方式
- 找到任务目录。如果未提供任务名则询问(kebab-case,每个分支、issue 或 lane 一个)。列出已有内容:
node "${CLAUDE_SKILL_DIR}/scripts/artifact.mjs" status --task-dir .ork/tasks/<task>
-
按 NN 顺序完整读取其中的每个工件:研究、早期计划及其评论块。早期工件上未解决的评论视为需求。
-
阅读研究所指向的代码。计划中改动的每个文件都必须打开,以确保计划中的文件路径和代码真实。
-
使用 references/plan-template.md 将正文写入临时文件。
-
通过脚本创建工件(切勿直接写文件):
node "${CLAUDE_SKILL_DIR}/scripts/artifact.mjs" create \
--task <task> --kind plan --slug <slug> --title "<title>" --author <your seat> --body /tmp/plan-body.md
# prints .ork/tasks/<task>/NN-plan-<slug>.md
- 回复路径并停止。请审阅者在文件中评论(或在其评论后运行 /ork:review-artifact-comments)。不要开始实施。
规则
- 当文档不一致时,以最新者为准:计划优先于研究,研究优先于原始需求。
- “超出范围”是一个章节,而非事后补充:列出计划不会做的事情。
- 仅在确实需要人工查看的地方使用手动检查;不要用它们填充阶段。
- 同一任务的第二份计划是新工件(新的 NN),而不是对旧计划的编辑。修订同一计划应使用 iterate-plan。
相关技能
- /ork:iterate-plan:根据审阅评论修订此计划,保留每条评论。
- /ork:create-research:此计划应首先阅读的研究工件。
- /ork:review-artifact-comments:读取、回答并解决任何工件上的评论。
限制
资料未提供关于收费、价格、平台支持范围或具体效果的信息。