taiwan-invoice-skill 2.0.0 → 2.1.0

package/README.md

@@ -0,0 +1,131 @@
+# taiwan-invoice-skill
+
+<p align="center">
+  <strong>台灣電子發票 AI 開發技能包</strong><br>
+  <sub>支援 ECPay 綠界 · SmilePay 速買配 · Amego 光貿</sub>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/taiwan-invoice-skill"><img src="https://img.shields.io/npm/v/taiwan-invoice-skill?style=flat-square&logo=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/taiwan-invoice-skill"><img src="https://img.shields.io/npm/dm/taiwan-invoice-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js">
+  <img src="https://img.shields.io/badge/platforms-14-blue?style=flat-square" alt="14 Platforms">
+  <a href="https://github.com/Moksa1123/taiwan-invoice/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-invoice?style=flat-square" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="https://paypal.me/cccsubcom"><img src="https://img.shields.io/badge/PayPal-支持開發-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal"></a>
+</p>
+
+---
+
+## 安裝
+
+```bash
+npm install -g taiwan-invoice-skill
+```
+
+---
+
+## 使用方式
+
+```bash
+# 進入專案目錄
+cd /path/to/your/project
+
+# 選擇你的 AI 助手
+taiwan-invoice init --ai claude        # Claude Code
+taiwan-invoice init --ai cursor        # Cursor
+taiwan-invoice init --ai windsurf      # Windsurf
+taiwan-invoice init --ai copilot       # GitHub Copilot
+taiwan-invoice init --ai antigravity   # Antigravity
+taiwan-invoice init --ai all           # 全部安裝
+```
+
+<details>
+<summary>完整平台列表</summary>
+
+```bash
+taiwan-invoice init --ai kiro          # Kiro (AWS)
+taiwan-invoice init --ai codex         # Codex CLI (OpenAI)
+taiwan-invoice init --ai qoder         # Qoder
+taiwan-invoice init --ai roocode       # Roo Code
+taiwan-invoice init --ai gemini        # Gemini CLI
+taiwan-invoice init --ai trae          # Trae (ByteDance)
+taiwan-invoice init --ai opencode      # OpenCode
+taiwan-invoice init --ai continue      # Continue
+taiwan-invoice init --ai codebuddy     # CodeBuddy (Tencent)
+```
+
+</details>
+
+---
+
+## 其他指令
+
+```bash
+taiwan-invoice list         # 列出支援平台
+taiwan-invoice info         # 顯示技能資訊
+taiwan-invoice versions     # 列出可用版本
+taiwan-invoice update       # 檢查更新
+```
+
+### 選項
+
+```bash
+taiwan-invoice init --offline   # 跳過 GitHub 下載，使用內建資源
+taiwan-invoice init --force     # 覆蓋現有檔案
+taiwan-invoice init --global    # 安裝到全域目錄
+```
+
+---
+
+## 運作原理
+
+`taiwan-invoice init` 預設會從 GitHub 下載最新版本。如果下載失敗（網路錯誤、速率限制），會自動使用 CLI 內建的資源。
+
+使用 `--offline` 可跳過 GitHub 下載，直接使用內建資源。
+
+---
+
+## 支援平台
+
+| 平台 | 說明 | 啟動方式 |
+|------|------|----------|
+| **Claude Code** | Anthropic 官方 CLI | 自動 |
+| **Cursor** | AI 程式編輯器 | `/taiwan-invoice` |
+| **Windsurf** | Codeium 編輯器 | 自動 |
+| **Copilot** | GitHub Copilot | `/taiwan-invoice` |
+| **Antigravity** | Google AI 助手 | 自動 |
+| **Kiro** | AWS AI 助手 | `/taiwan-invoice` |
+| **Codex** | OpenAI CLI | 自動 |
+| **Qoder** | Qodo AI 助手 | 自動 |
+| **RooCode** | VSCode 擴充 | `/taiwan-invoice` |
+| **Gemini CLI** | Google Gemini | 自動 |
+| **Trae** | ByteDance AI | 自動 |
+| **OpenCode** | 開源 AI 助手 | 自動 |
+| **Continue** | 開源 AI 助手 | 自動 |
+| **CodeBuddy** | Tencent AI | 自動 |
+
+---
+
+## 加值中心
+
+| 加值中心 | 驗證方式 | 特點 |
+|----------|----------|------|
+| **ECPay 綠界** | AES-128-CBC 加密 | 市佔率高，文件完整 |
+| **SmilePay 速買配** | URL 參數簽章 | 雙協定支援，整合簡單 |
+| **Amego 光貿** | MD5 簽章 (MIG 4.0) | API 設計乾淨 |
+
+---
+
+## 授權
+
+[MIT License](https://github.com/Moksa1123/taiwan-invoice/blob/main/LICENSE)
+
+---
+
+<p align="center">
+  <sub>Made by <strong>Moksa</strong></sub><br>
+  <sub>service@moksaweb.com</sub>
+</p>

package/assets/templates/base/quick-reference.md

@@ -0,0 +1,85 @@
+## When to Apply
+
+Reference these guidelines when:
+- Developing Taiwan E-Invoice issuance functionality
+- Integrating ECPay, SmilePay, or Amego APIs
+- Implementing B2C or B2B invoice logic
+- Handling invoice printing, void, and allowance
+- Troubleshooting invoice API integration issues
+
+## Provider Quick Reference
+
+| Priority | Task | Impact | Provider |
+|----------|------|--------|----------|
+| 1 | Amount Calculation | CRITICAL | All |
+| 2 | Encryption/Signature | CRITICAL | All |
+| 3 | B2B vs B2C Logic | HIGH | All |
+| 4 | Print Response Handling | HIGH | All |
+| 5 | Provider Binding | MEDIUM | All |
+| 6 | Error Handling | MEDIUM | All |
+| 7 | Carrier/Donation | LOW | B2C only |
+
+## Quick Reference
+
+### 1. Amount Calculation (CRITICAL)
+
+- `b2c-tax-inclusive` - B2C uses tax-inclusive total
+- `b2b-split-tax` - B2B requires pre-tax + tax split
+- `round-tax` - Round tax: `Math.round(total - (total / 1.05))`
+- `salesamount` - ECPay/Amego: Use SalesAmount for pre-tax
+
+### 2. Encryption/Signature (CRITICAL)
+
+- `ecpay-aes` - ECPay: AES-128-CBC with HashKey/HashIV
+- `smilepay-verify` - SmilePay: Grvc + Verify_key params
+- `amego-md5` - Amego: MD5(data + time + appKey)
+- `url-encode` - Always URL encode before encryption
+
+### 3. B2B vs B2C Logic (HIGH)
+
+- `buyer-id-b2c` - B2C: BuyerIdentifier = "0000000000"
+- `buyer-id-b2b` - B2B: BuyerIdentifier = actual 8-digit tax ID
+- `no-carrier-b2b` - B2B: Cannot use carrier or donation
+- `validate-taxid` - Validate 8-digit tax ID format
+
+### 4. Print Response Handling (HIGH)
+
+- `ecpay-html` - ECPay: Returns HTML, use window.document.write
+- `smilepay-redirect` - SmilePay: Returns URL, use window.open
+- `amego-pdf` - Amego: Returns PDF URL, use window.open
+- `form-submit` - Some APIs require form POST submission
+
+### 5. Provider Binding (MEDIUM)
+
+- `save-provider` - Save invoiceProvider when issuing
+- `save-random` - Save invoiceRandomNum for printing
+- `match-provider` - Use issuing provider for print/void
+
+### 6. Error Handling (MEDIUM)
+
+- `log-raw-response` - Log complete raw response for debugging
+- `ecpay-codes` - ECPay: Check RtnCode and RtnMsg
+- `smilepay-codes` - SmilePay: Check Status field
+- `amego-codes` - Amego: Check Code and Message
+
+### 7. Carrier/Donation (B2C only)
+
+- `carrier-mobile` - Mobile barcode: /XXXXXXX format
+- `carrier-npc` - Natural person certificate
+- `donation-code` - Donation: 3-7 digit love code
+- `mutual-exclusive` - Carrier and donation are mutually exclusive
+
+## Test Credentials
+
+| Provider | Key Info |
+|----------|----------|
+| ECPay | MerchantID: 2000132, Stage URL |
+| SmilePay | Grvc: SEI1000034, Test Tax ID: 80129529 |
+| Amego | Tax ID: 12345678, test@amego.tw |
+
+## How to Use
+
+See the full skill documentation for detailed API references and code examples.
+
+---
+

package/assets/templates/platforms/{antigravity.json → agent.json}

@@ -1,12 +1,13 @@
 {
   "platform": "antigravity",
-  "displayName": "Google Antigravity",
+  "displayName": "Antigravity / Generic Agent",
   "installType": "full",
   "folderStructure": {
     "root": ".agent",
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {
     "name": "taiwan-invoice",
     "description": "Taiwan E-Invoice API integration specialist for ECPay, SmilePay, and Amego. Provides B2C/B2B invoice issuance, void, allowance, query, and print functionality."
@@ -14,8 +15,10 @@
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/claude.json

@@ -7,6 +7,7 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {
     "name": "taiwan-invoice",
     "description": "Taiwan E-Invoice API integration specialist for ECPay, SmilePay, and Amego. Provides B2C/B2B invoice issuance, void, allowance, query, and print functionality. Includes encryption implementations (AES-128-CBC, MD5), tax calculations, and complete API specifications.",
@@ -15,8 +16,10 @@
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": true
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/codebuddy.json

@@ -7,12 +7,15 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": null,
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/codex.json

@@ -7,6 +7,7 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {
     "name": "taiwan-invoice",
     "description": "Taiwan E-Invoice API integration specialist for ECPay, SmilePay, and Amego."
@@ -14,8 +15,10 @@
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/continue.json

@@ -7,6 +7,7 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {
     "name": "taiwan-invoice",
     "description": "Taiwan E-Invoice API integration specialist for ECPay, SmilePay, and Amego."
@@ -14,8 +15,10 @@
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/copilot.json

@@ -7,12 +7,15 @@
     "skillPath": "prompts/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "prompts/taiwan-invoice/scripts",
   "frontmatter": null,
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/cursor.json

@@ -7,6 +7,7 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {
     "name": "taiwan-invoice",
     "description": "Taiwan E-Invoice API integration specialist for ECPay, SmilePay, and Amego. Provides B2C/B2B invoice issuance, void, allowance, query, and print functionality. Includes encryption implementations (AES-128-CBC, MD5), tax calculations, and complete API specifications."
@@ -14,8 +15,10 @@
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/gemini.json

@@ -7,6 +7,7 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {
     "name": "taiwan-invoice",
     "description": "Taiwan E-Invoice API integration specialist for ECPay, SmilePay, and Amego."
@@ -14,8 +15,10 @@
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/kiro.json

@@ -7,12 +7,15 @@
     "skillPath": "steering/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "steering/taiwan-invoice/scripts",
   "frontmatter": null,
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/opencode.json

@@ -7,12 +7,15 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": null,
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/qoder.json

@@ -7,12 +7,15 @@
     "skillPath": "rules/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "rules/taiwan-invoice/scripts",
   "frontmatter": null,
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/roocode.json

@@ -7,12 +7,15 @@
     "skillPath": "commands/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "commands/taiwan-invoice/scripts",
   "frontmatter": null,
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/trae.json

@@ -7,12 +7,15 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": null,
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/assets/templates/platforms/windsurf.json

@@ -7,6 +7,7 @@
     "skillPath": "skills/taiwan-invoice",
     "filename": "SKILL.md"
   },
+  "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {
     "name": "taiwan-invoice",
     "description": "Taiwan E-Invoice API integration specialist for ECPay, SmilePay, and Amego. Provides B2C/B2B invoice issuance, void, allowance, query, and print functionality."
@@ -14,8 +15,10 @@
   "sections": {
     "examples": true,
     "references": true,
-    "scripts": true
+    "scripts": true,
+    "quickReference": false
   },
   "title": "Taiwan E-Invoice Skill",
-  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations."
+  "description": "Comprehensive guide for Taiwan E-Invoice API integration. Supports ECPay, SmilePay, and Amego providers with B2C/B2B invoice operations.",
+  "skillOrWorkflow": "Skill"
 }

package/dist/index.js

@@ -921,8 +921,8 @@ var require_command = __commonJS({
   "node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("events").EventEmitter;
     var childProcess = require("child_process");
-    var path = require("path");
-    var fs = require("fs");
+    var path3 = require("path");
+    var fs3 = require("fs");
     var process2 = require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1745,10 +1745,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path.resolve(baseDir, baseName);
-          if (fs.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path.extname(baseName))) return void 0;
-          const foundExt = sourceExt.find((ext) => fs.existsSync(`${localBin}${ext}`));
+          const localBin = path3.resolve(baseDir, baseName);
+          if (fs3.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path3.extname(baseName))) return void 0;
+          const foundExt = sourceExt.find((ext) => fs3.existsSync(`${localBin}${ext}`));
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
         }
@@ -1759,23 +1759,23 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs3.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path.resolve(path.dirname(resolvedScriptPath), executableDir);
+          executableDir = path3.resolve(path3.dirname(resolvedScriptPath), executableDir);
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path.basename(this._scriptPath, path.extname(this._scriptPath));
+            const legacyName = path3.basename(this._scriptPath, path3.extname(this._scriptPath));
             if (legacyName !== this._name) {
               localFile = findFile(executableDir, `${legacyName}-${subcommand._name}`);
             }
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path.extname(executableFile));
+        launchWithNode = sourceExt.includes(path3.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -2558,7 +2558,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path.basename(filename, path.extname(filename));
+        this._name = path3.basename(filename, path3.extname(filename));
         return this;
       }
       /**
@@ -2572,9 +2572,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {string|null|Command}
        */
-      executableDir(path2) {
-        if (path2 === void 0) return this._executableDir;
-        this._executableDir = path2;
+      executableDir(path4) {
+        if (path4 === void 0) return this._executableDir;
+        this._executableDir = path4;
         return this;
       }
       /**
@@ -3634,15 +3634,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path = [graph[toModel].parent, toModel];
+      const path3 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path.unshift(graph[cur].parent);
+        path3.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path;
+      fn.conversion = path3;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -3741,10 +3741,10 @@ var require_ansi_styles = __commonJS({
     };
     var ansi2ansi = (n) => n;
     var rgb2rgb = (r, g, b) => [r, g, b];
-    var setLazyProperty = (object, property, get) => {
+    var setLazyProperty = (object, property, get2) => {
       Object.defineProperty(object, property, {
         get: () => {
-          const value = get();
+          const value = get2();
           Object.defineProperty(object, property, {
             value,
             enumerable: true,
@@ -3882,7 +3882,7 @@ var require_has_flag = __commonJS({
 var require_supports_color = __commonJS({
   "node_modules/supports-color/index.js"(exports2, module2) {
     "use strict";
-    var os = require("os");
+    var os2 = require("os");
     var tty = require("tty");
     var hasFlag = require_has_flag();
     var { env } = process;
@@ -3930,7 +3930,7 @@ var require_supports_color = __commonJS({
         return min;
       }
       if (process.platform === "win32") {
-        const osRelease = os.release().split(".");
+        const osRelease = os2.release().split(".");
         if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
           return Number(osRelease[2]) >= 14931 ? 3 : 2;
         }
@@ -6800,7 +6800,7 @@ var require_buffer_list = __commonJS({
         }
       }, {
         key: "join",
-        value: function join3(s) {
+        value: function join5(s) {
           if (this.length === 0) return "";
           var p = this.head;
           var ret = "" + p.data;
@@ -7377,7 +7377,7 @@ var require_stream_writable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._writableState && this._writableState.getBuffer();
       }
     });
@@ -7392,7 +7392,7 @@ var require_stream_writable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._writableState.highWaterMark;
       }
     });
@@ -7562,7 +7562,7 @@ var require_stream_writable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._writableState.length;
       }
     });
@@ -7635,7 +7635,7 @@ var require_stream_writable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         if (this._writableState === void 0) {
           return false;
         }
@@ -7698,7 +7698,7 @@ var require_stream_duplex = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._writableState.highWaterMark;
       }
     });
@@ -7707,7 +7707,7 @@ var require_stream_duplex = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._writableState && this._writableState.getBuffer();
       }
     });
@@ -7716,7 +7716,7 @@ var require_stream_duplex = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._writableState.length;
       }
     });
@@ -7732,7 +7732,7 @@ var require_stream_duplex = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         if (this._readableState === void 0 || this._writableState === void 0) {
           return false;
         }
@@ -8540,7 +8540,7 @@ var require_stream_readable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         if (this._readableState === void 0) {
           return false;
         }
@@ -8823,7 +8823,7 @@ var require_stream_readable = __commonJS({
         if (readable === src) {
           if (unpipeInfo && unpipeInfo.hasUnpiped === false) {
             unpipeInfo.hasUnpiped = true;
-            cleanup();
+            cleanup2();
           }
         }
       }
@@ -8834,7 +8834,7 @@ var require_stream_readable = __commonJS({
       var ondrain = pipeOnDrain(src);
       dest.on("drain", ondrain);
       var cleanedUp = false;
-      function cleanup() {
+      function cleanup2() {
         debug("cleanup");
         dest.removeListener("close", onclose);
         dest.removeListener("finish", onfinish);
@@ -9081,7 +9081,7 @@ var require_stream_readable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._readableState.highWaterMark;
       }
     });
@@ -9090,7 +9090,7 @@ var require_stream_readable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._readableState && this._readableState.buffer;
       }
     });
@@ -9099,7 +9099,7 @@ var require_stream_readable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._readableState.flowing;
       },
       set: function set(state) {
@@ -9114,7 +9114,7 @@ var require_stream_readable = __commonJS({
       // because otherwise some prototype manipulation in
       // userland will fail
       enumerable: false,
-      get: function get() {
+      get: function get2() {
         return this._readableState.length;
       }
     });
@@ -9440,7 +9440,7 @@ var require_BufferList = __commonJS({
       }
       return offset;
     };
-    BufferList.prototype.get = function get(index) {
+    BufferList.prototype.get = function get2(index) {
       if (index > this.length || index < 0) {
         return void 0;
       }
@@ -14965,6 +14965,8 @@ var {
 var import_chalk2 = __toESM(require_source());
 var import_ora = __toESM(require_ora());
 var import_prompts = __toESM(require_prompts3());
+var path2 = __toESM(require("path"));
+var os = __toESM(require("os"));
 
 // src/types/index.ts
 var AI_TYPES = [
@@ -14984,6 +14986,22 @@ var AI_TYPES = [
   "codebuddy",
   "all"
 ];
+var AI_FOLDERS = {
+  claude: [".claude"],
+  cursor: [".cursor"],
+  windsurf: [".windsurf"],
+  antigravity: [".agent"],
+  copilot: [".github"],
+  kiro: [".kiro"],
+  codex: [".codex"],
+  qoder: [".qoder"],
+  roocode: [".roo"],
+  gemini: [".gemini"],
+  trae: [".trae"],
+  opencode: [".opencode"],
+  continue: [".continue"],
+  codebuddy: [".codebuddy"]
+};
 
 // src/utils/template.ts
 var import_promises = require("node:fs/promises");
@@ -14995,7 +15013,7 @@ var AI_TO_PLATFORM = {
   claude: "claude",
   cursor: "cursor",
   windsurf: "windsurf",
-  antigravity: "antigravity",
+  antigravity: "agent",
   copilot: "copilot",
   kiro: "kiro",
   codex: "codex",
@@ -15007,9 +15025,9 @@ var AI_TO_PLATFORM = {
   continue: "continue",
   codebuddy: "codebuddy"
 };
-async function exists(path) {
+async function exists(path3) {
   try {
-    await (0, import_promises.access)(path);
+    await (0, import_promises.access)(path3);
     return true;
   } catch {
     return false;
@@ -15045,6 +15063,13 @@ async function renderSkillFile(config) {
   let content = await loadTemplate("base/skill-content.md");
   const frontmatter = renderFrontmatter(config.frontmatter);
   content = content.replace(/\{\{TITLE\}\}/g, config.title).replace(/\{\{DESCRIPTION\}\}/g, config.description);
+  if (config.sections.quickReference) {
+    try {
+      const quickRef = await loadTemplate("base/quick-reference.md");
+      content = quickRef + "\n" + content;
+    } catch {
+    }
+  }
   return frontmatter + content;
 }
 async function copyTaiwanInvoiceAssets(targetSkillDir, sections) {
@@ -15194,7 +15219,186 @@ ${msg}
   dim: (msg) => console.log(import_chalk.default.dim(msg))
 };
 
+// src/utils/github.ts
+var https = __toESM(require("https"));
+var fs = __toESM(require("fs"));
+var REPO_OWNER = "Moksa1123";
+var REPO_NAME = "taiwan-invoice";
+async function fetchReleases() {
+  return new Promise((resolve, reject) => {
+    const options = {
+      hostname: "api.github.com",
+      path: `/repos/${REPO_OWNER}/${REPO_NAME}/releases`,
+      headers: {
+        "User-Agent": "taiwan-invoice-skill-cli",
+        "Accept": "application/vnd.github.v3+json"
+      }
+    };
+    https.get(options, (res) => {
+      let data = "";
+      res.on("data", (chunk) => data += chunk);
+      res.on("end", () => {
+        if (res.statusCode === 200) {
+          try {
+            resolve(JSON.parse(data));
+          } catch (e) {
+            reject(new Error("Failed to parse GitHub response"));
+          }
+        } else if (res.statusCode === 404) {
+          resolve([]);
+        } else {
+          reject(new Error(`GitHub API error: ${res.statusCode}`));
+        }
+      });
+    }).on("error", reject);
+  });
+}
+async function getLatestRelease() {
+  const releases = await fetchReleases();
+  return releases.length > 0 ? releases[0] : null;
+}
+async function downloadRelease(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest);
+    const request = (downloadUrl) => {
+      https.get(downloadUrl, {
+        headers: {
+          "User-Agent": "taiwan-invoice-skill-cli",
+          "Accept": "application/octet-stream"
+        }
+      }, (res) => {
+        if (res.statusCode === 302 || res.statusCode === 301) {
+          const redirectUrl = res.headers.location;
+          if (redirectUrl) {
+            request(redirectUrl);
+            return;
+          }
+        }
+        if (res.statusCode !== 200) {
+          file.close();
+          fs.unlinkSync(dest);
+          reject(new Error(`Download failed: ${res.statusCode}`));
+          return;
+        }
+        res.pipe(file);
+        file.on("finish", () => {
+          file.close();
+          resolve();
+        });
+      }).on("error", (err) => {
+        file.close();
+        fs.unlinkSync(dest);
+        reject(err);
+      });
+    };
+    request(url);
+  });
+}
+function getSourceZipUrl(release) {
+  return `https://github.com/${REPO_OWNER}/${REPO_NAME}/archive/refs/tags/${release.tag_name}.zip`;
+}
+
+// src/utils/extract.ts
+var fs2 = __toESM(require("fs"));
+var path = __toESM(require("path"));
+var import_child_process = require("child_process");
+async function extractZip(zipPath, destDir) {
+  if (!fs2.existsSync(destDir)) {
+    fs2.mkdirSync(destDir, { recursive: true });
+  }
+  const isWindows = process.platform === "win32";
+  if (isWindows) {
+    const psCommand = `Expand-Archive -Path "${zipPath}" -DestinationPath "${destDir}" -Force`;
+    (0, import_child_process.execSync)(`powershell -Command "${psCommand}"`, { stdio: "pipe" });
+  } else {
+    (0, import_child_process.execSync)(`unzip -o "${zipPath}" -d "${destDir}"`, { stdio: "pipe" });
+  }
+}
+async function copyFolders(sourceDir, targetDir, aiType) {
+  const copiedFolders = [];
+  const foldersToCheck = AI_FOLDERS[aiType];
+  for (const folder of foldersToCheck) {
+    const sourcePath = path.join(sourceDir, folder);
+    const targetPath = path.join(targetDir, folder);
+    if (fs2.existsSync(sourcePath)) {
+      copyDirRecursive(sourcePath, targetPath);
+      copiedFolders.push(folder);
+    }
+  }
+  return copiedFolders;
+}
+function copyDirRecursive(src, dest) {
+  if (!fs2.existsSync(dest)) {
+    fs2.mkdirSync(dest, { recursive: true });
+  }
+  const entries = fs2.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      fs2.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+function findExtractedFolder(destDir) {
+  const entries = fs2.readdirSync(destDir, { withFileTypes: true });
+  const dirs = entries.filter((e) => e.isDirectory());
+  const releaseDir = dirs.find(
+    (d) => d.name.includes("taiwan-invoice") || d.name.startsWith("taiwan-invoice")
+  );
+  return releaseDir ? path.join(destDir, releaseDir.name) : null;
+}
+async function installFromZip(zipPath, targetDir, aiType) {
+  const tempDir = path.join(path.dirname(zipPath), "taiwan-invoice-extracted");
+  if (fs2.existsSync(tempDir)) {
+    fs2.rmSync(tempDir, { recursive: true, force: true });
+  }
+  await extractZip(zipPath, tempDir);
+  const extractedDir = findExtractedFolder(tempDir) || tempDir;
+  const copiedFolders = await copyFolders(extractedDir, targetDir, aiType);
+  return { copiedFolders, tempDir };
+}
+function cleanup(tempDir, zipPath) {
+  if (tempDir && fs2.existsSync(tempDir)) {
+    fs2.rmSync(tempDir, { recursive: true, force: true });
+  }
+  if (zipPath && fs2.existsSync(zipPath)) {
+    fs2.unlinkSync(zipPath);
+  }
+}
+
 // src/commands/init.ts
+async function tryGitHubDownload(aiType, targetDir) {
+  const spinner = (0, import_ora.default)("Checking for latest release on GitHub...").start();
+  try {
+    const release = await getLatestRelease();
+    if (!release) {
+      spinner.info("No releases found, using bundled assets");
+      return { success: false, folders: [] };
+    }
+    spinner.text = `Found release: ${release.tag_name}`;
+    const zipUrl = getSourceZipUrl(release);
+    const tempDir = os.tmpdir();
+    const zipPath = path2.join(tempDir, `taiwan-invoice-${release.tag_name}.zip`);
+    spinner.text = "Downloading release...";
+    await downloadRelease(zipUrl, zipPath);
+    spinner.text = "Extracting and installing...";
+    const { copiedFolders, tempDir: extractedDir } = await installFromZip(zipPath, targetDir, aiType);
+    cleanup(extractedDir, zipPath);
+    if (copiedFolders.length > 0) {
+      spinner.succeed(`Installed from GitHub release ${release.tag_name}`);
+      return { success: true, folders: copiedFolders };
+    } else {
+      spinner.info("No matching folders in release, using bundled assets");
+      return { success: false, folders: [] };
+    }
+  } catch (error) {
+    spinner.info("GitHub download failed, using bundled assets");
+    return { success: false, folders: [] };
+  }
+}
 async function initCommand(options) {
   logger.title("Taiwan Invoice Skill Installer");
   let aiType = options.ai;
@@ -15220,16 +15424,26 @@ async function initCommand(options) {
     aiType = response.aiType;
   }
   logger.info(`Installing for: ${import_chalk2.default.cyan(getAITypeDescription(aiType))}`);
-  const spinner = (0, import_ora.default)("Generating skill files from templates...").start();
   const cwd = process.cwd();
   let copiedFolders = [];
+  let usedGitHub = false;
   try {
-    if (aiType === "all") {
-      copiedFolders = await generateAllPlatformFiles(cwd);
-    } else {
-      copiedFolders = await generatePlatformFiles(cwd, aiType);
+    if (!options.offline && aiType !== "all") {
+      const result = await tryGitHubDownload(aiType, cwd);
+      if (result.success) {
+        copiedFolders = result.folders;
+        usedGitHub = true;
+      }
+    }
+    if (!usedGitHub) {
+      const spinner = (0, import_ora.default)("Generating skill files from bundled templates...").start();
+      if (aiType === "all") {
+        copiedFolders = await generateAllPlatformFiles(cwd);
+      } else {
+        copiedFolders = await generatePlatformFiles(cwd, aiType);
+      }
+      spinner.succeed("Generated from bundled templates!");
     }
-    spinner.succeed("Generated from templates!");
     console.log();
     logger.info("Installed folders:");
     copiedFolders.forEach((folder) => {
@@ -15243,7 +15457,7 @@ async function initCommand(options) {
     console.log(import_chalk2.default.dim('  2. Try: "Help me integrate ECPay invoice API"'));
     console.log();
   } catch (error) {
-    spinner.fail("Installation failed");
+    logger.error("Installation failed");
     if (error instanceof Error) {
       logger.error(error.message);
     }
@@ -15318,21 +15532,11 @@ async function infoCommand() {
 var import_chalk5 = __toESM(require_source());
 var import_ora2 = __toESM(require_ora());
 var VERSION2 = "2.0.0";
-var REPO_API = "https://api.github.com/repos/Moksa1123/taiwan-invoice/releases";
 async function versionsCommand() {
   logger.title("Taiwan Invoice Skill - Available Versions");
   const spinner = (0, import_ora2.default)("Fetching releases from GitHub...").start();
   try {
-    const response = await fetch(REPO_API, {
-      headers: {
-        "Accept": "application/vnd.github.v3+json",
-        "User-Agent": "taiwan-invoice-skill-cli"
-      }
-    });
-    if (!response.ok) {
-      throw new Error(`GitHub API error: ${response.status}`);
-    }
-    const releases = await response.json();
+    const releases = await fetchReleases();
     spinner.succeed("Fetched releases from GitHub");
     console.log();
     console.log(import_chalk5.default.cyan("Available Versions:"));
@@ -15413,7 +15617,8 @@ program2.command("init").description("Install Taiwan Invoice skill to current pr
   await initCommand({
     ai: options.ai,
     force: options.force,
-    global: options.global
+    global: options.global,
+    offline: options.offline
   });
 });
 program2.command("list").description("List supported AI platforms").action(listCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taiwan-invoice-skill",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "CLI to install Taiwan E-Invoice skill for AI coding assistants",
   "bin": {
     "taiwan-invoice": "./dist/index.js"
@@ -10,7 +10,8 @@
     "assets"
   ],
   "scripts": {
-    "build": "node scripts/build.js"
+    "build": "node scripts/build.js",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "taiwan",