jimmy60504 commited on
Commit
a2748bb
·
1 Parent(s): 83df282

docs: update copilot instructions to archive temporary files for better historical reference

Browse files
.github/copilot-instructions.md CHANGED
@@ -86,7 +86,7 @@ commit 前確認以下兩點:
86
  - 每次開始新迭代時,在 `spec/plan.md` 討論本次目標、範圍、驗收標準。
87
  - 根據 plan.md 的內容,可在 `spec/task.md` 維護任務拆解(子任務應小而可驗收)。
88
  - 迭代完成後,更新 `changelog.md` 記錄變更摘要。
89
- - 舊的 `plan.md` 和 `task.md` 可拋棄,下次迭代時重新建立。
90
  - **長期的規格變更和決策應同步回對應的 spec 模塊文件**(`00-overview.md` / `01-data-contract.md` / `02-processing-rules.md` / `03-error-handling.md` / `04-extensions.md`),形成累積的設計參考。
91
 
92
  ## 對話時的 Spec 查詢策略
@@ -158,10 +158,10 @@ commit 前確認以下兩點:
158
  4. **暫停並提示使用者**:「程式碼已應用,請進行手動測試」
159
 
160
  ### `/project.report`(交付與清理時用)
161
- - **目的**:記錄變更並清理臨時計畫檔案。
162
  - **流程**:
163
  1. 根據使用者已完成的測試結果,自動更新 `changelog.md`
164
- 2. 清理 `spec/plan.md` 和 `spec/task.md`(下次迭代時重新生成)
165
  3. 生成交付報告(品質狀態、需求對齐等)
166
  4. 提示用戶本次迭代已完成,可開始新迭代
167
 
@@ -175,7 +175,8 @@ commit 前確認以下兩點:
175
  3. 執行 `/project.plan` 生成計畫 → 在 `spec/plan.md` 上編輯 → 確認後執行 `/project.task`
176
  4. 執行 `/project.task` 拆解任務 → 在 `spec/task.md` 上編輯 → 確認後執行 `/project.apply`
177
  5. 執行 `/project.apply` 直接應用程式碼 → 手動測試 → 測試完成後執行 `/project.report`
178
- 6. 執行 `/project.report` 記錄變更 + 自動清理 plan 和 task
179
 
180
  **下次需求改變時:** 回到步驟 1。
 
181
 
 
86
  - 每次開始新迭代時,在 `spec/plan.md` 討論本次目標、範圍、驗收標準。
87
  - 根據 plan.md 的內容,可在 `spec/task.md` 維護任務拆解(子任務應小而可驗收)。
88
  - 迭代完成後,更新 `changelog.md` 記錄變更摘要。
89
+ - 完成後標記 `plan.md` 和 `task.md` 為 `[ARCHIVED]`(保留作為歷史參考),下次迭代時重新生成新版本。
90
  - **長期的規格變更和決策應同步回對應的 spec 模塊文件**(`00-overview.md` / `01-data-contract.md` / `02-processing-rules.md` / `03-error-handling.md` / `04-extensions.md`),形成累積的設計參考。
91
 
92
  ## 對話時的 Spec 查詢策略
 
158
  4. **暫停並提示使用者**:「程式碼已應用,請進行手動測試」
159
 
160
  ### `/project.report`(交付與清理時用)
161
+ - **目的**:記錄變更並歸檔臨時計畫檔案。
162
  - **流程**:
163
  1. 根據使用者已完成的測試結果,自動更新 `changelog.md`
164
+ 2. 標記 `spec/plan.md` 和 `spec/task.md` 為已歸檔(在檔案開頭加入 `[ARCHIVED]` 標記)
165
  3. 生成交付報告(品質狀態、需求對齐等)
166
  4. 提示用戶本次迭代已完成,可開始新迭代
167
 
 
175
  3. 執行 `/project.plan` 生成計畫 → 在 `spec/plan.md` 上編輯 → 確認後執行 `/project.task`
176
  4. 執行 `/project.task` 拆解任務 → 在 `spec/task.md` 上編輯 → 確認後執行 `/project.apply`
177
  5. 執行 `/project.apply` 直接應用程式碼 → 手動測試 → 測試完成後執行 `/project.report`
178
+ 6. 執行 `/project.report` 記錄變更 + 標記 plan 和 task 為 `[ARCHIVED]` → 迭代完成
179
 
180
  **下次需求改變時:** 回到步驟 1。
181
+ **下次迭代開始時:** 執行步驟 3(會在同位置重新生成新的 plan.md 和 task.md)。
182
 
.github/prompts/project.report.prompt.md CHANGED
@@ -21,11 +21,12 @@
21
  - 相關檔案簡稱
22
  ```
23
 
24
- ### 2. 清理臨時檔案
25
 
26
- - 刪除 `spec/plan.md`(已完成的迭代計畫)
27
- - 刪除 `spec/task.md`(已完成的任務拆解)
28
- - 下次迭代時會重新生成
 
29
 
30
  ### 3. 生成交付報告
31
 
@@ -41,7 +42,8 @@
41
 
42
  ## 守則
43
 
44
- - **自動執行更新**:自動更新 `changelog.md` 並清理 plan 和 task 檔案
45
- - **保留 spec.md**:不刪除 `spec/spec.md`(長期規格保留)
46
- - **明確提示**:清楚告知已清理哪些檔案
 
47
  - **交付完成**:提示本次迭代已交付,可開始新的迭代週期
 
21
  - 相關檔案簡稱
22
  ```
23
 
24
+ ### 2. 歸檔臨時檔案
25
 
26
+ - 標記 `spec/plan.md` 為已歸檔(在檔案開頭加入 `[ARCHIVED]` 標記 + 簡要說明)
27
+ - 標記 `spec/task.md` 為已歸檔(在檔案開頭加入 `[ARCHIVED]` 標記 + 執行摘要)
28
+ - 下次迭代時會在同位置重新生成新版本
29
+ - **原因**:保留檔案作為參考記錄,方便後續追蹤迭代歷史;相比刪除對 LLM 限制更少
30
 
31
  ### 3. 生成交付報告
32
 
 
42
 
43
  ## 守則
44
 
45
+ - **自動執行更新**:自動更新 `changelog.md` 並歸檔 plan 和 task 檔案(標記 `[ARCHIVED]`)
46
+ - **保留 spec.md**:不刪除任何規格檔案(`spec/00-*.md` `spec/04-*.md` 和臨時計畫)
47
+ - **明確提示**:清楚告知已歸檔哪些檔案及其位置
48
+ - **參考記錄**:保留歸檔檔案供後續迭代追蹤歷史,無需真正刪除
49
  - **交付完成**:提示本次迭代已交付,可開始新的迭代週期