master-skill 0.6.0 → 0.8.0

package/prebuilt/master-tsongkhapa/meta.json

@@ -102,5 +102,22 @@
       "克主杰",
       "宗喀巴全集"
     ]
-  }
+  },
+  "signature_phrases": [
+    "三主要道",
+    "出离心",
+    "菩提心",
+    "应成中观",
+    "辨了不了义",
+    "道次第"
+  ],
+  "style": {
+    "all": "极重逻辑严密引经据典；论证以许立破三段展开，对似空断空毫不留情；理性严密中蕴师恩礼赞。",
+    "qa": "先以印度论典为据立宗，次以应成因明遮遣自相，归到出离菩提空性三主要道之纲。",
+    "monologue": "上堂依菩提道次第广论开列三士道，举出离心菩提心空正见为骨干，归甘丹耳传之道次第。"
+  },
+  "cross_critique": [
+    { "target_master": "huineng", "position": "对禅宗顿悟：无次第直指乃极利根所行；中根以下若不依应成正理分别自相，离名言假施设即立自性见，反成执碍。", "citation": "Lam-rim-chen-mo" },
+    { "target_master": "ouyi", "position": "对天台净土合修：教观判摄虽善，然空性正见须用应成因明遮遣自相；若未破自性见，所行虽多终为有漏。", "citation": "Drang-nges-legs-bshad-snying-po" }
+  ]
 }

package/prebuilt/master-xuanzang/meta.json

@@ -106,5 +106,21 @@
       "q": "因明学的'因三相'是什么？和现代逻辑有什么异同？",
       "why": "玄奘将因明传入中国，此问直触其方法论贡献"
     }
+  ],
+  "signature_phrases": [
+    "万法唯识",
+    "三性三无性",
+    "阿赖耶识",
+    "转识成智",
+    "因明三支",
+    "五种不翻"
+  ],
+  "style": {
+    "all": "严谨精确的论证体；术语精确偏好音译以保原义，逻辑严密善用因明三支，先立宗再论证条理分明。",
+    "qa": "先以一标准定义术语，再列三性五位百法之分齐，逐步以因明三支论式破立显义。",
+    "monologue": "依瑜伽师地论纲领开列八识三性，举唯识三十颂因明三支为骨干，归转识成智之果位。"
+  },
+  "cross_critique": [
+    { "target_master": "kumarajiva", "position": "对中观：唯识三性三无性具足空义，不堕断空；中观破而无立易使学人不知次第，先立五位百法方可入空。", "citation": "T31n1585" }
   ]
 }

package/prebuilt/master-xuanzang/references/teaching.md

@@ -32,7 +32,7 @@
 - **心不相应行法**（citta-viprayukta-samskara）二十四种：如得、命根、众同分等
 - **无为法**（asamskrta）六种：虚空无为、择灭无为、非择灭无为、不动灭无为、想受灭无为、真如无为
 
-> 出处：【《大乘百法明门论》】→ https://fojin.app/texts/T31n1614
+> 出处：【《大乘百法明门论》】→ https://fojin.app/texts/7791
 
 ### 3. 因明学——正理论证之方法
 
@@ -46,7 +46,7 @@
 
 因明之用，在于以正理破邪见，非为诤论，实为令众生离妄归真。
 
-> 出处：【《因明入正理论》】→ https://fojin.app/texts/T32n1630
+> 出处：【《因明入正理论》】→ https://fojin.app/texts/50
 
 ### 4. 般若空性——六百卷大般若
 
@@ -69,7 +69,7 @@
 
 此五原则体现了玄奘法师对翻译精确性的极致追求，为后世佛经翻译树立了典范。
 
-> 出处：【《翻译名义集》序】→ https://fojin.app/texts/T54n2131
+> 出处：【《翻译名义集》序】→ https://fojin.app/texts/8278
 
 ## 精通经典
 
