English | 中文版

變更紀錄

格式參考 Keep a Changelog，新的在上面。 本檔只記錄本 fork 的維護歷史（2026-09-04 起）；上游 addyosmani/agent-skills 的產品演進見其自身歷史 與 docs/UPSTREAM.md 的審查清冊。逐筆採用／略過的理由記在 docs/DECISIONS.md。

---

[Unreleased] - 2026-11-02

同步與決策

• 逐筆審查 eb07f19..7947664 的 21 筆 commit，同步 30 個產品檔，包含 staged-secret 只印檔名、React children 型別、對比門檻、resize 等待與 eval 診斷；版本維持 0.6.9；補審已關閉未合併的 PR #768，不採用。
• 保留 hooks/hooks.json，記錄相容性理由、雙重路由成本與重看條件；刪檔需維護者另行授權。
• repo 專用環境採 pytest 9.2.0，維持最低相容宣告 9.1，依 deferrals 記錄本版審查理由。新增範例回歸測試與 staged-secret 本機 gate；證據見 docs/DECISIONS.md。

[Unreleased] - 2026-10-24

同步

• 自我掃描跟上 SkillSpector 2.12.0。 2.12.0 在 Windows 拒絕 --output，gate 改用 stdout 導向寫報告（需 PowerShell 7.4+，gate 會檢查）；指紋以新舊兩個版本號對同一 finding 計算後原地換新，保留理由，刪除 7 筆過期條目。見 docs/DECISIONS.md。

• 上游批次同步到 aeac41d（0.6.13；PR #718、issue #717）。 112 個 commit 只動到 61 個檔案；本 fork 自己持有的只有 5 份 plugin manifest 與繁中 README.md，其餘 55 個（含 9 個新增檔）直接取上游版本；manifest 內容取上游、版本依既有決策維持 0.6.9（0.6.12／0.6.13 的 release bump 不採用）。README.en.md 以上游現行 README 重建；繁中 README.md 補譯三處：plugin command 命名空間（/agent-skills:review）、.cursor/ 兩個目錄在使用者專案內、未列出的宿主見 docs/other-hosts.md。PR 軸 28 筆已合併者隨本次進來，14 筆 closed 不處理，其餘等合併。自我掃描新增的 8 筆 finding 全為上游新文件造成的自我指涉誤判，逐筆審閱後收錄。見 docs/DECISIONS.md。

[Unreleased] - 2026-09-17

同步

• 自我掃描跟上 SkillSpector 82bbe8b。 每檔時間預算改用上游變數名 SKILLSPECTOR_MAX_STATIC_ANALYSIS_SECONDS_PER_ARTIFACT（舊的 fork 變數在新版會被忽略）。新版識別方式讓 4 筆 fingerprint 換雜湊；constraint-driven-development 引用的 floor-guard.md 因解析器跨度上限未被完整檢查，人工審閱內容後以具體理由收錄 2 筆 AE1。見 docs/DECISIONS.md。

• 上游批次審查到 be4e44a（PR #578、issue #572）。 採用 context-engineering 的 Restartable Session Boundaries、adapter 對照表（英文鏡像 README）、spec 外部產物歸屬、既有專案不需遷移、原生 host 避免雙重路由、穩定的 browser skill 名稱與教學連結；文件中的命令數更正為 9 並補上 /constraints。本批上游改過的檔案除繁中 README 外都已與上游一致。

修復

• 修復 squash 初始化後缺少可達 release tag 與 plugin manifest 漂移。 將 5 份 plugin manifest 版本自 0.6.8 同步為 0.6.9；在 main 重新綁定唯一的最新 release tag 0.6.9，修復 CI Test Plugin Installation / Validate skill content 中 validate-versions.js 的 git describe --tags --abbrev=0 失敗。

• reference-link 驗證器在 Windows 印反斜線路徑。 本機 validate-reference-links-test.js 7 個測試 1 個失敗；採用未合併的上游 PR #573，把輸出路徑統一成 /，7/7 通過。

[Unreleased] - 2026-09-11

同步

• 上游批次審查到 6ca0cd7（PR #567、issue #565）。 採用 observability 的 runbook 撰寫小節、context-engineering 的 Context Budget Management 一節（含兩輪 review 修正）、commands/planning.toml 與 .gemini/commands/planning.toml 補上不完整 plan 不可覆寫的防線，以及 11 個 skill description 補詞與 eval rank-1 門檻 80 → 95。另從未合併的 #563 取回 scripts/run-evals.js 遇到 null grader expectation 會丟 TypeError 的修正，本 fork 有同一缺陷。#564、#566、#567 暫緩到合併，理由見 docs/DECISIONS.md。

