planning-with-files 任務完成后如何保留和歸檔 task_plan.md 等規劃文件【免費下載鏈接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.項目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files使用 planning-with-files 的 agent 在任務結束后task_plan.md、findings.md、progress.md這些規劃文件并不會自動進入某種已歸檔狀態。如果你的顧慮是下一個任務會不會把這次任務的計劃沖掉、這些文件會不會被 git 忽略掉永遠丟失、還是想把有價值的決策和錯誤記錄沉淀下來這篇內容基于 docs/workflow.md 中After Completion: What Happens to the Plan Files一節的實際說明給出一條從確認任務完成到決定保留方式的可執行路徑。先搞清楚默認行為任務完成后系統什么都不做planning-with-files 的規劃文件被定位為單次任務的工作內存而不是需要長期管理的交付物。文檔明確說明docs/workflow.mdtask_plan.md、findings.md、progress.md以及.planning/slug/目錄默認被 gitignore任務結束時沒有任何自動歸檔動作root 模式下三個文件放在項目根目錄下一個任務會直接覆蓋task_plan.mdslug 模式下./scripts/init-session.sh slug創建的.planning/YYYY-MM-DD-slug/目錄舊目錄只是不再被選為活動計劃目錄本身留在磁盤上不存在自動的 completed 或 archived 狀態check-complete只報告完成狀態不會移動或提取任何文件。這是刻意設計的默認行為不是缺失的功能。所以保留和歸檔這件事需要你在任務真正完成后、下一個任務開始前自己按下面的路徑完成。第一步確認任務確實完成再處理文件保留文件的前提是任務真的做完了。按 docs/quickstart.md 的 Step 5完成判定分兩步檢查task_plan.md所有階段都應有**Status:** complete勾選框為[x]運行完成檢查如果你通過 hooks 使用Stop hook 會自動執行這一步./scripts/check-complete.sh該腳本按$PLAN_ID→.planning/.active_plan→ 最新 mtime 的 slug 目錄 → 根目錄task_plan.md的順序解析目標計劃見 scripts/check-complete.sh 頭部注釋并統計各階段狀態。如果還有in_progress階段說明任務未完成此時先繼續工作確認全部完成后再進入下一步的保留操作。第二步選擇保留方式文檔給出的三條路徑docs/workflow.md 明確列出了三種讓已完成計劃存續的做法按內容價值從高到低說明路徑一把值得留的內容提煉進代碼或文檔推薦的沉淀方式文檔原話是任何想比任務活得更久的東西應該已經放在持久位置——代碼、提交、規格或文檔里。具體操作是把計劃中你認為重要的部分提煉出來把關鍵決策寫入代碼注釋、commit message、ADR 或倉庫docs/下的筆記把task_plan.md的 Errors Encountered 表和findings.md的 Technical Decisions 表中值得復用的條目整理成文檔提交。這一步是純手工的內容整理腳本不提供自動化好處是沉淀下來的是結論而不是過程記錄。路徑二把整個 slug 目錄移出忽略范圍如果你希望完整保留某一任務的三個規劃文件文檔給出兩個操作把.planning/slug/目錄移動到 git 忽略路徑之外例如倉庫內的docs/archive/下或你自己的其他目錄或者在希望跟蹤計劃的倉庫中從.gitignore里移除對.planning/的忽略項。兩種寫法只改你自己的項目配置不影響 planning-with-files 的運行——hooks 解析的是計劃目錄位置而不是 git 狀態。移動目錄后該 slug 就不再是活動計劃不會影響后續任務。路徑三留作個人復用的緩存用 PLAN_ID 或 .active_plan 固定對于這個計劃以后還會用的場景例如同一重構的后續迭代文檔建議直接把目錄留在原處當作緩存用選擇器固定它# POSIX shell在啟動 host 之前用初始化時打印的精確 ID 固定當前終端 export PLAN_IDthe-printed-id # PowerShell 寫法 $env:PLAN_ID the-printed-id或切換到共享指針./scripts/set-active-plan.sh 2026-01-10-backend-refactor需要注意PLAN_ID在 v3.15.0 起是綁定性選擇器——寫錯 ID 時解析直接失敗而不會悄悄回退到根目錄計劃見 README.md 的 v3.15.0 說明。另外set-active-plan.sh修改的是共享指針適合順序切換并發會話應各自用獨立的PLAN_ID在啟動 host 前設置在單個工具子進程里設置不影響已經運行的 host。驗證與限制做完路徑二后用git status或git check-ignore -v 目錄確認目標目錄不再被忽略即視為保留生效路徑三的驗證方式是指定選擇器后運行./scripts/check-complete.sh它報告的應是固定到的那個計劃的狀態而非根計劃。明確的限制完成觸發的自動歸檔步驟把.planning/slug/移入歸檔目錄并提取決策/錯誤表為 git 跟蹤記錄目前并未內置文檔將其描述為一個合理的 opt-in 擴展方向歡迎提 issue 或 PR。在實現之前不要假設任何自動歸檔行為會發生。規劃文件是普通 markdown沒有任何其他運行時狀態歸檔的本質只是決定哪些文件繼續留在磁盤上、哪些內容被提煉進版本庫。完整生命周期說明見 docs/workflow.md任務收尾的完整步驟見 docs/quickstart.md 的 Step 5README 的 FAQ 中What happens to the plan files after a task is complete?一節給出了與上面一致的結論。【免費下載鏈接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.項目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 planning-with-files 任務完成后如何保留和歸檔 task_plan.md 等規劃文件
planning-with-files 任務完成后如何保留和歸檔 task_plan.md 等規劃文件【免費下載鏈接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.項目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files使用 planning-with-files 的 agent 在任務結束后task_plan.md、findings.md、progress.md這些規劃文件并不會自動進入某種已歸檔狀態。如果你的顧慮是下一個任務會不會把這次任務的計劃沖掉、這些文件會不會被 git 忽略掉永遠丟失、還是想把有價值的決策和錯誤記錄沉淀下來這篇內容基于 docs/workflow.md 中After Completion: What Happens to the Plan Files一節的實際說明給出一條從確認任務完成到決定保留方式的可執行路徑。先搞清楚默認行為任務完成后系統什么都不做planning-with-files 的規劃文件被定位為單次任務的工作內存而不是需要長期管理的交付物。文檔明確說明docs/workflow.mdtask_plan.md、findings.md、progress.md以及.planning/slug/目錄默認被 gitignore任務結束時沒有任何自動歸檔動作root 模式下三個文件放在項目根目錄下一個任務會直接覆蓋task_plan.mdslug 模式下./scripts/init-session.sh slug創建的.planning/YYYY-MM-DD-slug/目錄舊目錄只是不再被選為活動計劃目錄本身留在磁盤上不存在自動的 completed 或 archived 狀態check-complete只報告完成狀態不會移動或提取任何文件。這是刻意設計的默認行為不是缺失的功能。所以保留和歸檔這件事需要你在任務真正完成后、下一個任務開始前自己按下面的路徑完成。第一步確認任務確實完成再處理文件保留文件的前提是任務真的做完了。按 docs/quickstart.md 的 Step 5完成判定分兩步檢查task_plan.md所有階段都應有**Status:** complete勾選框為[x]運行完成檢查如果你通過 hooks 使用Stop hook 會自動執行這一步./scripts/check-complete.sh該腳本按$PLAN_ID→.planning/.active_plan→ 最新 mtime 的 slug 目錄 → 根目錄task_plan.md的順序解析目標計劃見 scripts/check-complete.sh 頭部注釋并統計各階段狀態。如果還有in_progress階段說明任務未完成此時先繼續工作確認全部完成后再進入下一步的保留操作。第二步選擇保留方式文檔給出的三條路徑docs/workflow.md 明確列出了三種讓已完成計劃存續的做法按內容價值從高到低說明路徑一把值得留的內容提煉進代碼或文檔推薦的沉淀方式文檔原話是任何想比任務活得更久的東西應該已經放在持久位置——代碼、提交、規格或文檔里。具體操作是把計劃中你認為重要的部分提煉出來把關鍵決策寫入代碼注釋、commit message、ADR 或倉庫docs/下的筆記把task_plan.md的 Errors Encountered 表和findings.md的 Technical Decisions 表中值得復用的條目整理成文檔提交。這一步是純手工的內容整理腳本不提供自動化好處是沉淀下來的是結論而不是過程記錄。路徑二把整個 slug 目錄移出忽略范圍如果你希望完整保留某一任務的三個規劃文件文檔給出兩個操作把.planning/slug/目錄移動到 git 忽略路徑之外例如倉庫內的docs/archive/下或你自己的其他目錄或者在希望跟蹤計劃的倉庫中從.gitignore里移除對.planning/的忽略項。兩種寫法只改你自己的項目配置不影響 planning-with-files 的運行——hooks 解析的是計劃目錄位置而不是 git 狀態。移動目錄后該 slug 就不再是活動計劃不會影響后續任務。路徑三留作個人復用的緩存用 PLAN_ID 或 .active_plan 固定對于這個計劃以后還會用的場景例如同一重構的后續迭代文檔建議直接把目錄留在原處當作緩存用選擇器固定它# POSIX shell在啟動 host 之前用初始化時打印的精確 ID 固定當前終端 export PLAN_IDthe-printed-id # PowerShell 寫法 $env:PLAN_ID the-printed-id或切換到共享指針./scripts/set-active-plan.sh 2026-01-10-backend-refactor需要注意PLAN_ID在 v3.15.0 起是綁定性選擇器——寫錯 ID 時解析直接失敗而不會悄悄回退到根目錄計劃見 README.md 的 v3.15.0 說明。另外set-active-plan.sh修改的是共享指針適合順序切換并發會話應各自用獨立的PLAN_ID在啟動 host 前設置在單個工具子進程里設置不影響已經運行的 host。驗證與限制做完路徑二后用git status或git check-ignore -v 目錄確認目標目錄不再被忽略即視為保留生效路徑三的驗證方式是指定選擇器后運行./scripts/check-complete.sh它報告的應是固定到的那個計劃的狀態而非根計劃。明確的限制完成觸發的自動歸檔步驟把.planning/slug/移入歸檔目錄并提取決策/錯誤表為 git 跟蹤記錄目前并未內置文檔將其描述為一個合理的 opt-in 擴展方向歡迎提 issue 或 PR。在實現之前不要假設任何自動歸檔行為會發生。規劃文件是普通 markdown沒有任何其他運行時狀態歸檔的本質只是決定哪些文件繼續留在磁盤上、哪些內容被提煉進版本庫。完整生命周期說明見 docs/workflow.md任務收尾的完整步驟見 docs/quickstart.md 的 Step 5README 的 FAQ 中What happens to the plan files after a task is complete?一節給出了與上面一致的結論。【免費下載鏈接】planning-with-filesPersistent file-based planning for AI coding agents and long-running tasks. Crash-proof markdown plans, session recovery after /clear and compaction, per-turn re-injection against context rot, deterministic completion gate. Manus-style. Install from npm, the Claude Code plugin marketplace, or npx skills. Codex, Cursor, OpenCode, 60 agents.項目地址: https://gitcode.com/GitHub_Trending/pl/planning-with-files創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考