Spaces:
Sleeping
Sleeping
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 |
-
-
|
| 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.
|
| 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` 記錄變更 +
|
| 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 |
-
-
|
| 27 |
-
-
|
| 28 |
-
-
|
|
|
|
| 29 |
|
| 30 |
### 3. 生成交付報告
|
| 31 |
|
|
@@ -41,7 +42,8 @@
|
|
| 41 |
|
| 42 |
## 守則
|
| 43 |
|
| 44 |
-
- **自動執行更新**:自動更新 `changelog.md`
|
| 45 |
-
- **保留 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 |
- **交付完成**:提示本次迭代已交付,可開始新的迭代週期
|