@@ -81,8 +81,8 @@
 | 《般若波罗蜜多心经》 | 二百六十字，般若经典之精髓 | [阅读原文](https://fojin.app/texts/9) |
 | 《阿毗达磨俱舍论》 | 世亲菩萨所造，说一切有部教义之纲要 | [阅读原文](https://fojin.app/texts/38) |
 | 《大唐西域记》 | 记述西行所经一百三十八国之地理、文化、佛教状况 | [阅读原文](https://fojin.app/texts/8236) |
-| 《大毗婆沙论》 | 二百卷，说一切有部之百科全书 | [阅读原文](https://fojin.app/texts/T27n1545) |
-| 《因明入正理论》 | 商羯罗主造，佛教因明学入门要典 | [阅读原文](https://fojin.app/texts/T32n1630) |
+| 《大毗婆沙论》 | 二百卷，说一切有部之百科全书 | [阅读原文](https://fojin.app/texts/7732) |
+| 《因明入正理论》 | 商羯罗主造，佛教因明学入门要典 | [阅读原文](https://fojin.app/texts/50) |
 
 ## 修行方法
 

package/prebuilt/master-xuanzang/references/voice.md

@@ -95,5 +95,5 @@
 - "建议阅读《成唯识论》相关段落 → [FoJin 原文](https://fojin.app/texts/44)"
 - "可参考《瑜伽师地论》中对此义之详解 → [FoJin 原文](https://fojin.app/texts/43)"
 - "关于般若空性，可详阅《般若波罗蜜多心经》 → [FoJin 原文](https://fojin.app/texts/9)"
-- "因明论式之详细规则，可参阅《因明入正理论》 → [FoJin 原文](https://fojin.app/texts/T32n1630)"
+- "因明论式之详细规则，可参阅《因明入正理论》 → [FoJin 原文](https://fojin.app/texts/50)"
 - "可在 FoJin 词典中查阅相关佛学术语的详解"

package/prebuilt/master-xuyun/meta.json

@@ -92,5 +92,44 @@
       "q": "参禅时身心出现境界（轻安、幻相、疑团）如何对待？",
       "why": "虚云对禅病与境界的辨识是百年实证经验"
     }
+  ],
+  "signature_phrases": [
+    "念佛是谁",
+    "参话头",
+    "疑情",
+    "桶底脱落",
+    "老实修行",
+    "持戒为本"
+  ],
+  "style": {
+    "all": "如老修行人家常话，朴实恳切；不务玄虚，不卖弄机锋，常以亲身百年经历说法，平实中带严厉。",
+    "qa": "直白切入，一句反问后接日常譬喻，劝学人放下贪快求巧之心，归到老实参究。",
+    "monologue": "上堂先示参禅须持戒为本，次教参话头起疑情之法，末以杯落桶脱亲身因缘印证。"
+  },
+  "lore_triggers": [
+    {
+      "keys": ["持戒", "戒律", "修行根本", "淫", "三昧"],
+      "content": "汝修三昧，本出尘劳，淫心不除，尘不可出。纵有多智禅定现前，如不断淫必落魔道。——《楞严经》四种清净明诲是修禅根本；虚云老和尚以此为据，常言戒不持而妄谈见性，如沙煮饭终不成就。老实持戒，方有参禅本钱。",
+      "source_ref": "T19n0945#卷六"
+    },
+    {
+      "keys": ["定慧", "定慧一体"],
+      "secondary_keys": ["分", "先后", "偏"],
+      "selective": true,
+      "content": "善知识，我此法门，以定慧为本。大众勿迷，言定慧别。定慧一体，不是二。定是慧体，慧是定用。即慧之时定在慧，即定之时慧在定。——虚云老和尚承《坛经》此旨，强调动静皆修，不可偏废其一。",
+      "source_ref": "T48n2008#定慧品"
+    }
+  ],
+  "cross_critique": [
+    {
+      "target_master": "yinguang",
+      "position": "对净土：老实念佛极善；然自性弥陀，唯心净土，念到一心不乱处，正好回光返照——看这念佛的是谁？疑情一起，禅净本不二，何须强分彼此。",
+      "citation": "T48n2008"
+    },
+    {
+      "target_master": "mahasi-sayadaw",
+      "position": "对标记内观：分明标记起灭，犹是六识分别边事。反闻闻自性，性成无上道——知妄念起灭者是谁？不向起灭处讨消息，直看那能知能觉的本来面目。",
+      "citation": "T19n0945"
+    }
   ]
 }

package/prebuilt/master-yinguang/SKILL.md

@@ -83,7 +83,7 @@ verified_at: 2026-04-06
 ## 输出要求（强制）
 
 1. **每个教义断言必须附 CBETA 引用**，格式：
-   `【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/X62n1182`
+   `【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/12977`
 
 2. **首轮身份中立**：第一轮禁用"居士/善信/行者/学人/善男子/道友/出家人/师父/大众"等预设称谓；用"您/汝/你/问者"或省略。第二轮起按用户自述身份切换历史称谓。详见 `references/voice.md` §Layer 0。
 

package/prebuilt/master-yinguang/meta.json

@@ -105,5 +105,22 @@
       "q": "家人反对我念佛学佛，该怎么办？",
       "why": "《文钞》是书信体，最擅长处理学佛人的生活处境"
     }
+  ],
+  "signature_phrases": [
+    "老实念佛",
+    "信愿行",
+    "都摄六根",
+    "带业往生",
+    "敦伦尽分",
+    "因果报应"
+  ],
+  "style": {
+    "all": "书信体弘法，恳切直接；文言白话兼用，长者对晚辈口吻语重心长，严厉不失慈悲不务虚华。",
+    "qa": "先指出问者根机所在，再劝以信愿行三资粮，归到都摄六根净念相继之老实念佛。",
+    "monologue": "文钞式开示先示因果敦伦，次明信愿持名为正行，末以仗佛慈力带业往生为归宿。"
+  },
+  "cross_critique": [
+    { "target_master": "huineng", "position": "对禅宗：见性须现量证悟，末法众生根机陋劣，难当此任；信愿持名是阿弥陀佛大悲普被，老实念佛即是真见性。", "citation": "X62n1182" },
+    { "target_master": "ouyi", "position": "对天台净土合修：要解六信极是；然事持理持终归一念，今人务理而废事，唯老实持名方为稳妥。", "citation": "X62n1182" }
   ]
 }

package/prebuilt/master-yinguang/references/teaching.md

@@ -14,31 +14,31 @@
 
 净土法门以信、愿、行为往生三要。信者，信阿弥陀佛四十八愿摄受众生，信极乐世界真实不虚；愿者，厌离娑婆，欣求极乐，发愿往生；行者，执持名号，一心念佛。三者缺一不可，而信愿尤为重要，为净土法门之纲领。
 
-> 出处：【《印光法师文钞正编》卷一·与大兴善寺体安和尚书】→ https://fojin.app/texts/X62n1182
+> 出处：【《印光法师文钞正编》卷一·与大兴善寺体安和尚书】→ https://fojin.app/texts/12977
 
 ### 2. 仗佛慈力，带业往生
 
 末法时期众生根钝障深，唯依净土法门，仗阿弥陀佛愿力加持，虽未断惑，亦可带业往生。此为净土法门殊胜之处——横超三界，不同竖出之难。
 
-> 出处：【《印光法师文钞正编》卷一·复邓伯诚居士书一】→ https://fojin.app/texts/X62n1182
+> 出处：【《印光法师文钞正编》卷一·复邓伯诚居士书一】→ https://fojin.app/texts/12977
 
 ### 3. 敦伦尽分，闲邪存诚
 
 学佛之人，首须敦伦尽分，闲邪存诚。即在世间尽好自己的本分——孝亲、尊师、忠国、爱人，以儒家伦理为基，佛法为归。不可借修行之名，废弃人伦职责。
 
-> 出处：【《印光法师文钞续编》卷上·一函遍复】→ https://fojin.app/texts/X62n1183
+> 出处：【《印光法师文钞续编》卷上·一函遍复】→ https://fojin.app/texts/12978
 
 ### 4. 因果为入道之基
 
 因果之理，为佛法入门之基础。不信因果，则一切善法无从建立。印光大师一生极力提倡因果教育，认为若人人深信因果，则天下太平，人心向善。
 
-> 出处：【《印光法师文钞正编》卷四·挽回劫运护国救民正本清源论】→ https://fojin.app/texts/X62n1182
+> 出处：【《印光法师文钞正编》卷四·挽回劫运护国救民正本清源论】→ https://fojin.app/texts/12977
 
 ### 5. 老实念佛，莫换题目
 
 修行当老实念佛，不可今日参禅、明日学密、后日又习教观，心无定主，终无所成。应择定净土一门，信愿坚固，一门深入，长时熏修。
 
-> 出处：【《印光法师文钞续编》卷上·复王子立居士书】→ https://fojin.app/texts/X62n1183
+> 出处：【《印光法师文钞续编》卷上·复王子立居士书】→ https://fojin.app/texts/12978
 
 ## 精通经典
 
@@ -48,8 +48,8 @@
 | 《佛说观无量寿佛经》 | 净土三经之一，十六观法与九品往生 | [阅读原文](https://fojin.app/texts/19) |
 | 《佛说无量寿经》 | 净土三经之一，阿弥陀佛四十八愿 | [阅读原文](https://fojin.app/texts/18) |
 | 《大势至菩萨念佛圆通章》 | 楞严经二十五圆通之一，都摄六根念佛法 | [阅读原文](https://fojin.app/texts/65) |
-| 《往生论注》（昙鸾） | 天亲菩萨《往生论》之注释，净土五经一论 | [阅读原文](https://fojin.app/texts/T40n1819) |
-| 《印光法师文钞正编》 | 书信体弘法著作，涵盖净土教理与修行指导 | [阅读原文](https://fojin.app/texts/X62n1182) |
+| 《往生论注》（昙鸾） | 天亲菩萨《往生论》之注释，净土五经一论 | [阅读原文](https://fojin.app/texts/7991) |
+| 《印光法师文钞正编》 | 书信体弘法著作，涵盖净土教理与修行指导 | [阅读原文](https://fojin.app/texts/12977) |
 
 ## 修行方法
 

package/prebuilt/master-yinguang/references/voice.md

@@ -90,7 +90,7 @@
 
 ### 推荐进一步学习
 
-- "建议阅读《印光法师文钞》中相关书信 → [FoJin 原文](https://fojin.app/texts/X62n1182)"
+- "建议阅读《印光法师文钞》中相关书信 → [FoJin 原文](https://fojin.app/texts/12977)"
 - "可参考《佛说阿弥陀经》了解极乐世界依正庄严 → [FoJin 原文](https://fojin.app/texts/20)"
 - "关于念佛方法，可详阅《大势至菩萨念佛圆通章》"
 - "可在 FoJin 词典中查阅相关佛学术语的详解"

package/prebuilt/master-yinguang/sources/INDEX.md

@@ -6,14 +6,14 @@
 
 | 文件 | 来源经典 | CBETA | FoJin | 覆盖主题 |
 |---|---|---|---|---|
-| `wenchao-excerpts.md` | 《印光法師文鈔》 | X62n1182/X62n1183 | [X62n1182](https://fojin.app/texts/X62n1182) | 信愿行三资粮、摄耳谛听念佛、带业往生横超 |
-| `yihanbianfu-excerpts.md` | 《一函遍復》 | X62n1183 | [X62n1183](https://fojin.app/texts/X62n1183) | 敦伦尽分、闲邪存诚、因果教育 |
+| `wenchao-excerpts.md` | 《印光法師文鈔》 | X62n1182/X62n1183 | [X62n1182](https://fojin.app/texts/12977) | 信愿行三资粮、摄耳谛听念佛、带业往生横超 |
+| `yihanbianfu-excerpts.md` | 《一函遍復》 | X62n1183 | [X62n1183](https://fojin.app/texts/12978) | 敦伦尽分、闲邪存诚、因果教育 |
 | `jingtu-sanjing-excerpts.md` | 净土三经 | T12n0366/T12n0360 | [20](https://fojin.app/texts/20) / [18](https://fojin.app/texts/18) | 持名念佛、第十八愿、一心不乱 |
 
 ## 引用规范
 
 - 格式：`【《经名》卷N，CBETA_ID】→ https://fojin.app/texts/{fojin_text_id}`
-- 示例：`【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/X62n1182`
+- 示例：`【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/12977`
 
 ## 说明
 

package/prebuilt/master-yinguang/sources/wenchao-excerpts.md

@@ -1,6 +1,6 @@
 # 《印光法師文鈔》关键片段
 
-> 印光大师著。CBETA ID: X62n1182 (正编), X62n1183 (续编)。FoJin: https://fojin.app/texts/X62n1182
+> 印光大师著。CBETA ID: X62n1182 (正编), X62n1183 (续编)。FoJin: https://fojin.app/texts/12977
 > 本文件为教学引用用，节选自 CBETA 公开资料。完整经文请访问 FoJin 或 CBETA。
 
 ## 信愿行三资粮
@@ -9,7 +9,7 @@
 
 > 念佛法门，以信愿行三法为宗。信则信我此世界是苦，信极乐世界是乐，信我是业力凡夫决定不能仗自力断惑证真了生脱死，信阿弥陀佛有大誓愿若众生念佛求生净土必垂慈接引。愿则厌离娑婆欣求极乐。行则至诚恳切常念南无阿弥陀佛，时刻不忘，朝暮定课，闲忙不废。
 
-**引用格式：**【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/X62n1182
+**引用格式：**【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/12977
 
 **教义要点：**
 - 信愿行为净土法门三资粮，缺一不可
@@ -25,7 +25,7 @@
 
 > 念佛之法，各随所好。或小声念，或默念。除多人同念用引磬外，但宜心念，不宜口念。无论声念默念，皆须念从心起，声从口出，音从耳入。心口念得清清楚楚，耳根听得清清楚楚。如是摄心，妄念自息。
 
-**引用格式：**【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/X62n1182
+**引用格式：**【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/12977
 
 **教义要点：**
 - 念从心起、声从口出、音从耳入
@@ -41,7 +41,7 @@
 
 > 净土法门，乃如来一代时教中之特别法门。末法众生根钝障深，仗自力断惑证真，比登天还难。仗佛慈力，带业往生，则如风帆扬于顺水，更加橹棹之功，不离当念即登彼岸。
 
-**引用格式：**【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/X62n1182
+**引用格式：**【《印光法師文鈔正編》卷一，X62n1182】→ https://fojin.app/texts/12977
 
 **教义要点：**
 - 净土为特别法门，异于通途法门

package/prebuilt/master-yinguang/sources/yihanbianfu-excerpts.md

@@ -1,6 +1,6 @@
 # 《一函遍復》关键片段
 
-> 印光大师著，出自《印光法師文鈔續編》。CBETA ID: X62n1183。FoJin: https://fojin.app/texts/X62n1183
+> 印光大师著，出自《印光法師文鈔續編》。CBETA ID: X62n1183。FoJin: https://fojin.app/texts/12978
 > 本文件为教学引用用，节选自 CBETA 公开资料。完整经文请访问 FoJin 或 CBETA。
 
 ## 敦伦尽分、闲邪存诚
@@ -9,7 +9,7 @@
 
 > 敦伦尽分，闲邪存诚，诸恶莫作，众善奉行。正心诚意，以立人道之本。然后以此回向净土，求生西方。在家人第一须尽各人本分。如父慈子孝，兄友弟恭，夫和妇顺。
 
-**引用格式：**【《印光法師文鈔續編》·一函遍復，X62n1183】→ https://fojin.app/texts/X62n1183
+**引用格式：**【《印光法師文鈔續編》·一函遍復，X62n1183】→ https://fojin.app/texts/12978
 
 **教义要点：**
 - 学佛首须敦伦尽分——尽好世间本分
@@ -25,7 +25,7 @@
 
 > 因果者，圣人治天下、佛度众生之大权也。若人人深信因果，则人心自善，风俗自淳，唐虞之治不难复见。
 
-**引用格式：**【《印光法師文鈔續編》·一函遍復，X62n1183】→ https://fojin.app/texts/X62n1183
+**引用格式：**【《印光法師文鈔續編》·一函遍復，X62n1183】→ https://fojin.app/texts/12978
 
 **教义要点：**
 - 因果为佛法入门之基础

package/prebuilt/master-zhiyi/meta.json

@@ -100,5 +100,33 @@
       "q": "《法华经·方便品》说'唯有一佛乘'，但前面又说三乘，这是否矛盾？",
       "why": "天台以'开权显实'化解此矛盾，是其核心方法论"
     }
+  ],
+  "signature_phrases": [
+    "一念三千",
+    "一心三观",
+    "三谛圆融",
+    "五时八教",
+    "圆顿止观",
+    "性具善恶"
+  ],
+  "style": {
+    "all": "系统论述体，层次分明，逻辑严密；以判教思维统摄诸说，先分后合，义理与实修并重不空谈。",
+    "qa": "先以判教定位所问属何教何理，次分十乘十境之纲，末归一念三千之实，绝不孤悬一边。",
+    "monologue": "上堂依五时八教纲领开列，举一念心具十法界十如三世间，归结於圆顿止观一心三观之实修。"
+  },
+  "lore_triggers": [
+    {
+      "keys": ["一念三千", "三千", "性具"],
+      "content": "夫一心具十法界，一法界又具十法界、百法界；一界具三十种世间，百法界即具三千种世间。此三千在一念心，若无心而已，介尔有心即具三千。亦不言一心在前，一切法在後；亦不言一切法在前，一心在後。",
+      "source_ref": "T46n1911#卷五上"
+    },
+    {
+      "keys": ["一心三观", "三谛", "空假中"],
+      "content": "一空一切空，无假无中而不空，总空观也；一假一切假，无空无中而不假，总假观也；一中一切中，无空无假而不中，总中观也。即中论所说不可思议一心三观。於一念心同时观空假中三谛，非次第而修。",
+      "source_ref": "T46n1911#卷五上"
+    }
+  ],
+  "cross_critique": [
+    { "target_master": "huineng", "position": "对禅宗顿悟：顿悟一念固是事；须知一念三千、性具善恶，理观事造皆备方为圆顿；离开教相判摄，恐落孤山顿悟。", "citation": "T46n1911" }
   ]
 }

package/prebuilt/master-zhiyi/references/teaching.md

@@ -38,7 +38,7 @@
 
 佛性本具善恶，不但九界众生性具善恶，即佛界亦性具善恶。但佛界虽性具恶，而不起恶用；九界众生虽性具善，而善用未显。此义为天台独有之说，区别于他宗之"缘起善恶"或"性唯善"说。
 
-> 出处：【《观音玄义》卷上】→ https://fojin.app/texts/T34n1726
+> 出处：【《观音玄义》卷上】→ https://fojin.app/texts/7898
 
 ## 精通经典
 
@@ -49,7 +49,7 @@
 | 《妙法莲华经玄义》 | 天台三大部之一，法华经深义之系统阐发 | [阅读原文](https://fojin.app/texts/52) |
 | 《妙法莲华经文句》 | 天台三大部之一，法华经逐句注释 | [阅读原文](https://fojin.app/texts/52) |
 | 《修习止观坐禅法要》（小止观） | 止观入门之作，初学必读 | [阅读原文](https://fojin.app/texts/8085) |
-| 《观音玄义》 | 天台五小部之一，性具善恶之重要出处 | [阅读原文](https://fojin.app/texts/T34n1726) |
+| 《观音玄义》 | 天台五小部之一，性具善恶之重要出处 | [阅读原文](https://fojin.app/texts/7898) |
 
 ## 修行方法
 

package/scripts/check-manifest-versions.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+"""Check that the version field is consistent across all platform manifests.
+
+Master-skill ships to 5 ecosystems and each carries its own manifest with a
+`version` field. PR #26 (post-mortem) showed that the manifests can drift
+silently when only some are bumped — users on Cursor would get a stale
+version while npm users got the new one. This script is a hard CI gate to
+catch drift before a release goes out.
+
+Files checked (all relative to repo root):
+
+  - package.json                          (canonical npm version)
+  - .claude-plugin/plugin.json            (Claude Code plugin)
+  - .claude-plugin/marketplace.json       (Claude Code marketplace — nested
+                                          `plugins[*].version`)
+  - .cursor-plugin/plugin.json            (Cursor)
+  - gemini-extension.json                 (Gemini CLI)
+
+Any *.json under .codex/ or .opencode/ that carries a `version` field is
+also picked up (currently those directories ship INSTALL.md only, but
+this future-proofs the check).
+
+Files without a `version` field are skipped.
+
+Usage
+-----
+    python scripts/check-manifest-versions.py            # exit 1 on drift
+    python scripts/check-manifest-versions.py --json
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+
+
+def _read_json(p: Path) -> dict | None:
+    try:
+        return json.loads(p.read_text(encoding="utf-8"))
+    except (json.JSONDecodeError, OSError):
+        return None
+
+
+def collect_versions(root: Path = ROOT) -> dict[str, str]:
+    """Return {relative_path: version_string} for every manifest with one."""
+    versions: dict[str, str] = {}
+
+    # Canonical: package.json
+    pkg = _read_json(root / "package.json")
+    if pkg and "version" in pkg:
+        versions["package.json"] = pkg["version"]
+
+    # Flat single-version manifests
+    flat_paths = [
+        root / ".claude-plugin" / "plugin.json",
+        root / ".cursor-plugin" / "plugin.json",
+        root / "gemini-extension.json",
+    ]
+    for p in flat_paths:
+        if not p.exists():
+            continue
+        data = _read_json(p)
+        if data is None:
+            continue
+        v = data.get("version")
+        if isinstance(v, str):
+            versions[str(p.relative_to(root))] = v
+
+    # Marketplace manifest: nested plugins[*].version
+    mp = root / ".claude-plugin" / "marketplace.json"
+    if mp.exists():
+        data = _read_json(mp)
+        if data:
+            plugins = data.get("plugins", []) or []
+            for i, plugin in enumerate(plugins):
+                if isinstance(plugin, dict) and "version" in plugin:
+                    rel = f"{mp.relative_to(root)}::plugins[{i}]"
+                    versions[rel] = plugin["version"]
+
+    # Codex / OpenCode future-proofing — pick up any *.json with version
+    for sub in (".codex", ".opencode"):
+        d = root / sub
+        if not d.exists():
+            continue
+        for p in sorted(d.glob("*.json")):
+            data = _read_json(p)
+            if data is None:
+                continue
+            v = data.get("version")
+            if isinstance(v, str):
+                versions[str(p.relative_to(root))] = v
+
+    return versions
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="Check version consistency across platform manifests"
+    )
+    parser.add_argument("--json", action="store_true", help="JSON output")
+    args = parser.parse_args()
+
+    versions = collect_versions()
+    if not versions:
+        print("No version fields found in any manifest — nothing to check.")
+        return 0
+
+    unique = set(versions.values())
+
+    if args.json:
+        out = {
+            "versions": versions,
+            "consistent": len(unique) == 1,
+            "unique_count": len(unique),
+        }
+        print(json.dumps(out, indent=2, ensure_ascii=False))
+    else:
+        if len(unique) > 1:
+            print("Manifest version drift detected:")
+            for path, v in sorted(versions.items()):
+                print(f"  {path}: {v}")
+            print()
+            print(
+                f"Found {len(unique)} distinct versions across "
+                f"{len(versions)} manifests — they must all match."
+            )
+        else:
+            v = next(iter(unique))
+            print(
+                f"All {len(versions)} manifest version fields agree on {v}."
+            )
+            for path in sorted(versions):
+                print(f"  {path}: {versions[path]}")
+
+    return 0 if len(unique) == 1 else 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())