doc-funcs 排版依原本方式維持原樣，僅修正有誤處 #33

2026-07-16T02:46:21Z

jiantw83 commented

2026-07-16 02:46:21 +00:00

變更摘要

調整 doc-funcs 技能的排版政策：被文件化原始碼的排版依照檔案原本的排版方式維持原樣，只有排版確實有誤時才修正該處；不再套用格式化慣例重排。並同步 plugin 版本至 0.1.9。

重點內容

修改：`skills/doc-funcs/SKILL.md`

第 7 步（核心改動）：標題改為「保守優化效能並僅修正有誤的排版」。排版規則由原本的「套用該語言/專案既有格式化慣例（縮排、括號風格、import/using 排序）」反轉為：
- 預設維持檔案原本的排版方式，不重排。
- 只有排版確實有誤才修正，明確列舉：縮排錯亂或與同檔明顯不一致、tab／空白混用造成語法或建置錯誤、括號／區塊對齊錯誤造成誤讀、編碼或行尾字元異常。
- 修正僅限有誤之處並比照該檔既有慣例；不得順手重排其他正確區塊、不得對全檔套用 formatter、不得引入新排版風格（含 import/using 重新排序）。
- 驗證方式同步調整為建置/測試/語法檢查，不得以套用全檔 formatter 作為驗證方式（原文的「執行格式化驗證」與新規則矛盾，一併修正）。
重要限制：新增對應守則，與第 7 步一致。
開頭總述與 frontmatter description：同步改為「效能保守優化（排版依原本方式維持原樣，僅修正有誤處）」。

版本

plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本 0.1.8 → 0.1.9。

影響範圍與風險

僅影響 doc-funcs 技能第 7 步的排版行為；效能優化規則不變，其他技能不受影響。
行為變得更保守：文件化後的原始碼排版不再被 formatter 重排，降低無關 diff 與風格衝突的風險。
repo README 與 plugin.json 描述原本就未提及排版優化細節，無需同步。

Commits

feat(doc-funcs skill): 排版依檔案原本方式維持原樣，僅修正有誤處
chore(plugin 版本): bump 至 0.1.9

## 變更摘要調整 `doc-funcs` 技能的排版政策：被文件化原始碼的排版**依照檔案原本的排版方式維持原樣**，只有排版確實有誤時才修正該處；不再套用格式化慣例重排。並同步 plugin 版本至 0.1.9。 ## 重點內容 ### 修改：`skills/doc-funcs/SKILL.md` - **第 7 步（核心改動）**：標題改為「保守優化效能並僅修正有誤的排版」。排版規則由原本的「套用該語言/專案既有格式化慣例（縮排、括號風格、import/using 排序）」反轉為： - 預設維持檔案原本的排版方式，不重排。 - 只有排版確實有誤才修正，明確列舉：縮排錯亂或與同檔明顯不一致、tab／空白混用造成語法或建置錯誤、括號／區塊對齊錯誤造成誤讀、編碼或行尾字元異常。 - 修正僅限有誤之處並比照該檔既有慣例；不得順手重排其他正確區塊、不得對全檔套用 formatter、不得引入新排版風格（含 import/using 重新排序）。 - 驗證方式同步調整為建置/測試/語法檢查，不得以套用全檔 formatter 作為驗證方式（原文的「執行格式化驗證」與新規則矛盾，一併修正）。 - **重要限制**：新增對應守則，與第 7 步一致。 - **開頭總述與 frontmatter description**：同步改為「效能保守優化（排版依原本方式維持原樣，僅修正有誤處）」。 ### 版本 - `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 版本 0.1.8 → 0.1.9。 ## 影響範圍與風險 - 僅影響 `doc-funcs` 技能第 7 步的排版行為；效能優化規則不變，其他技能不受影響。 - 行為變得更保守：文件化後的原始碼排版不再被 formatter 重排，降低無關 diff 與風格衝突的風險。 - repo README 與 plugin.json 描述原本就未提及排版優化細節，無需同步。 ## Commits - feat(doc-funcs skill): 排版依檔案原本方式維持原樣，僅修正有誤處 - chore(plugin 版本): bump 至 0.1.9

jiantw83 added 2 commits 2026-07-16 02:46:21 +00:00

feat(doc-funcs skill): 排版依檔案原本方式維持原樣，僅修正有誤處 58b9c04e52

chore(plugin 版本): bump 至 0.1.9 eb0e84981a

admin approved these changes 2026-07-16 02:49:12 +00:00

admin merged commit e0df42c10f into master

2026-07-16 02:49:15 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/doc#33