修正 html-export 與 wiki-to-issue 技能 frontmatter 的 YAML 純量語法 #37

2026-08-31T11:03:53Z

jiantw83 commented

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

修正 html-export 與 wiki-to-issue 技能 frontmatter 的 YAML 純量語法

摘要

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

變更內容

檔案	為什麼改
skills/html-export/SKILL.md	description 內含未加引號的「冒號加空白」，屬 YAML 語法錯誤；加單引號修正，撇號改寫成兩個單引號，文字內容不變
skills/wiki-to-issue/SKILL.md	description 內含未加引號的「冒號加空白」，屬 YAML 語法錯誤；加單引號修正，撇號改寫成兩個單引號，文字內容不變
plugin.json	同步技能版本號，0.1.9 → 0.2.0（patch 滿 9，依準則進位到 minor）
.claude-plugin/plugin.json	同步技能版本號，0.1.9 → 0.2.0
.codex-plugin/plugin.json	同步技能版本號，0.1.9 → 0.2.0

設計重點

這個缺陷值得修：Antigravity 解析 frontmatter 失敗時會靜默丟棄整支技能，沒有任何錯誤訊息；磁碟上 34 支技能，Antigravity 只認得 28 支，只有逐檔比對才能發現，這次一次抓出兩支。
為什麼用加引號而不是改標點：準則要求 description 用英文撰寫，若把「: 」換成全形冒號會讓英文句子夾雜中文標點，不符合準則；加引號才能在修正語法的同時保留原文字完全不變。
內容逐字未變的稽核證據：用 git show HEAD: 分別取出兩支技能改前的原始值，把改後的單引號純量還原後逐一做字串相等比對，逐字相同、字元數一致（html-export 613 字元、wiki-to-issue 616 字元）。
程式層防線：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/html-export/SKILL.md 顯示 1 1、skills/wiki-to-issue/SKILL.md 顯示 1 1，都只動 frontmatter 那一行

前置 Push Request

無

# 修正 html-export 與 wiki-to-issue 技能 frontmatter 的 YAML 純量語法  ## 摘要 - 需求描述：修正 skills/html-export/SKILL.md 與 skills/wiki-to-issue/SKILL.md frontmatter 裡 description 欄位未加引號的 YAML plain scalar 語法錯誤（內含「冒號加空白」），避免 Antigravity 解析 frontmatter 時中斷、靜默丟棄整支技能。 - 計畫名稱：無 - 計畫頁：無 - 分析頁：無 ## 變更內容 | 檔案 | 為什麼改 | | --- | --- | | skills/html-export/SKILL.md | description 內含未加引號的「冒號加空白」，屬 YAML 語法錯誤；加單引號修正，撇號改寫成兩個單引號，文字內容不變 | | skills/wiki-to-issue/SKILL.md | description 內含未加引號的「冒號加空白」，屬 YAML 語法錯誤；加單引號修正，撇號改寫成兩個單引號，文字內容不變 | | plugin.json | 同步技能版本號，0.1.9 → 0.2.0（patch 滿 9，依準則進位到 minor） | | .claude-plugin/plugin.json | 同步技能版本號，0.1.9 → 0.2.0 | | .codex-plugin/plugin.json | 同步技能版本號，0.1.9 → 0.2.0 | ## 設計重點 - 這個缺陷值得修：Antigravity 解析 frontmatter 失敗時會靜默丟棄整支技能，沒有任何錯誤訊息；磁碟上 34 支技能，Antigravity 只認得 28 支，只有逐檔比對才能發現，這次一次抓出兩支。 - 為什麼用加引號而不是改標點：準則要求 description 用英文撰寫，若把「: 」換成全形冒號會讓英文句子夾雜中文標點，不符合準則；加引號才能在修正語法的同時保留原文字完全不變。 - 內容逐字未變的稽核證據：用 git show HEAD: 分別取出兩支技能改前的原始值，把改後的單引號純量還原後逐一做字串相等比對，逐字相同、字元數一致（html-export 613 字元、wiki-to-issue 616 字元）。 - 程式層防線：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/html-export/SKILL.md 顯示 1 1、skills/wiki-to-issue/SKILL.md 顯示 1 1，都只動 frontmatter 那一行 ## 前置 Push Request - 無

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

fix(frontmatter): 修正 html-export 與 wiki-to-issue 技能 SKILL.md frontmatter 的 YAML 純量語法錯誤 7c3e98fc9b

What：
- 修正 skills/html-export/SKILL.md 與 skills/wiki-to-issue/SKILL.md frontmatter 裡 description 欄位的 YAML 語法錯誤。
- 兩支技能的 description 整串加上單引號，內部撇號改寫成兩個單引號，內容文字一個字都沒變。
- 同步更新 plugin.json、.claude-plugin/plugin.json、.codex-plugin/plugin.json 三個 manifest 版本號，從 0.1.9 進到 0.2.0（patch 滿 9，依準則進位到 minor）。

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：
- 本次修到 gitea 技能組的 html-export 技能（把 Wiki 頁面或 Issue 匯出成單一 HTML 檔）與 wiki-to-issue 技能（把 Wiki 頁面轉建成 Issue）。

jiantw83 merged commit 9cec36d92b into feat/cli-hook-rewire/main

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

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/gitea#37