From 5d5101795ca7fdec85ed9c2e23784dd3dbde8e4c Mon Sep 17 00:00:00 2001 From: Jeffery Date: Mon, 27 Jul 2026 11:20:15 +0800 Subject: [PATCH] =?UTF-8?q?docs(README):=20=E8=A3=9C=E4=B8=8A=20worklog=20?= =?UTF-8?q?=E5=85=83=E4=BB=B6=E3=80=81=E7=9B=AE=E9=8C=84=E7=B5=90=E6=A7=8B?= =?UTF-8?q?=E8=88=87=20generic=20=E5=AE=9A=E4=BD=8D=E8=AA=AA=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 (1M context) --- README.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 92f38e2..6e95eb1 100644 --- a/README.md +++ b/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 完成 | + ---