feat(doc-funcs): 新增用途日期同區塊與輸出訊息格式兩條規則 #21

2026-06-30T03:07:37Z

jiantw83 commented

2026-06-30 03:07:37 +00:00

變更摘要

為 doc-funcs skill 新增兩條規則：

用途與更新日期同區塊：指令檔草稿開頭的「用途」與「更新日期」必須包在同一個註解區塊內，不得拆成兩個分開的註解區塊。
輸出訊息格式：若 function 有輸出訊息（log／console／回傳提示），格式統一為 [{階段(英文名稱)?}][{等級:INF/WRN/ERR/TRC/DBG}][{時間}]: {訊息}；階段選填、等級限五種、時間用 Asia/Taipei 時區。

影響範圍

skills/doc-funcs/SKILL.md
- 第 3-2 步（指令檔草稿）：用途與更新日期改為必須同區塊。
- 第 6 步（依選擇實作草稿）：新增輸出訊息格式規範。
- 「重要限制」段落：同步補上兩條約束的精簡版。

重點與注意事項

兩條規則皆加上「不得藉此改變實際行為／邏輯」的保險語，與既有「文件化不得變更 runtime 行為」原則一致。
純文件／規則調整，無程式邏輯變更。

## 變更摘要為 `doc-funcs` skill 新增兩條規則： 1. **用途與更新日期同區塊**：指令檔草稿開頭的「用途」與「更新日期」必須包在同一個註解區塊內，不得拆成兩個分開的註解區塊。 2. **輸出訊息格式**：若 function 有輸出訊息（log／console／回傳提示），格式統一為 `[{階段(英文名稱)?}][{等級:INF/WRN/ERR/TRC/DBG}][{時間}]: {訊息}`；階段選填、等級限五種、時間用 Asia/Taipei 時區。 ## 影響範圍 - `skills/doc-funcs/SKILL.md` - 第 3-2 步（指令檔草稿）：用途與更新日期改為必須同區塊。 - 第 6 步（依選擇實作草稿）：新增輸出訊息格式規範。 - 「重要限制」段落：同步補上兩條約束的精簡版。 ## 重點與注意事項 - 兩條規則皆加上「不得藉此改變實際行為／邏輯」的保險語，與既有「文件化不得變更 runtime 行為」原則一致。 - 純文件／規則調整，無程式邏輯變更。

jiantw83 added 1 commit 2026-06-30 03:07:38 +00:00

feat(doc-funcs): 新增用途日期同區塊與輸出訊息格式兩條規則 a78654f98f

admin approved these changes 2026-06-30 03:10:00 +00:00

admin merged commit d8d11bdc62 into master

2026-06-30 03:10:02 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/doc#21