plugins/pkg
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
32 Commits 6 Branches 0 Tags
ab5494a12811aff4ffea36102d533445fe129cc6
Commit Graph
32 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
jiantw83 ab5494a128 docs(readme): 更新工具表與還原前提說明 
What：工具表補上還原閘門腳本一列與 `--detect` 用法，新增「還原的破壞性前提」一節，改寫結束碼總表與技能摘要。

Why：新腳本沒進工具表，讀 README 的人找不到它，也不知道還原多了一個必要旗標。原本寫「五支工具都靠 python3」也不對——新的閘門腳本只用 git，安裝那支根本不碰 python3，照著讀會誤判環境需求。還原策略已經改成先釘回舊版再重試，摘要卻還停在舊寫法。

How：工具表逐支列出真正需要的指令。新增一節寫清楚 `git clean -fd` 的風險與那五道前提，並說明判定從嚴、動手從窄。結束碼總表改成「一個數字一個類別」，同一個碼在各工具指的對象寫在該列裡。技能摘要改成先把嫌疑套件釘回舊版重試一次，真失敗才還原。

Who：pkg domain 的說明文件。
 2026-08-31 11:09:01 +08:00
jiantw83 1b223bd350 fix(pkg-update): 對齊 stop 的定義與行為，補上釘回舊版的產生路徑 
What：改寫 stop 路由的定義，新增「把嫌疑套件釘回舊版重試一次」的路由，把 git 閘門提到最前面，流程由七步併成五步。

Why：原本寫 stop「不改任何檔案」，但流程走到後段才 stop 時，版本來源檔案已經被改寫過。定義跟行為對不上，使用者會以為工作區沒動過，實際上留了一地改過的檔案沒人回報。另外技能要求「套件停留在舊版時要寫註解說明原因」，卻沒有任何一條路由會產生停留在舊版的結果，這個要求等於永遠踩不到。閘門排在套件盤點後面也不划算，工作區髒的時候，整輪全專案掃描白做。

How：stop 照實描述——第一步之前確實沒動過檔案；第二步起的 stop 要一併報出失敗工具與結束碼、已套用的套件、已改寫的版本來源檔案。建置或測試真的失敗時，先從失敗輸出點名嫌疑套件，把它們釘回舊版，重裝後只重試一次；重試過了就算通過，並標記成停留在舊版，仍失敗才走還原。git 閘門移到第一步的第一個動作，建置與測試指令也在動任何檔案之前先問清楚。

Who：pkg-update 的路由表與流程步驟。
 2026-08-31 11:09:01 +08:00
jiantw83 338c2da89c feat(tools): 新增 git 還原閘門腳本，建置測試加上唯讀偵測模式 
What：新增 `tools/git-guard.sh`，把工作區乾淨檢查與還原序列從技能內文搬進腳本。`tools/build-test.sh` 加上 `--detect` 唯讀模式，只偵測建置與測試指令，不執行。

Why：還原會執行 `git clean -fd`。這個指令刪掉未追蹤的檔案，沒有 reflog 可救，也沒有任何救回的路徑。前提原本只寫在技能內文，讀的人漏掉一行，就可能對著一個根本不該還原的目錄動手，把整個工作區的未追蹤檔案清光。前提要擋得住，就得寫成程式碼。另一件事是「推不出建置與測試指令」，原本要等所有版本來源檔案都改寫完才發現，使用者又答不出指令時，前面全部作廢，還得走一次還原。

How：`revert` 在跑第一個破壞性指令之前擋五道——目錄存在、git 指令存在、確實是 git 工作樹（不是裸存取庫）、呼叫端明確帶 `--confirm-destructive`、目標不是檔案系統根目錄。任何一道不過就直接結束，工作區一個位元組都不動。`check` 的乾淨判定看整個存取庫，`revert` 只作用在專案目錄以下，判定從嚴、動手從窄。`clean` 用 `-fd` 不用 `-fdx`，被 gitignore 的安裝產物要留著。`--detect` 只做偵測與前置檢查，一個檔案都不寫，結束碼與路由跟執行模式完全一致。

Who：套件批次更新的前置檢查與還原路線。
 2026-08-31 11:09:01 +08:00
