doc-funcs 新增指令檔「用途／更新時間」標頭範本並同步文件與版本 #30

2026-07-15T10:28:42Z

jiantw83 commented

2026-07-15 10:28:42 +00:00

變更摘要

為 doc-funcs 技能新增指令檔開頭「用途／更新時間」標頭的正式範本檔，並讓技能流程與 README 一併參考，最後同步 bump plugin 版本。

重點內容

新增：`skills/doc-funcs/templates/command-header.md`

定義指令檔草稿開頭必備的註解區塊格式，「用途」與「更新時間」必須包在同一個註解區塊內。
佔位符規範：{用途說明}（一到三行）、{更新時間}（Asia/Taipei、yyyy/MM/dd HH:mm:ss，附取得時間的指令）。
兩種變體：# 註解（sh／bash／ps1／Makefile／yaml／Dockerfile／docker-compose）與 :: 註解（bat／cmd，REM 亦可），各附填入後範例。
放置規則：shebang／@echo off 之後、yaml --- 之前、外框分隔線成對、標籤與順序固定。

修改：`skills/doc-funcs/SKILL.md`（3 處參考範本）

第 3-2 步：指令檔草稿標頭必須依範本產生，且派 subagent 時要把範本內容一併提供。
第 4 步：草稿品質檢查改為檢查「標頭符合範本」。
重要限制：明訂標頭格式依範本。

修改：`README.md`

目錄樹加上 doc-funcs/templates/ 一層。
doc-funcs 說明段補上「指令檔草稿標頭固定依範本產生」。

版本

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

影響範圍與風險

僅影響 doc-funcs 技能的指令檔草稿產生行為（標頭格式標準化），不影響其他技能。
安裝流程為 cp -r skills/* 整資料夾複製，範本檔會隨技能一併安裝，無需額外處理。

Commits

feat(doc-funcs skill): 新增指令檔開頭「用途／更新時間」標頭範本並讓草稿流程參考
docs(README): 補上 doc-funcs 指令檔標頭範本說明與目錄樹 templates 層
chore(plugin 版本): bump 至 0.1.5

## 變更摘要為 `doc-funcs` 技能新增指令檔開頭「用途／更新時間」標頭的正式範本檔，並讓技能流程與 README 一併參考，最後同步 bump plugin 版本。 ## 重點內容 ### 新增：`skills/doc-funcs/templates/command-header.md` - 定義指令檔草稿開頭必備的註解區塊格式，「用途」與「更新時間」必須包在同一個註解區塊內。 - 佔位符規範：`{用途說明}`（一到三行）、`{更新時間}`（Asia/Taipei、`yyyy/MM/dd HH:mm:ss`，附取得時間的指令）。 - 兩種變體：`#` 註解（sh／bash／ps1／Makefile／yaml／Dockerfile／docker-compose）與 `::` 註解（bat／cmd，`REM` 亦可），各附填入後範例。 - 放置規則：shebang／`@echo off` 之後、yaml `---` 之前、外框分隔線成對、標籤與順序固定。 ### 修改：`skills/doc-funcs/SKILL.md`（3 處參考範本） - 第 3-2 步：指令檔草稿標頭必須依範本產生，且派 subagent 時要把範本內容一併提供。 - 第 4 步：草稿品質檢查改為檢查「標頭符合範本」。 - 重要限制：明訂標頭格式依範本。 ### 修改：`README.md` - 目錄樹加上 `doc-funcs/templates/` 一層。 - `doc-funcs` 說明段補上「指令檔草稿標頭固定依範本產生」。 ### 版本 - `plugin.json`、`.claude-plugin/plugin.json`、`.codex-plugin/plugin.json` 版本 0.1.4 → 0.1.5。 ## 影響範圍與風險 - 僅影響 `doc-funcs` 技能的指令檔草稿產生行為（標頭格式標準化），不影響其他技能。 - 安裝流程為 `cp -r skills/*` 整資料夾複製，範本檔會隨技能一併安裝，無需額外處理。 ## Commits - feat(doc-funcs skill): 新增指令檔開頭「用途／更新時間」標頭範本並讓草稿流程參考 - docs(README): 補上 doc-funcs 指令檔標頭範本說明與目錄樹 templates 層 - chore(plugin 版本): bump 至 0.1.5

jiantw83 added 3 commits 2026-07-15 10:28:42 +00:00

feat(doc-funcs skill): 新增指令檔開頭「用途／更新時間」標頭範本並讓草稿流程參考 5d60170228

docs(README): 補上 doc-funcs 指令檔標頭範本說明與目錄樹 templates 層 6a273c4feb

chore(plugin 版本): bump 至 0.1.5 0790e300b4

admin approved these changes 2026-07-15 10:32:02 +00:00

admin merged commit 6ea9daea31 into master

2026-07-15 10:32:05 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/doc#30