修正 models 技能 SKILL.md frontmatter 的 YAML 純量語法 #47

2026-08-31T11:03:04Z

jiantw83 commented

2026-08-31 11:03:04 +00:00

修正 models 技能 SKILL.md frontmatter 的 YAML 純量語法

摘要

需求描述：修正 skills/models/SKILL.md frontmatter 裡 description 欄位未加引號的 YAML plain scalar 語法錯誤（內含「冒號加空白」），避免 Antigravity 解析 frontmatter 時中斷、靜默丟棄整支技能。
計畫名稱：無
計畫頁：無
分析頁：無

變更內容

檔案	為什麼改
skills/models/SKILL.md	description 內含未加引號的「冒號加空白」，屬 YAML 語法錯誤；加單引號修正，撇號改寫成兩個單引號，文字內容不變
plugin.json	同步技能版本號，0.2.6 → 0.2.7
.claude-plugin/plugin.json	同步技能版本號，0.2.6 → 0.2.7
.codex-plugin/plugin.json	同步技能版本號，0.2.6 → 0.2.7

設計重點

這個缺陷值得修：Antigravity 解析 frontmatter 失敗時會靜默丟棄整支技能，沒有任何錯誤訊息；磁碟上 34 支技能，Antigravity 只認得 28 支，只有逐檔比對才能發現。
為什麼用加引號而不是改標點：準則要求 description 用英文撰寫，若把「: 」換成全形冒號會讓英文句子夾雜中文標點，不符合準則；加引號才能在修正語法的同時保留原文字完全不變。
內容逐字未變的稽核證據：用 git show HEAD: 取出改前的原始值，把改後的單引號純量還原後做字串相等比對，逐字相同、字元數一致（667 字元）。
程式層防線：jsc-meta 已新增 tools/lint-frontmatter.sh，並排進審核檢查清單與 skill-check 第一組稽核，避免此類問題再次靜默發生（該變更在 jsc-meta 的另一條 PR，本 PR 不掛前置相依）。

測試結果

ste100-lint.sh：exit 0
check-behaviors.sh：exit 0
lint-frontmatter.sh：exit 0
git diff --numstat：skills/models/SKILL.md 顯示 1 1，只動 frontmatter 那一行

前置 Push Request

無

# 修正 models 技能 SKILL.md frontmatter 的 YAML 純量語法  ## 摘要 - 需求描述：修正 skills/models/SKILL.md frontmatter 裡 description 欄位未加引號的 YAML plain scalar 語法錯誤（內含「冒號加空白」），避免 Antigravity 解析 frontmatter 時中斷、靜默丟棄整支技能。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | skills/models/SKILL.md | description 內含未加引號的「冒號加空白」，屬 YAML 語法錯誤；加單引號修正，撇號改寫成兩個單引號，文字內容不變 | | plugin.json | 同步技能版本號，0.2.6 → 0.2.7 | | .claude-plugin/plugin.json | 同步技能版本號，0.2.6 → 0.2.7 | | .codex-plugin/plugin.json | 同步技能版本號，0.2.6 → 0.2.7 | ## 設計重點 - 這個缺陷值得修：Antigravity 解析 frontmatter 失敗時會靜默丟棄整支技能，沒有任何錯誤訊息；磁碟上 34 支技能，Antigravity 只認得 28 支，只有逐檔比對才能發現。 - 為什麼用加引號而不是改標點：準則要求 description 用英文撰寫，若把「: 」換成全形冒號會讓英文句子夾雜中文標點，不符合準則；加引號才能在修正語法的同時保留原文字完全不變。 - 內容逐字未變的稽核證據：用 git show HEAD: 取出改前的原始值，把改後的單引號純量還原後做字串相等比對，逐字相同、字元數一致（667 字元）。 - 程式層防線：jsc-meta 已新增 tools/lint-frontmatter.sh，並排進審核檢查清單與 skill-check 第一組稽核，避免此類問題再次靜默發生（該變更在 jsc-meta 的另一條 PR，本 PR 不掛前置相依）。 ## 測試結果 - ste100-lint.sh：exit 0 - check-behaviors.sh：exit 0 - lint-frontmatter.sh：exit 0 - git diff --numstat：skills/models/SKILL.md 顯示 1 1，只動 frontmatter 那一行 ## 前置 Push Request - 無

jiantw83 added 1 commit 2026-08-31 11:03:04 +00:00

fix(frontmatter): 修正 models 技能 SKILL.md frontmatter 的 YAML 純量語法錯誤 daa4bcf9e1

What：
- 修正 skills/models/SKILL.md frontmatter 裡 description 欄位的 YAML 語法錯誤。
- 整串 description 加上單引號，內部撇號改寫成兩個單引號，內容文字一個字都沒變。
- 同步更新 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三個 manifest 版本號，從 0.2.6 進到 0.2.7。

Why：
- description 內含「冒號加空白」，屬於未加引號的 YAML plain scalar，違反 YAML 語法規定。
- Antigravity 解析 frontmatter 時當場中斷，整支技能被靜默丟棄，沒有任何錯誤訊息；磁碟上 34 支技能，Antigravity 只認得 28 支。
- 準則要求 description 用英文撰寫，不能把「: 」改成全形冒號迴避語法問題，只能加引號修正。

How：
- 整串 description 值加上單引號，內部撇號寫成兩個單引號跳脫，其餘字元不動。
- 用 git show HEAD: 取出改前的原始值，把改後的單引號純量還原後做字串相等比對，確認逐字相同、字元數一致。
- 執行 ste100-lint.sh、check-behaviors.sh、lint-frontmatter.sh 三支檢查腳本，退出碼皆為 0；git diff --numstat 顯示只動了 frontmatter 那一行。

Who：
- 本次修到 cli 技能組的 models 技能，屬盤點各 CLI 可用模型與能力標籤的功能。

jiantw83 merged commit 749b1ad6d3 into feat/cli-hook-rewire/main

2026-09-01 00:56:08 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/cli#47