关于 st-create-plan
st-create-plan 是用于 Strikethroo 的 Agent 技能,可在收集项目背景并澄清关键问题后,将工作要求整理为结构化计划。它遵循项目模板和钩子,并报告计划文件及编号。
主要功能
- 01定位 Strikethroo 项目根目录
- 02读取项目约定和模板
- 03澄清关键缺失信息
- 04分配编号并创建计划
- 05运行计划后置钩子
适用场景
- 01为新的工作要求制定计划
- 02在规划前解决未确认的需求
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ e0ipso/ strikethroo --skill st-create-plan安装后在 Claude Code 中输入/st-create-plan确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
scripts/check-for-updates.cjsfind-strikethroo-root.cjsget-next-plan-id.cjs详细介绍
st-create-plan
输入
用户的请求提供工作单。
操作流程
1. 定位 strikethroo 根目录
从用户的工作目录运行 scripts/find-strikethroo-root.cjs。如果该脚本以非零状态退出,请停止并要求用户运行 npx strikethroo init。
在后续所有步骤中,将脚本输出的路径视为 <root>。
委派的执行工作进程跳过此步骤,且不发出更新通知。
使用此技能的脚本路径,将 scripts/check-for-updates.cjs "<root>" 作为单独的命令运行。保持用户的工作目录不变。读取标准输出中的单行 JSON。如果存在 notice,请保留其原文,以便在面向用户的最终回复中使用。切勿暂停等待许可,也切勿运行更新。
2. 加载项目上下文
读取 <root>/config/STRIKETHROO.md,了解此项目的目录约定。
读取 <root>/config/hooks/PRE_PLAN.md,并在继续之前执行其中的说明。读取 <root>/config/templates/PLAN_TEMPLATE.md;计划必须符合该模板。
还需读取 <root>/config/shared/clarification-gate.md 和
<root>/config/shared/anti-rationalization.md。
3. 分析工作单
确定:
- 目标。
- 范围和明确的边界。
- 成功标准。
- 依赖项、先决条件、阻塞因素。
- 技术要求和约束。
4. 澄清循环
如果缺少任何关键上下文,请向用户提出有针对性的问题。持续循环,直到没有进一步的问题。明确确认是否需要向后兼容性。切勿捏造答案;切勿掩盖缺失的答案。
如果用户拒绝澄清某个阻塞性问题,请停止并报告计划需要澄清。不要生成不完整的计划。
遵循 <root>/config/shared/clarification-gate.md 中的澄清节奏。
将 <root>/config/shared/anti-rationalization.md 中的规则应用于以下合理化表:
| 当你发现自己在想…… | 约束规则 |
|---|---|
| “我可以合理地假定答案。” | 假设不是答案。要提问;切勿捏造答案。 |
| “再问一次很烦人。” | 用户可以拒绝回答问题,这种情况可补救;默默做出错误假设则不可补救。要提问。 |
| “用户已经暗示过,所以事情已经定了。” | 暗示不等于确认。要明确提出该问题并获得明确答复。 |
5. 分配下一个计划 ID
运行 scripts/get-next-plan-id.cjs,获取下一个可用的计划 ID。计算其补零形式作为目录名称({padded-id}--{slug}),并在计划 frontmatter 中使用不补零的整数。
6. 输出计划
将计划写入
<root>/plans/{padded-id}--{slug}/plan-{padded-id}--{slug}.md,并确保 frontmatter 和各章节均符合 <root>/config/templates/PLAN_TEMPLATE.md。
不要包含时间估算、任务列表或代码示例;这些内容属于任务生成步骤。
根据计划摘要生成 <slug>:仅使用小写字母、数字和连字符;合并重复连字符,并去除首尾连字符。
7. 运行计划后置钩子
执行 <root>/config/hooks/POST_PLAN.md。
8. 输出结构化摘要
最后必须使用以下区块(若保留了更新通知,则另行附上):
---
Plan Summary:
- Plan ID: [numeric-id]
- Plan File: [absolute-path-to-plan-file]
下游自动化会读取此摘要;格式必须完全一致。
如果存在保留的更新 notice,请将其原文附在结构化摘要区块之后;若此技能不输出摘要区块,则附在最终回复之后。通知之后不得有任何内容。
失败模式
- 已分配的 ID 对应的计划目录已存在。 重新运行 next-plan-id 脚本并重试一次。如果冲突仍然存在,请停止并报告。