admin bdacce2f8f Merge pull request 'feat/plugin-dependencies/main' (#11) from feat/plugin-dependencies/main into develop 
Reviewed-on: #11
 2026-08-28 04:05:11 +00:00
admin db2605f36c Merge pull request 'feat/plugin-dependencies/declare-requires' (#10) from feat/plugin-dependencies/declare-requires into feat/plugin-dependencies/main 
Reviewed-on: #10
 2026-08-28 04:03:14 +00:00
jiantw83 88e67e5ebc feat(manifest): 宣告 pkg 技能相依版本 2026-08-28 11:59:16 +08:00
admin ce7d6d48a5 Merge pull request 'feat/comment-scope-rule' (#8) from feat/comment-scope-rule into develop 
Reviewed-on: #8
 2026-08-27 00:56:54 +00:00
jiantw83 913a51796d feat(manifest): 三份 manifest 版本升至 0.0.6 
What：把 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 的 version 由 0.0.5 升為 0.0.6。

Why：pkg-update 技能新增註解界線規則，屬於行為變更，必須發版才會被各 CLI 的外掛版本守衛辨識並更新。

How：三份 manifest 同步改動同一個 version 欄位，其餘欄位不動，維持三份內容一致。

Who：jsc-pkg 外掛的三份 manifest。
 2026-08-26 19:00:37 +08:00
jiantw83 992d9c759c feat(pkg-update): 加入註解界線規則與 README 同步說明 
What：在 pkg-update 技能的步驟 3.5 新增註解界線規則，並在 README.md 的 pkg-update 段落同步同一份指引。

Why：套件更新途中常會為了鎖版本或繞道不相容而留註解，過去沒有界線，容易把文件相關資訊寫進程式碼註解，造成註解與文件重複、且內容很快過期。

How：規則正文留在 jsc-review 的 references/comment-scope.md，這裡只放指引與連結、不重複清單。註解只寫鎖版本或繞道的原因；第三方套件的 issue 連結屬白名單，用來說明繞道成因與解除條件；內部議題編號、工作包編號、人名與 @ 提及、產生來源署名一律不得寫。步驟 3.5 另附可檢核的完成條件，並指向 jsc-hooks 的 comment-scope.sh 即時告警與修正回檢流程。

Who：jsc-pkg 的 pkg-update 技能，以及 README.md 的技能說明區塊。
 2026-08-26 19:00:37 +08:00
admin 4bf662ce0b Merge pull request 'fix/skillset-audit-compliance-and-guard-fixes' (#7) from fix/skillset-audit-compliance-and-guard-fixes into develop 
Reviewed-on: #7
 2026-08-25 07:15:17 +00:00
jiantw83andClaude Opus 5 35d4de6522 chore(pkg): 三份 manifest 同步升版並同步 marketplace 正本 
What：三份 plugin manifest 版本同步 bump，兩份 marketplace 檔與 plugins/meta 正本對齊。

Why：準則要求技能異動必須同步升版；marketplace 副本必須與正本完全一致。

How：以 jsc-meta 的 tools/sync-skill-manifest.sh 升版，marketplace 檔由正本複製。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 bb2e6821c1 docs(pkg): 同步文件與參考資料 
What：更新 README、AGENTS.md、templates 與 references，讓文件敘述與實際行為一致。

Why：稽核發現多處文件與程式行為分歧，違反「每個意義只有單一真實來源」。

How：以實際程式行為為準改寫敘述，重複的規則收成單一來源並以一行指引指過去。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
jiantw83andClaude Opus 5 ea11ca0590 fix(pkg): 補齊稽核缺失並修掉護欄失效 
What：依 jsc-meta:skill-check 的稽核結果修正技能與工具——補上每個步驟的可檢核完成條件、
把留在內文的標準輸入輸出流程下放 tools/、修正查表與退碼路由造成的誤判。

Why：稽核發現這些缺失會讓技能在實際執行時走錯分支或靜默通過。
完成條件缺漏是最常被違反的一項；退碼誤判與查表錯誤則會讓良性狀況被當成失敗。

How：逐項對照 references/guidelines.md 的審核檢查清單修正，新增的工具都有
documented exit codes，並以真實執行驗證每條路徑。

Who：jsc-meta:skill-check 例行稽核（2026-08-25）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
 2026-08-25 14:58:54 +08:00
admin 85b89e4cdc Merge pull request '發佈 jsc-pkg 0.0.3：marketplace 正本移至 plugins/meta' (#6) from develop into master 
Reviewed-on: #6
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 10:19:29 +00:00
admin f1fa06ac32 Merge pull request 'chore(marketplace 正本): 正本移至 plugins/meta（升版 0.0.3）' (#5) from chore/marketplace-canon-to-meta into develop 
Reviewed-on: #5
 2026-08-24 10:13:59 +00:00
jiantw83andClaude Opus 5 bf50821925 chore(plugin 版本): 三份 manifest 升版至 0.0.3 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
jiantw83andClaude Opus 5 3724952cda docs(README): 安裝入口改為 plugins/meta 並補上遷移說明 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-08-24 18:00:35 +08:00
admin ae287e054c Merge pull request '發佈 jsc-pkg 0.0.2：新增套件版本改寫工具' (#4) from develop into master 
Reviewed-on: #4
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 08:27:56 +00:00
admin ef91ebbff4 Merge pull request 'fix/sync-marketplace-and-pkg-version-tool' (#3) from fix/sync-marketplace-and-pkg-version-tool into develop 
Reviewed-on: #3
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-24 07:59:16 +00:00
jiantw83 5ae3611960 feat(pkg-update): 新增版本改寫工具並改用工具呼叫 
What: 新增 tools/apply-version.sh，依 ecosystem 改寫專案的版本來源檔（package.json / requirements.txt / pyproject.toml / *.csproj），把指定套件釘選到指定版本；skills/pkg-update/SKILL.md 的改寫步驟改成呼叫這支工具；README.md 補上工具說明；plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 版本號由 0.0.1 升到 0.0.2。
Why: jsc-meta:skill-check 稽核發現 SKILL.md 用文字描述改寫邏輯，不符合「邏輯放工具、SKILL.md 只放步驟」的準則，需要把改寫邏輯抽成獨立工具。
How: 依 tools/list-packages.sh 已支援的四種生態（nodejs 的 package.json、python 的 requirements.txt 或 pyproject.toml、dotnet 的 *.csproj）撰寫對應的 parse 與 rewrite 邏輯，找不到檔案時 exit 3、找不到套件時 exit 4；SKILL.md 步驟改成呼叫 `tools/apply-version.sh {ecosystem} {project dir} {name} {version}`；三份 manifest 版本號同步升級。
Who: jsc-pkg 套件更新流程，影響 pkg-update 技能與所有安裝 jsc-pkg 的使用者。
 2026-08-24 14:48:30 +08:00
jiantw83 3e3e1e588f fix(marketplace): 補齊 canonical marketplace 缺少的欄位 
What: 同步 .agents/plugins/marketplace.json 與 .claude-plugin/marketplace.json 至 plugins/jsc 的 canonical marketplace，補上每個套件缺少的 description 與頂層 owner 欄位。
Why: 兩份 marketplace.json 與 canonical 版本不同步，缺少的欄位會讓套件說明無法顯示，也不符合治理格式。
How: 逐一比對 canonical marketplace.json，把每個套件的 description 補齊，並在頂層加上 owner 欄位，內容與 canonical 一致。
Who: 全庫共用的 infra 修正，影響所有安裝這份 marketplace 的 CLI。
 2026-08-24 14:48:15 +08:00
admin d72db8a607 Merge pull request 'feat(pkg): 匯入 jsc-pkg 技能組並統一 marketplace 為 jsc' (#2) from develop into master 
Reviewed-on: #2
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-08-21 06:42:09 +00:00
jiantw83andClaude Fable 5 7b446fa28e chore(pkg): 加入統一 jsc marketplace 副本（與正本一致，任一 repo 可作註冊入口） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:37:50 +08:00
jiantw83andClaude Fable 5 6f263ef355 style(pkg): 中文並列改頓號 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:29:45 +08:00
jiantw83andClaude Fable 5 a35e122cfe docs(pkg): translate SKILL.md into English per guidelines 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:29:45 +08:00
jiantw83andClaude Fable 5 3ce5ce989b docs(pkg): AGENTS 語言規則改指向 jsc-meta 的 references/ste100.md 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:13:27 +08:00
jiantw83andClaude Fable 5 92043a3362 docs(pkg): README 安裝/更新/移除改為每指令一行（五個 CLI）並為相關 domain 加上 repo 連結 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:38 +08:00
jiantw83andClaude Fable 5 2ccf67814d chore(pkg): 版本號改為 0.0.1 並移除個別 marketplace（統一為 jsc） 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 14:03:38 +08:00
jiantw83andClaude Fable 5 ba20b67417 docs(pkg): 以統一格式改寫繁體中文 README 與 AGENTS 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83andClaude Fable 5 f5d6ec0bff feat(pkg): 匯入 jsc-pkg 技能組 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:43 +08:00
jiantw83andClaude Fable 5 d89f5836c7 chore(pkg): 修正範本 manifest 與移除 hello 範例符合 pkg 領域 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-08-21 13:08:18 +08:00
jiantw83 75ac8d40ca Initial commit 2026-08-21 04:44:00 +00:00