JefferyandClaude Opus 5
67106b22c3
- 五份 manifest 的 name 由 jsc 改為 jsc-doc - skill 目錄去掉重複的 doc- 前綴共 5 個（doc-funcs → funcs 等），worklog 名稱不變，frontmatter name 同步 - hooks/hooks.json 由合併超集改為只註冊 Stop（worklog）：role 的 hook 交還 jsc-generic，避免改名後重複執行 - hook 腳本搜尋路徑與文件內 cache 路徑改指 jsc-doc - 指令引用改為 /jsc-doc: 前綴；跨 plugin 引用指向 /jsc-code:、/jsc-generic: - 保留 .docs/doc-funcs-index.md 等產物檔名不變（非 skill 識別名） - 版號 0.2.6 → 0.2.7 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2.6 KiB
2.6 KiB
指令檔開頭「用途／更新時間」標頭範本
本範本定義 funcs 第 3-2 步指令檔草稿開頭必備的註解區塊格式。「用途」與「更新時間」必須包在同一個註解區塊內，不得拆成兩個分開的區塊；此標頭屬於檔案說明標頭（含外框分隔線），實作與後續輸出訊息格式正規化時必須原樣保留，不得移除或轉成 階段 前綴。
佔位符
-
{用途說明}：一到三行，說明這份指令檔做什麼、在什麼情境被呼叫、重要副作用；多行時每行開頭都要有註解符號。 -
{更新時間}：台灣時區（Asia/Taipei），固定格式yyyy/MM/dd HH:mm:ss，可用下列指令取得：TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'
變體 A：# 註解（*.sh、*.bash、*.ps1、Makefile、yaml、Dockerfile、docker-compose）
# ============================================================================
# 用途：{用途說明}
# 更新時間：{更新時間}
# ============================================================================
填入後範例：
#!/usr/bin/env bash
# ============================================================================
# 用途：打包 Web 專案並上傳部署壓縮檔至部署主機，供 CI 部署階段呼叫。
# 更新時間：2026/07/15 14:30:00
# ============================================================================
變體 B：:: 註解（*.bat、*.cmd）
:: ===========================================================================
:: 用途：{用途說明}
:: 更新時間：{更新時間}
:: ===========================================================================
填入後範例：
@echo off
:: ===========================================================================
:: 用途：清理建置輸出目錄並重新建置方案，供本機開發快速重建使用。
:: 更新時間：2026/07/15 14:30:00
:: ===========================================================================
（改用 REM 亦可，但同一份檔案內擇一使用並保持一致。）
放置規則
- 標頭放在檔案最前面；若第一行是必須位於首行的宣告（例如 shebang
#!...、@echo off），標頭緊接在其後。 - yaml 檔若有 document marker（
---），#標頭放在---之前即可。 - 外框分隔線長度不強制，但上下外框必須成對出現，且整個標頭（含外框）視為同一個註解區塊。
- 「用途」與「更新時間」兩行的中文標籤與順序依本範本，不得只留其中一項。