feat(doc-funcs): 區塊階段命名擴及指令檔並改沿用原始區塊名稱 #24

2026-06-30T09:54:14Z

jiantw83 commented

2026-06-30 09:54:14 +00:00

變更摘要

調整 doc-funcs skill 的輸出訊息格式規則，讓「區塊階段命名／一行一則訊息」不再只適用於 function 原始碼，也適用於指令檔（shell／CI 腳本），並改為沿用區塊原始名稱（保留原文、不再轉英文）。

重點變更（skills/doc-funcs/SKILL.md）

適用對象擴大：輸出訊息格式規則由「僅 function」擴及「function 與指令檔」。
階段名稱改沿用原文：階段 前綴由原本「轉為英文名稱」改為「沿用所屬區塊原始名稱、保留原文不翻譯」（中文區塊即用中文）。
辨識指令檔橫幅為具名區塊：將「分隔線＋標題＋分隔線」橫幅段落視為具名區塊，標題作為該段每行訊息的 階段 前綴，並移除印出橫幅的輸出指令。
保留檔案標頭：明確排除開頭「用途／更新日期」標頭，不得被移除或轉成階段前綴。
指令檔邏輯限制例外：在「不得變更指令邏輯」下開放唯一例外——第 6 步的輸出格式正規化，但不得改變訊息反映的實際行為。
同步更新「重要限制」段落的對應摘要。

影響範圍

僅異動 skills/doc-funcs/SKILL.md（規則文件），不影響其他 skill 或程式行為。

注意事項

此 PR 不含 plugin 版本 bump；如需發佈可後續另開 chore(plugin 版本) commit。

## 變更摘要調整 `doc-funcs` skill 的輸出訊息格式規則，讓「區塊階段命名／一行一則訊息」不再只適用於 function 原始碼，也適用於指令檔（shell／CI 腳本），並改為沿用區塊原始名稱（保留原文、不再轉英文）。 ## 重點變更（skills/doc-funcs/SKILL.md） - **適用對象擴大**：輸出訊息格式規則由「僅 function」擴及「function 與指令檔」。 - **階段名稱改沿用原文**：`階段` 前綴由原本「轉為英文名稱」改為「沿用所屬區塊原始名稱、保留原文不翻譯」（中文區塊即用中文）。 - **辨識指令檔橫幅為具名區塊**：將「分隔線＋標題＋分隔線」橫幅段落視為具名區塊，標題作為該段每行訊息的 `階段` 前綴，並移除印出橫幅的輸出指令。 - **保留檔案標頭**：明確排除開頭「用途／更新日期」標頭，不得被移除或轉成階段前綴。 - **指令檔邏輯限制例外**：在「不得變更指令邏輯」下開放唯一例外——第 6 步的輸出格式正規化，但不得改變訊息反映的實際行為。 - 同步更新「重要限制」段落的對應摘要。 ## 影響範圍 - 僅異動 `skills/doc-funcs/SKILL.md`（規則文件），不影響其他 skill 或程式行為。 ## 注意事項 - 此 PR 不含 plugin 版本 bump；如需發佈可後續另開 `chore(plugin 版本)` commit。

jiantw83 added 1 commit 2026-06-30 09:54:14 +00:00

feat(doc-funcs): 區塊階段命名擴及指令檔並改沿用原始區塊名稱 9a2e849c99

admin approved these changes 2026-06-30 09:56:41 +00:00

admin merged commit f8d02d228c into master

2026-06-30 09:56:44 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/doc#24