變更

• CodeQL action 重釘 v4.37.9 → v4.38.0（commit SHA b96794f，由 annotated tag v4.38.0 解出）。依賴新鮮度檢查對 fork 持有的 codeql.yml 報 REVIEW UPDATE，下次排程會紅。

修復

• 本機自我掃描自掃描器升版起就一直是紅的。 baseline 記的是 scanner_version: 2.11.0，PATH 上的 skillspector 已是 2.11.2；精確 fingerprint 綁掃描器版本，46 筆因此全部失效，每次 gate 都把 baseline 裡的 finding 報成新的。CI 不安裝掃描器，所以只有本機看得到。以 2.11.2 重產成 26 筆（16 筆 RP1／PE3 已由既有規則涵蓋、4 筆是對到同一 finding 的重複項），理由逐字保留，並在每筆記下所屬 skill。細節見 docs/DECISIONS.md。

[Unreleased] - 2026-09-09

修復

• 依賴新鮮度的 Actions 查詢改帶 token。 匿名 api.github.com 是每小時 60 次、hosted runner 共用同一個位址額度；超過之後每一列 Action 的 latest 都變成 unknown，整個 Actions 半邊靜默失聲。_github_json 現在在環境有 GITHUB_TOKEN／GH_TOKEN 時送 Authorization: Bearer，workflow 的檢查步驟也補上 GH_TOKEN: ${{ github.token }}。沒有 token 仍可運作，只是走匿名額度。（缺陷由 SanHsien/commerce-agents 那條線先發現。）

• 依賴新鮮度漏看了每一個 CodeQL pin。 _USES_RE 只匹配 owner/repo@，而 github/codeql-action/init 是三段路徑，所以 codeql.yml 裡的兩個 pin 從來沒進過報告。路徑改為允許子目錄，查 Releases 時再 截回擁有 tag 的 repo。

• 無法比較的 latest 不再報 OK。 github/codeql-action 的 releases/latest 回 codeql-bundle-v2.26.4， 與 workflow 釘的 v4.37.4 不同編號系統，解析不出數字就一路報 OK。現在解析失敗會改查 tag 列表取最新 可解析版本；真的比不了就記 CHECK FAILED——不會失敗的檢查不是檢查。

• CodeQL action 重釘 v4.37.4 → v4.37.9（SHA cdf488f），修好檢查後第一次跑就抓到的實際漂移。

兩個缺陷是在 SanHsien/dashi-ppt-skill 移植本檔的檢查器時發現的，同源同修。

---

[Unreleased] - 2026-09-04

新增

• Windows-first 維護骨架。 AGENTS.md／CLAUDE.md 尾端加上 fork 維護規則一節（不動既有 上游內容）、FORK.md、NOTICE.md、SECURITY.md、CODE_OF_CONDUCT.md、docs/DEVELOPMENT.md、 docs/UPSTREAM.md、docs/DECISIONS.md、tools/ 維護腳本（dev_check.ps1、 check_upstream_updates.py、check_dependency_freshness.py、check_links.py、 upstream_baseline.json）、對應的 tests/，以及 .github/ 的 CI／CodeQL／Dependabot／ 上游檢查／依賴新鮮度 workflow。CI 在 Ubuntu 跑 Python 3.14 + Node 24（pytest、ruff E9+F、 node scripts/validate-skills.js、node scripts/validate-commands.js、相對連結檢查）， 加一個 Windows job 跑同一套 tools/dev_check.ps1；上游既有的 .github/workflows/test-plugin-install.yml（skill／command 全量驗證、eval、plugin 安裝煙霧 測試）維持不動，不重複覆蓋。
• 公開入口只留繁中與英文。 README.md 改為繁中主檔，README.en.md 為上游英文原文的逐字 鏡像（加語言切換列）。來源與授權 credit 保留，個人事業／贊助段落上游本來就沒有，不需另行剔除。

說明

• 產品 skills/、commands/、.claude/commands/、.gemini/commands/、agents/、hooks/、 references/、evals/、scripts/、既有 docs/*.md、.claude-plugin/、.codex-plugin/、 .agents/、.gemini/、.opencode/、plugin.json、LICENSE、CONTRIBUTING.md、 .gitignore、.gitattributes 以上游為準，本次疊加不觸碰。