feat(hooks): SessionStart 注入 AGENTS.md 操作規則；README 安裝說明補齊五家助理 #12

2026-07-31T08:35:44Z

jiantw83 commented

2026-07-31 08:35:44 +00:00

這個 PR 做什麼

兩件事：讓人格的 AGENTS.md 在開機時被讀進來，以及把 README 的安裝說明補成與其他四個 plugin 一致的結構。

1. SessionStart 注入 `AGENTS.md`（`opsBrief`）

新增 pl.opsBrief(slug)：把該人格的 AGENTS.md 全文包成 <persona-ops> 區塊，由 SessionStart hook 在「接續人格」與「預設人格自動載入」兩條分支各注入一次。

刻意不進 turnContext：操作規則是低頻的「怎麼做事」，每輪重貼只是燒 context。
超過 OPS_BRIEF_MAX_CHARS（6000）截斷並指路回原檔；檔案不存在回空字串。
動機是讓「這個人格自己的工具箱」可以寫在 AGENTS.md 裡跟著人格走（它本來就在 sync 的 wiki 白名單內），不必落在機器本機的 ~/.claude/agents。

selftest 補 5 條：全文注入、指路原檔、不進 turnContext、檔案不存在回空、超長截斷。全套 345 項通過。

2. README 結構同步

安裝章節原本 Antigravity 缺移除、OpenCode 缺更新與移除、GitHub Copilot CLI 整節不存在。改為五家各自都有安裝／更新／移除三段，與 code／doc／generic／template 一致。

另補「前綴與呼叫方式」與「目錄結構」兩節（其他四個 plugin 都有，只有這裡缺），跨助理支援度表加上 Copilot，headless 一次性執行獨立成節。

明確標註 marketplace 名是 jsc-plugins 而非 repo 名 persona，安裝 token 為 jsc-persona@jsc-plugins。

版本

依 spec-plugin-version，三家 manifest 一起升到 0.0.9（master 現行 0.0.8）。

## 這個 PR 做什麼兩件事：讓人格的 `AGENTS.md` 在開機時被讀進來，以及把 README 的安裝說明補成與其他四個 plugin 一致的結構。 ## 1. SessionStart 注入 `AGENTS.md`（`opsBrief`）新增 `pl.opsBrief(slug)`：把該人格的 `AGENTS.md` 全文包成 `<persona-ops>` 區塊，由 `SessionStart` hook 在「接續人格」與「預設人格自動載入」兩條分支各注入一次。 - **刻意不進 `turnContext`**：操作規則是低頻的「怎麼做事」，每輪重貼只是燒 context。 - 超過 `OPS_BRIEF_MAX_CHARS`（6000）截斷並指路回原檔；檔案不存在回空字串。 - 動機是讓「這個人格自己的工具箱」可以寫在 `AGENTS.md` 裡**跟著人格走**（它本來就在 sync 的 wiki 白名單內），不必落在機器本機的 `~/.claude/agents`。 selftest 補 5 條：全文注入、指路原檔、不進 `turnContext`、檔案不存在回空、超長截斷。**全套 345 項通過**。 ## 2. README 結構同步安裝章節原本 Antigravity 缺移除、OpenCode 缺更新與移除、GitHub Copilot CLI 整節不存在。改為五家各自都有安裝／更新／移除三段，與 code／doc／generic／template 一致。另補「前綴與呼叫方式」與「目錄結構」兩節（其他四個 plugin 都有，只有這裡缺），跨助理支援度表加上 Copilot，headless 一次性執行獨立成節。明確標註 marketplace 名是 `jsc-plugins` 而非 repo 名 `persona`，安裝 token 為 `jsc-persona@jsc-plugins`。 ## 版本依 `spec-plugin-version`，三家 manifest 一起升到 **0.0.9**（master 現行 0.0.8）。

jiantw83 added 2 commits 2026-07-31 08:35:44 +00:00

feat(hooks): SessionStart 注入人格的 AGENTS.md 操作規則 721fc0ece8

新增 pl.opsBrief(slug)：把該人格的 AGENTS.md 全文包成 <persona-ops> 區塊，
由 SessionStart hook 在「接續人格」與「預設人格自動載入」兩條分支各注入一次。

刻意不放進 turnContext——操作規則是低頻的「怎麼做事」，每輪重貼只是燒 context。
超過 OPS_BRIEF_MAX_CHARS（6000）會截斷並指路回原檔；檔案不存在時回空字串。

這讓「這個人格自己的工具箱」可以寫在 AGENTS.md 裡跟著人格走（AGENTS.md 本來
就在 sync 的 wiki 白名單內），不必落在機器本機的 ~/.claude/agents。

selftest 補 5 條：全文注入、指路原檔、不進 turnContext、檔案不存在回空、
超長截斷。全套 345 項通過。

docs(README): 安裝說明補齊五家助理並統一結構 828c14b6ba

安裝章節原本只有 Claude Code 與 Codex 較完整，Antigravity 缺移除、
OpenCode 缺更新與移除、GitHub Copilot CLI 整節不存在。改為與 code／doc／
generic／template 相同的結構：五家各自都有安裝、更新、移除三段。

另補「前綴與呼叫方式」與「目錄結構」兩節（其他四個 plugin 都有，只有這裡缺），
跨助理支援度表加上 GitHub Copilot CLI，並把 headless 一次性執行獨立成節。

明確標註本 plugin 的 marketplace 名是 jsc-plugins 而非 repo 名 persona，
安裝 token 為 jsc-persona@jsc-plugins，避免照 repo 名去猜。

依 spec-plugin-version 把三家 manifest 版號一起升到 0.0.9（master 現行 0.0.8）。

admin approved these changes 2026-07-31 08:37:28 +00:00

admin merged commit 9e7a9cf8e2 into master

2026-07-31 08:37:31 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/persona#12

feat(hooks): SessionStart 注入 AGENTS.md 操作規則；README 安裝說明補齊五家助理 #12

這個 PR 做什麼

1. SessionStart 注入 AGENTS.md（opsBrief）

2. README 結構同步

版本

1. SessionStart 注入 `AGENTS.md`（`opsBrief`）