用途:把当前功能在项目根目录的三个活跃规划文件(task_plan.md、findings.md、progress.md)归档到一个带时间戳的本地目录 .plannings/<yyyyMMdd-HHmmss>-<feature-slug>/,替代已弃用的 Codex 提示工作流,改用确定性脚本执行。
主要能力:要求三个根文件全部存在后才执行;任一缺失即停止,打印所有缺失文件,不创建 .plannings/,不移动任何内容。支持传入功能名作为归档 slug;未提供时按顺序推断:task_plan.md 中匹配 # 任务计划:xxx 或 # 任务计划: xxx 的首行、task_plan.md 中 ## 目标 下首个有效内容行、findings.md 中 ## 需求 下首个有效内容行、当前项目根目录名。成功后移动三个文件,不复制、不保留根目录副本;操作仅限这三个文件,不归档嵌套规划文件或无关笔记。
使用方式:在项目根目录运行 python "<skill-dir>/scripts/archive_planning.py" "$ARGUMENTS";若 $ARGUMENTS 为空则省略参数,即 python "<skill-dir>/scripts/archive_planning.py"。其中 <skill-dir> 是技能加载时公布的基础目录,需替换为字面路径,不是环境变量;脚本自行定位,只需该路径可解析。脚本将当前工作目录视为项目根目录。
输出:成功时打印归档目录与已移动文件列表;失败时打印缺失文件并给出无操作保证。
限制:仅处理上述三个根级文件;不处理嵌套规划文件或无关笔记;缺少任一文件时不执行任何操作。其他细节暂未提供。