doc-funcs 加入 Dockerfile 與 README 檔名依專案命名慣例正規化規則 #31

2026-07-16T01:06:49Z

jiantw83 commented

2026-07-16 01:06:49 +00:00

變更摘要

為 doc-funcs 技能加入「Dockerfile 與 README 檔名依專案內多數檔案的大小寫命名慣例正規化」規則，並同步 README 說明與 plugin 版本。

重點內容

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

第 0 步（新增判斷邏輯）：掃描時統計專案檔名大小寫風格（全大寫／首字大寫／全小寫），優先以同類型檔案為樣本（README 看其他 *.md、Dockerfile 看其他容器/建置檔），同類樣本不足 3 個才改看全專案分布；只有某風格明顯過半才視為「專案多數慣例」，判斷結果記錄在 .docs/doc-funcs-index.md。
第 6 步（Dockerfile 檔名正規化）：覆蓋 Dockerfile 草稿時，檔名與多數慣例不符就用 git mv 調整（大小寫不敏感檔案系統用兩段式改名），並同步更新所有引用（docker-compose 的 dockerfile:、CI build 參數、文件連結），確保建置行為不變。
第 8 步（README 檔名）：重建 README 時檔名依慣例決定（多數全大寫→README.md、多數全小寫→readme.md）；無明顯多數則沿用既有檔名，無既有 README 才預設 README.md，且不得同時留下兩種大小寫版本。
重要限制：明訂只有慣例明顯過半才執行改名，改名必須同步更新引用、不得造成建置或連結失效。
frontmatter description：補上檔名正規化行為，維持跨助理自動觸發依據的完整性。

修改：`README.md`

doc-funcs 說明段補上檔名正規化規則。

版本

plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本 0.1.5 → 0.1.6。

影響範圍與風險

僅影響 doc-funcs 技能對目標專案的 Dockerfile 與 README 檔名處理；其他技能不受影響。
保守邊界：慣例五五波或樣本太少時一律不改名，避免在慣例不明的專案中改壞建置或連結。

Commits

feat(doc-funcs skill): Dockerfile 與 README 檔名依專案多數命名慣例正規化並同步更新引用
docs(README): 補上 doc-funcs 檔名正規化規則說明
chore(plugin 版本): bump 至 0.1.6

## 變更摘要為 `doc-funcs` 技能加入「`Dockerfile` 與 README 檔名依專案內多數檔案的大小寫命名慣例正規化」規則，並同步 README 說明與 plugin 版本。 ## 重點內容 ### 修改：`skills/doc-funcs/SKILL.md` - **第 0 步（新增判斷邏輯）**：掃描時統計專案檔名大小寫風格（全大寫／首字大寫／全小寫），優先以同類型檔案為樣本（README 看其他 `*.md`、Dockerfile 看其他容器/建置檔），同類樣本不足 3 個才改看全專案分布；只有某風格明顯過半才視為「專案多數慣例」，判斷結果記錄在 `.docs/doc-funcs-index.md`。 - **第 6 步（Dockerfile 檔名正規化）**：覆蓋 Dockerfile 草稿時，檔名與多數慣例不符就用 `git mv` 調整（大小寫不敏感檔案系統用兩段式改名），並同步更新所有引用（docker-compose 的 `dockerfile:`、CI build 參數、文件連結），確保建置行為不變。 - **第 8 步（README 檔名）**：重建 README 時檔名依慣例決定（多數全大寫→`README.md`、多數全小寫→`readme.md`）；無明顯多數則沿用既有檔名，無既有 README 才預設 `README.md`，且不得同時留下兩種大小寫版本。 - **重要限制**：明訂只有慣例明顯過半才執行改名，改名必須同步更新引用、不得造成建置或連結失效。 - **frontmatter `description`**：補上檔名正規化行為，維持跨助理自動觸發依據的完整性。 ### 修改：`README.md` - `doc-funcs` 說明段補上檔名正規化規則。 ### 版本 - `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 版本 0.1.5 → 0.1.6。 ## 影響範圍與風險 - 僅影響 `doc-funcs` 技能對目標專案的 `Dockerfile` 與 README 檔名處理；其他技能不受影響。 - 保守邊界：慣例五五波或樣本太少時一律不改名，避免在慣例不明的專案中改壞建置或連結。 ## Commits - feat(doc-funcs skill): Dockerfile 與 README 檔名依專案多數命名慣例正規化並同步更新引用 - docs(README): 補上 doc-funcs 檔名正規化規則說明 - chore(plugin 版本): bump 至 0.1.6

jiantw83 added 3 commits 2026-07-16 01:06:49 +00:00

feat(doc-funcs skill): Dockerfile 與 README 檔名依專案多數命名慣例正規化並同步更新引用 b43e0c87ec

docs(README): 補上 doc-funcs 檔名正規化規則說明 d1c83ac026

chore(plugin 版本): bump 至 0.1.6 d81d58bc17

admin approved these changes 2026-07-16 01:07:59 +00:00

admin merged commit d048b2d9de into master

2026-07-16 01:08:03 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/doc#31