用途
st-refine-plan 用于在 Strikethroo 仓库中,根据用户提供的数字计划 ID,对已有计划进行审查、改进、质询、压力测试或更新。用户以对话方式提供计划 ID,并可附带可选的改进说明。
主要能力
- 定位 strikethroo 根目录并检查更新。
- 解析指定计划 ID 对应的计划文件路径。
- 加载项目上下文,包括目录约定、前置计划钩子、计划模板和澄清门控规则。
- 对计划进行端到端基线审查,从上下文缺口、技术缺口、风险缺口和范围问题四个角度记录矛盾与缺口,每条记录为 {section, issue, severity, proposed fix}。
- 通过澄清循环解决缺口,支持交互式澄清和自主式澄清两种模式。
- 就地改进计划,保持计划 ID 和目录不变,确保符合计划模板,更新执行摘要、架构部分、图表和风险缓解措施,裁剪非必需的范围蔓延,并追加变更日志。
- 运行后置计划钩子。
使用方式
- 用户以对话方式提供数字计划 ID 和可选的改进说明。
- 技能从用户工作目录运行 scripts/find-strikethroo-root.cjs 定位根目录;若失败则提示用户运行 npx strikethroo init。
- 运行 scripts/check-for-updates.cjs "<root>" 检查更新,读取 stdout 中的一行 JSON,保留通知文本用于最终回复。
- 运行 scripts/validate-plan-blueprint.cjs <plan-id> planFile 解析计划文件绝对路径;若失败则请用户确认计划 ID。
- 读取项目配置、前置钩子、计划模板和澄清门控文件。
- 进行基线审查并记录缺口。
- 进入澄清循环:默认交互式,逐条提问并等待用户回答;仅当用户明确要求自主模式或上游编排器声明自主运行时才使用自主澄清。
- 就地改进计划,保持身份与结构合规,更新内容并追加变更日志。
- 运行后置计划钩子,并在结构化摘要块后追加保留的更新通知。
适用场景
适用于需要审查、改进、质询、压力测试或更新 Strikethroo 计划的场景,尤其是当计划存在上下文、技术、风险或范围方面的缺口时。
限制
- 需要用户提供数字计划 ID。
- 依赖 Strikethroo 仓库的目录结构和脚本。
- 交互式澄清会暂停执行并等待用户输入,不会模拟用户响应。
- 自主澄清仅在用户明确要求或上游编排器声明时启用。
- 无法解决的缺口会记录为未解决并附缓解说明。
- 辅助脚本意外失败时,会显示 stderr 并停止,不会回退到手动路径发现。