chore(shared): rename repo root and drop role
This commit is contained in:
@@ -35,22 +35,16 @@ shared/
|
||||
├── .agents/plugins/
|
||||
│ └── marketplace.json # Codex marketplace（name: "shared"，url source 指向本 repo）
|
||||
├── plugin.json # Antigravity 外掛定義（name: "jsc-shared"，skills: "./skills/"）
|
||||
├── hooks/
|
||||
│ └── hooks.json # hook 定義（SessionStart 載入角色並提示問候、UserPromptSubmit 點名載入切換角色、Stop 記錄記憶、SessionEnd 釋放角色鎖）
|
||||
├── scripts/
|
||||
│ └── role/ # role skill 的可執行元件（腳本一律不放進 skills/）
|
||||
├── skills/ # ★ 唯一真實來源：所有 skills
|
||||
│ ├── spec-*/SKILL.md # 共用規範 skills（一規範一目錄）
|
||||
│ ├── plugins-install/ # 一次安裝／更新 jsc-code、jsc-doc、jsc-persona
|
||||
│ ├── plugins-uninstall/ # 一次移除 jsc-code、jsc-doc、jsc-persona、jsc-shared
|
||||
│ └── role/SKILL.md # 角色人格與長期記憶
|
||||
│ └── plugins-uninstall/ # 一次移除 jsc-code、jsc-doc、jsc-persona、jsc-shared
|
||||
├── AGENTS.md # 跨助理共用指引
|
||||
└── README.md
|
||||
```
|
||||
|
||||
> shared 的定位是「**共用規範**」：`skills/spec-*` 是 code／doc plugins 共用的流程與安全規範。工作紀錄自動化 `worklog` 已移到 `doc` plugin。
|
||||
> 例外有兩類：`role` 是跨助理共用的**角色與記憶**能力，帶 `hooks/` 與 `scripts/`，適用範圍見下方「元件對各助理的適用範圍」；
|
||||
> `plugins-install`／`plugins-uninstall` 是**整組 plugin 的安裝管理**，一次處理所有 JSC plugin，不必逐個 repo 翻 README。
|
||||
> 例外只有 `plugins-install`／`plugins-uninstall` 兩類：它們是**整組 plugin 的安裝管理**，一次處理所有 JSC plugin，不必逐個 repo 翻 README。
|
||||
|
||||
---
|
||||
|
||||
@@ -225,34 +219,21 @@ copilot plugin marketplace remove shared
|
||||
|
||||
> `plugins-install` 與 `plugins-uninstall` 都會處理 `jsc-shared`；移除時一定放最後一步。
|
||||
|
||||
### 角色與記憶
|
||||
|
||||
| Skill | 用途 | 使用方法 |
|
||||
| --- | --- | --- |
|
||||
| `role` | 讓 CLI 以固定角色（name／nature／vibe／簽名 emoji）回覆，並把每輪對話累積成長期記憶：啟動時依字元預算載入高價值記憶，Stop hook 先本地過濾低價值回合以節省額度，睡眠時段（預設 22:00–06:00）由 NREM 鞏固與 REM 整合兩階段整理、去重、標籤化、建立關聯，並標記 semantic／episodic／procedural／emotional／preference／rule 與 explicit／implicit 後壓縮歸檔；新建角色時可只給角色名稱，必要時詢問來源／作品並推斷四欄描述，也可匯出角色定義、資產與記憶壓縮檔；角色檔名與記憶目錄使用英文大寫 ID | `/jsc-shared:role --new` 建立或更新角色、`--use <角色 ID>` 切換、`--list` 查角色與 ID、`--export <路徑>` 匯出角色、`--sleep` 立即整理、`--status` 診斷、`--install-cron` 安裝排程；對話中直接以名字點名（「西莉卡，…」／「@SILICA01 …」）可即時換角色 |
|
||||
|
||||
`role` 的自動路徑由 hook 與 cron 完成，**建立角色後重開工作階段即生效**；非睡眠時段載入角色後，角色會在本工作階段第一則回覆開頭主動簡短問候一次。載入方式參考 OpenClaw 的分層概念：從角色檔抽出人格作為 `SOUL`，由 hook 產生固定操作邊界作為 `AGENTS`，再把同意狀態與高價值記憶作為 `USER/MEMORY` 注入，避免整份人格檔污染工程規則。感覺記憶不落檔，`inbox/` 作為工作記憶，睡眠整理後才進長期記憶；個人記憶保存同意狀態寫在 `~/.memory/<角色 ID>/state.json`，同意後不會每次重問。角色檔、記憶目錄、`.active` 與 `ROLE_NAME` 一律使用角色 ID（例如 `ENGINEER01`），`--list` 可查每個顯示名稱對應的 ID。沒有建立過角色的人完全不受影響（`~/.roles/.active` 不存在時 hook 立即結束）。同一個終端要臨時換角色不必改設定或重開 CLI：訊息開頭以名字點名即可由該角色接手（`UserPromptSubmit` hook），本階段之後的對話會記進被點名角色的記憶；真的要同時跟兩個角色對話則各開一個終端並設不同的 `ROLE_NAME`。細節見 `skills/role/SKILL.md`。
|
||||
|
||||
<!-- JSC-SKILLS:END -->
|
||||
|
||||
---
|
||||
|
||||
## 元件對各助理的適用範圍
|
||||
|
||||
`skills/` 各助理都能用；`hooks/` 與 `scripts/` 則否。
|
||||
`skills/` 各助理都能用。
|
||||
|
||||
| 元件 | Claude Code | Codex | Antigravity | OpenCode | GitHub Copilot |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| `skills/spec-*`（純規範） | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| `skills/plugins-install`、`plugins-uninstall` | ✅ | ✅ | ✅ | ⚠️ 只能操作 OpenCode 自己 | ✅ |
|
||||
| `skills/role` 的手動模式 | ✅ | ⚠️ 需保留 `scripts/` | ⚠️ 同左 | ❌ 只複製 `skills/` | ⚠️ 同左 |
|
||||
| `hooks/hooks.json`：`SessionStart` 載入角色 | ✅ | ⚠️ 需該版本支援 | ❌ | ❌ | ❌ |
|
||||
| `hooks/hooks.json`：`UserPromptSubmit` 點名載入 | ✅ | ⚠️ 需該版本支援 | ❌ | ❌ | ❌ |
|
||||
| `hooks/hooks.json`：`Stop` 記錄記憶 | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||||
| `hooks/hooks.json`：`SessionEnd` 釋放角色鎖 | ✅ | ⚠️ 需該版本支援 | ❌ | ❌ | ❌ |
|
||||
| cron 睡眠整理（系統排程） | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
|
||||
> **OpenCode 以複製 `skills/` 目錄安裝**，不會帶入 `scripts/` 與 `hooks/`，凡依賴腳本的 skill 一律不可用。
|
||||
> **OpenCode 以複製 `skills/` 目錄安裝**。
|
||||
|
||||
---
|
||||
|
||||
@@ -272,9 +253,4 @@ copilot plugin marketplace remove shared
|
||||
- OpenCode：重新從 Gitea 遠端抓取到暫存目錄後再複製 `skills/`
|
||||
- Copilot：`copilot plugin marketplace update shared && copilot plugin update jsc-shared@shared`
|
||||
|
||||
> **skill 帶可執行元件時**（腳本、hook）額外注意：
|
||||
>
|
||||
> - 腳本放 `scripts/<skill-name>/`，**不要**放進 `skills/`；hook 定義放 `hooks/hooks.json`，command 用 `${CLAUDE_PLUGIN_ROOT}/...` 絕對路徑。
|
||||
> - 腳本要有執行權限並確實入 git（`git ls-files -s` 應顯示 `100755`）。
|
||||
> - `SKILL.md` **不可用相對路徑呼叫腳本** —— skill 執行時的工作目錄是使用者的專案目錄；請以 `${CLAUDE_PLUGIN_ROOT}`（其他助理用 skill base directory 往上兩層）組出絕對路徑。
|
||||
> - 在 `SKILL.md` 的 `description` 與上方適用範圍表標明支援哪幾家；OpenCode 因只複製 `skills/`，凡依賴 `scripts/` 的 skill 一律不支援。
|
||||
> 本 repo 只放純 `SKILL.md` 內容，不含可執行腳本或 hook。
|
||||
|
||||
Reference in New Issue
Block a user