会话重置后接着做迁移
把数据库迁移拆成盘点、演练和上线。在文件中保存最后一次验证的数据快照，以及第一个尚未检查的步骤。新会话可以从演练接着做，同时知道上线仍需批准。
Planning with Files Skill
把计划、发现和验证依据分别写入项目文件，让新的会话可以接着推进多阶段开发任务。
为需要跨会话的任务准备交接文件
选一项无法在一个会话内完成的工作，分清阶段计划、来源记录和验证日志，确保接手的人能找到明确的下一步。
带入 Floatboat 的请求
请求可预览和复制，不会从此处自动发送。
参考来源: Planning with Files https://github.com/OthmanAdi/planning-with-files/blob/master/skills/planning-with-files/SKILL.md 先阅读原始说明并核对当前环境与依赖。需要安装或连接新工具时，先提出方案。 我的任务: 用 Planning with Files 跟踪一次分阶段数据库迁移。把阶段和下一步写进 task_plan.md，把来源发现放进 findings.md，把检查结果写进 progress.md。先做只读盘点，变更数据库前等我确认。 期望交付: 一份三文件规划提纲，以及验证新会话能否接手的检查步骤。
Planning with Files 如何保留任务状态
工作流将任务信息分在三个文件里。task_plan.md 记录目标、阶段状态和下一步，findings.md 保存调研发现与来源，progress.md 记录实际执行过的工作、失败情况和检查结果。项目已有计划时，Skill 要求先读取它，再按阶段更新。 新会话可以直接读取这些文件，再从已记录的状态继续。自动注入和会话恢复依赖宿主及启用的钩子。读取本机的 Agent 会话记录属于需要明确启用的独立追赶流程。
Planning with Files 的使用场景
任务跨会话或需要交接时，文件里的状态可以作为继续工作的起点。保留接下来要做的决定、已经尝试的方法，以及对应当前版本的证据。
对比调研时单独保存发现
先用一句话写明要做的决定，再把来源、日期和互相冲突的说法记到 findings.md。将选定的比较标准和下一步留在计划里，避免网页内容混入项目指令。
交接只验证了一部分的发布任务
在 progress.md 中写清提交版本、已经通过的检查和未解决的阻塞。接手的人可以复现缺失的检查，也知道哪些结论只对应上一次运行。
同一仓库同时跟踪两份计划
为互相独立的工作创建命名计划目录，在宿主支持时将每个会话绑定到对应计划。更新阶段前先确认当前计划，避免将另一项任务误标为已完成。
如何使用 Planning with Files
先选一个项目和可以验收的目标。每个阶段结束时更新下一步，再用新会话检验能否从文件恢复。需要自动恢复时，还要确认对应宿主的钩子确实启用。
安装 Skill 并确认项目范围
在兼容宿主中使用上游安装方式。进入目标项目目录，再明确要求 Agent 针对这项任务使用 Planning with Files。
创建或恢复三份计划文件
已有计划时先读取。将目标、阶段和一个明确的下一步写入计划，将来源笔记和实际验证分别放进对应文件。
用新会话验证交接
让新会话读项目文件并复述待办动作。需要自动恢复时，再按宿主的上游指南检查钩子是否有效。
探索更多 Agent Skills
查看其他 Skill 指南，并在使用前核对原始来源。
Planning with Files 常见问题
三份 Markdown 文件各存什么？
task_plan.md 保存目标、阶段和下一步，findings.md 保存调研与参考资料，progress.md 记录执行过程和测试依据。
新会话启动时会自动加载计划吗？
取决于宿主和安装方式。Claude Code 插件有启动钩子，独立 Skill 的钩子则在该 Skill 被调用后才注册。
安装 Skill 会同时安装斜杠命令吗？
上游 Skills CLI 安装的是 Skill 包。宿主专属的命令和生命周期钩子需要按所选插件或配置方式单独核对。
自动恢复会读取 Agent 聊天记录吗？
自动恢复读取项目计划文件。读取同一项目的本机会话记录需要显式选择对应选项，并区分统计和有限回放模式。
同一个工作目录里的两个 Agent 能用不同计划吗？
上游支持命名计划目录，兼容宿主可以将会话固定到指定计划。并行前确认绑定，或为各任务使用独立工作树。
完成钩子能证明测试通过吗？
默认停止检查只提供提示，可选的强制检查依赖宿主、计划状态和对应依据。关闭任务前仍应核对实际的测试输出。