jiantw83andClaude Opus 5
821261ad9d
What：更新 README、AGENTS.md、templates 與 references，讓文件敘述與實際行為一致。 Why：稽核發現多處文件與程式行為分歧，違反「每個意義只有單一真實來源」。 How：以實際程式行為為準改寫敘述，重複的規則收成單一來源並以一行指引指過去。 Who：jsc-meta:skill-check 例行稽核（2026-08-25）。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
84 lines
2.6 KiB
Markdown
84 lines
2.6 KiB
Markdown
# 交付：{計畫名稱} {WP-nn} {工作包名稱}
|
||
|
||
> {ANALYZE 頁絕對網址} 由 `jsc-gitea/tools/gitea.sh wiki-url` 取得。跨頁型連結一律用絕對網址。
|
||
|
||
- 頁名：`DELIVER_{HASH}`
|
||
- HASH：`{HASH}`
|
||
- 對應分析：[ANALYZE_{HASH}]({ANALYZE 頁絕對網址})
|
||
- 存取庫：`{owner}/{repo}`
|
||
- 來源分支（＝PR 目標）：`origin/{來源分支}`
|
||
- 工作證：`TICKET_{yyyyMMdd}_{HHmmss}_{HASH}`
|
||
- 交付工作包：是 <!-- 是 | 否 -->
|
||
- 交付型別：API 文件 <!-- API 文件 | 由使用者輸入：{說明} -->
|
||
- 交付時間：{yyyy-MM-dd HH:mm:ss}
|
||
|
||
## 交付內容
|
||
|
||
| 項目 | 說明 |
|
||
| --- | --- |
|
||
| 這次交付什麼 | {一句話講清楚接手者拿到什麼} |
|
||
| 接手者需要做什麼 | {下一步動作；沒有就寫「無」} |
|
||
| 尚未交付的部分 | {留在候補的實作工作包，或寫「無」} |
|
||
|
||
## API 文件
|
||
|
||
<!-- 交付型別為「由使用者輸入」時，本節改成使用者指定的內容，不套下面的格式。 -->
|
||
|
||
### {方法} {端點路徑}
|
||
|
||
- 端點狀態：本次新增 <!-- 本次新增 | 既有端點 -->
|
||
- 說明：{這個端點做什麼}
|
||
|
||
標示規則：🆕 **新增**、⚠️ **變更**、❌ **移除**（含淘汰時程）、既有參數留空。
|
||
資料來源：`真實：{source}` 或 `推論：無來源`。範例只留格式，個資不留值。
|
||
|
||
#### 輸入參數（全部）
|
||
|
||
| 參數 | 位置 | 型別 | 必填 | 範例 | 資料來源 | 狀態 |
|
||
| --- | --- | --- | --- | --- | --- | --- |
|
||
| {name} | path／query／header／body | {型別} | 是、否 | {值} | 真實：{source} | 🆕 **新增** |
|
||
|
||
#### 輸出參數（全部）
|
||
|
||
| 參數 | 型別 | 說明 | 範例 | 資料來源 | 狀態 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| {name} | {型別} | {說明} | {值} | 真實：{source} | |
|
||
|
||
#### 錯誤回應
|
||
|
||
| 狀態碼 | 條件 | 回應結構 |
|
||
| --- | --- | --- |
|
||
| {400} | {條件} | {結構} |
|
||
|
||
#### 新舊差異
|
||
|
||
<!-- 既有端點必附；本次新增的端點可省略。diff 區塊會被 Gitea 上色，不要用 HTML style。 -->
|
||
|
||
```diff
|
||
{方法} {端點路徑}
|
||
{既有參數} {型別} {必填}
|
||
+ {新增參數} {型別} {必填} {預設值}（本次新增）
|
||
- {移除參數} {型別} {必填} （本次移除，{日期} 前相容）
|
||
! {變更參數} {型別} {必填} （本次變更：{變更內容}）
|
||
```
|
||
|
||
### 驗收條件
|
||
|
||
- [ ] {可驗證的條件}
|
||
|
||
## 變更檔案
|
||
|
||
| 檔案 | 變更 |
|
||
| --- | --- |
|
||
| `{path}` | {做了什麼} |
|
||
|
||
## 驗證方式
|
||
|
||
| 項目 | 指令或步驟 | 結果 |
|
||
| --- | --- | --- |
|
||
| {測試} | `{指令}` | {通過、失敗} |
|
||
|
||
## 已知限制
|
||
|
||
- {限制或風險；沒有就寫「無」}
|