README.md

@@ -34,12 +34,22 @@ generic/
 ├── .agents/plugins/
 │   └── marketplace.json     # Codex marketplace（name: "generic"，url source 指向本 repo）
 ├── plugin.json              # Antigravity 外掛定義（name: "jsc"，skills: "./skills/"）
+├── hooks/
+│   └── hooks.json           # Claude Code hooks（Stop → worklog；其他助理不吃此檔）
+├── scripts/
+│   └── worklog/             # worklog 自動記錄的可執行元件（skill 與 hook 共用）
+│       ├── worklog.sh       # 主流程：抽本輪 → 濃縮 → 遮蔽 → 追加到 wiki
+│       ├── wiki_api.py      # Gitea wiki 讀寫、token 解析、append 重試、週頁命名
+│       └── transcript.py    # transcript 本輪抽取與機密遮蔽
 ├── skills/                  # ★ 唯一真實來源：所有 skills
-│   └── spec-*/SKILL.md      # 共用規範 skills（一規範一目錄）
+│   ├── spec-*/SKILL.md      # 共用規範 skills（一規範一目錄）
+│   └── worklog/SKILL.md     # 工作證明自動記錄的操作與維護
 ├── AGENTS.md                # 跨助理共用指引
 └── README.md
 ```
 
+> generic 的定位是「**共用規範 ＋ 全域自動化**」：`skills/spec-*` 是純規範文件（四家助理通用），`hooks/` 與 `scripts/` 是可執行元件。**`hooks/hooks.json` 只有 Claude Code 會讀**；Codex／Antigravity／OpenCode 匯入時只有 skill 可用，自動記錄不會啟動。
+
 ---
 
 ## 安裝 / 更新 / 移除（各家原生 plugin CLI）
@@ -178,6 +188,12 @@ rm -rf ~/.config/opencode/skills/spec-*
 | `spec-doc-funcs-handoff` | 文件化串接 | code 類 skill 完成後完整執行 /jsc:doc-funcs 的標準流程與統一時間戳 |
 | `spec-plugin-version` | 版號規則 | 三 manifest 同步 bump、對照 master 確保單調遞增、新 plugin 首發 0.0.1、chore(plugin 版本) commit |
 
+### 全域自動化
+
+| Skill | 類型 | 內容 |
+| --- | --- | --- |
+| `worklog` | 工作證明記錄 | 每輪工作濃縮成條目追加到 Gitea wiki 當週頁（`Worklog-yyyy-MM-W<週>`）；`--init`／`--tune`／`--diagnose`／`--append`／`--show` 五個模式；自動記錄由 Claude Code `Stop` hook 完成 |
+
 <!-- JSC-SKILLS:END -->
 
 ---