taiwan-invoice-skill 2.2.0 → 2.4.0

package/README.md

@@ -119,6 +119,23 @@ taiwan-invoice init --global    # 安裝到全域目錄
 
 ---
 
+## 智能工具
+
+安裝後包含以下 Python 工具（純 Python，無需外部依賴）：
+
+```bash
+# BM25 搜索引擎 - 搜索錯誤碼、欄位映射、稅務規則
+python scripts/search.py "10000016" --domain error
+
+# 加值中心推薦系統 - 根據需求推薦服務商
+python scripts/recommend.py "電商 高交易量 穩定"
+
+# 代碼生成器 - 生成 TypeScript/Python 服務模組
+python scripts/generate-invoice-service.py ECPay --output ts
+```
+
+---
+
 ## 授權
 
 [MIT License](https://github.com/Moksa1123/taiwan-invoice/blob/main/LICENSE)

package/assets/taiwan-invoice/SKILL.md

@@ -21,7 +21,8 @@ user-invocable: true
 - `scripts/search.py` - BM25 搜索引擎（查詢 API、錯誤碼、欄位映射）
 - `scripts/recommend.py` - 加值中心推薦系統
 - `scripts/generate-invoice-service.py` - 服務代碼生成器
-- `data/` - CSV 數據檔（providers, operations, error-codes, field-mappings, tax-rules, troubleshooting）
+- `scripts/persist.py` - 持久化配置工具（MASTER.md 生成）
+- `data/` - CSV 數據檔（providers, operations, error-codes, field-mappings, tax-rules, troubleshooting, reasoning）
 
 ### 何時使用此技能
 - 開發電子發票開立功能
@@ -66,6 +67,7 @@ python scripts/search.py "折讓" --format json
 | `field` | 欄位映射 | field-mappings.csv |
 | `tax` | 稅務計算規則 | tax-rules.csv |
 | `troubleshoot` | 疑難排解 | troubleshooting.csv |
+| `reasoning` | 推薦決策規則 | reasoning.csv |
 
 ### 推薦系統 (recommend.py)
 
@@ -108,6 +110,37 @@ python scripts/generate-invoice-service.py SmilePay --output py
 python scripts/generate-invoice-service.py Amego --output ts > amego-service.ts
 ```
 
+### 持久化配置 (persist.py)
+
+將發票配置保存為 MASTER.md，供 AI 助手持續參考：
+
+```bash
+# 初始化配置
+python scripts/persist.py init ECPay
+python scripts/persist.py init SmilePay -p "MyProject"
+
+# 顯示當前配置
+python scripts/persist.py show
+
+# 列出可用服務商
+python scripts/persist.py list
+
+# 強制覆蓋
+python scripts/persist.py init Amego --force
+```
+
+**生成結構：**
+```
+invoice-config/
+└── MASTER.md       # 專案發票配置
+    ├── 基本資訊
+    ├── 服務商配置
+    ├── API 端點
+    ├── 發票類型設定
+    ├── 環境變數建議
+    └── 開發檢查清單
+```
+
 ---
 
 ## 發票類型

package/assets/taiwan-invoice/data/reasoning.csv

@@ -0,0 +1,32 @@
+scenario,recommended_provider,confidence,reason,decision_rules,anti_patterns,use_cases
+高交易量電商,ECPay,HIGH,市佔率最高 系統穩定性佳,volume>1000/day AND priority=stability,避免使用測試環境長期運行,大型電商平台 購物網站
+穩定性優先,ECPay,HIGH,台灣電子發票市佔率領先,priority=stability OR risk_tolerance=low,避免頻繁切換服務商,金融相關 醫療系統
+完整文檔需求,ECPay,HIGH,提供完整 API 文檔與 SDK,priority=documentation OR team_size>3,避免依賴社群資源,企業級開發 團隊協作
+多語言SDK需求,ECPay,MEDIUM,官方SDK支援多種語言,language IN (java php dotnet) AND need_sdk=true,避免自行實作加密,Java/.NET專案
+簡單整合需求,SmilePay,HIGH,整合流程最簡單 無需複雜加密,priority=speed OR deadline<7days,避免過度設計,MVP開發 快速上線
+小型專案,SmilePay,HIGH,適合小型專案和個人開發者,team_size<=2 AND budget=low,避免過度工程化,個人專案 小型網站
+快速上線,SmilePay,HIGH,最快速完成整合,deadline<14days AND complexity=low,避免完美主義,緊急專案 POC驗證
+測試環境友善,SmilePay,MEDIUM,測試環境設定簡單,phase=development OR phase=testing,避免正式環境測試,開發階段 測試階段
+低預算專案,SmilePay,MEDIUM,費用相對較低,budget=low AND volume<500/day,避免過度投資,新創公司 個人開發
+API設計優先,Amego,HIGH,MIG 4.0 最新 API 標準,priority=api_design OR tech_stack=modern,避免使用舊版API,技術導向團隊
+現代技術棧,Amego,HIGH,採用最新技術標準,framework IN (nextjs nuxt sveltekit),避免傳統架構,現代前端專案
+RESTful需求,Amego,MEDIUM,API設計符合REST規範,priority=clean_code AND experience>3years,避免過度抽象,資深開發團隊
+MIG標準合規,Amego,HIGH,完整支援MIG 4.0規範,compliance=mig40 OR government=true,避免自定義協議,政府專案 標準合規
+B2B發票為主,ECPay,MEDIUM,B2B發票功能完整 經驗豐富,invoice_type=b2b AND volume>100/day,避免B2C邏輯套用B2B,企業對企業交易
+B2C發票為主,ECPay,MEDIUM,B2C市佔最高 問題解決資源多,invoice_type=b2c AND support_need=high,避免忽視客服需求,一般消費者交易
+B2C簡單整合,SmilePay,MEDIUM,B2C整合最簡單,invoice_type=b2c AND priority=speed,避免過度複雜化,簡單B2C場景
+混合發票需求,ECPay,MEDIUM,同時支援B2B/B2C 切換彈性,invoice_type=mixed,避免硬編碼發票類型,B2B+B2C混合
+載具功能需求,ECPay,MEDIUM,載具支援最完整,feature=carrier AND carrier_type IN (mobile barcode),避免忽略載具驗證,手機條碼整合
+捐贈功能需求,ECPay,MEDIUM,捐贈功能完整,feature=donation,避免捐贈與載具混用,公益捐贈整合
+列印功能需求,ECPay,MEDIUM,列印功能完整 多種格式,feature=print AND print_format IN (a4 thermal),避免忽略隨機碼,實體發票列印
+作廢功能需求,ECPay,LOW,作廢流程標準化,feature=void,避免作廢後重開相同號碼,發票作廢處理
+折讓功能需求,ECPay,LOW,折讓功能完整,feature=allowance,避免折讓超過原發票金額,退款折讓處理
+無技術資源,SmilePay,HIGH,無需複雜加密 整合門檻最低,tech_resource=limited OR developer_count=1,避免選擇高複雜度方案,一人團隊 非技術背景
+AES加密經驗,ECPay,MEDIUM,需要AES-128-CBC加密經驗,encryption_experience=aes,避免明文傳輸,有加密經驗團隊
+MD5簽章經驗,Amego,MEDIUM,使用MD5簽章驗證,encryption_experience=md5,避免簽章順序錯誤,有MD5經驗團隊
+Node.js專案,ECPay,MEDIUM,官方有Node.js範例,language=nodejs AND need_example=true,避免從零實作加密,Node.js開發
+Python專案,ECPay,MEDIUM,社群Python範例豐富,language=python,避免依賴過時範例,Python開發
+PHP專案,ECPay,HIGH,官方PHP SDK最完整,language=php AND need_sdk=true,避免版本不相容,PHP開發
+新創公司,SmilePay,MEDIUM,快速上線 成本控制,company_type=startup AND phase=early,避免過度投資基礎建設,早期新創
+企業級應用,ECPay,HIGH,穩定性和支援優先,company_type=enterprise,避免使用非主流方案,大型企業
+政府專案,Amego,MEDIUM,MIG標準合規,project_type=government,避免非標準協議,政府標案

package/assets/taiwan-invoice/scripts/core.py

@@ -47,6 +47,11 @@ CSV_CONFIG = {
         'file': 'troubleshooting.csv',
         'search_cols': ['issue', 'symptom', 'cause', 'solution', 'provider', 'category'],
         'output_cols': ['issue', 'symptom', 'cause', 'solution', 'provider', 'severity']
+    },
+    'reasoning': {
+        'file': 'reasoning.csv',
+        'search_cols': ['scenario', 'recommended_provider', 'reason', 'decision_rules', 'use_cases'],
+        'output_cols': ['scenario', 'recommended_provider', 'confidence', 'reason', 'anti_patterns', 'use_cases']
     }
 }
 
@@ -57,7 +62,8 @@ DOMAIN_KEYWORDS = {
     'error': ['error', 'code', '錯誤', '代碼', '失敗', 'fail', '-', '10000', '1001', '2001'],
     'field': ['field', 'param', '欄位', '參數', 'mapping', '映射', 'merchantid', 'orderid', 'buyername'],
     'tax': ['tax', 'b2c', 'b2b', '稅', '應稅', '免稅', '零稅率', 'salesamount', 'taxamount', '計算'],
-    'troubleshoot': ['問題', 'issue', 'error', 'fix', '解決', '失敗', '空白', 'troubleshoot', '踩坑']
+    'troubleshoot': ['問題', 'issue', 'error', 'fix', '解決', '失敗', '空白', 'troubleshoot', '踩坑'],
+    'reasoning': ['推薦', 'recommend', '選擇', 'choose', '適合', 'suitable', '場景', 'scenario', '決策', 'decision']
 }
 
 

package/assets/taiwan-invoice/scripts/persist.py

@@ -0,0 +1,330 @@
+#!/usr/bin/env python3
+"""
+Taiwan Invoice Skill - 持久化模式
+將發票配置保存為 MASTER.md，供 AI 助手持續參考
+
+用法:
+    python persist.py init ECPay           # 初始化 ECPay 配置
+    python persist.py init SmilePay        # 初始化 SmilePay 配置
+    python persist.py show                 # 顯示當前配置
+    python persist.py update --key xxx     # 更新配置
+"""
+
+import os
+import sys
+import argparse
+from datetime import datetime
+from typing import Dict, Any, Optional
+
+# 取得 data 目錄路徑
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+DATA_DIR = os.path.join(os.path.dirname(SCRIPT_DIR), 'data')
+
+# 預設配置目錄
+DEFAULT_CONFIG_DIR = 'invoice-config'
+MASTER_FILENAME = 'MASTER.md'
+
+# 服務商配置模板
+PROVIDER_CONFIGS = {
+    'ECPay': {
+        'display_name': '綠界科技',
+        'auth_method': 'AES-128-CBC',
+        'test_url': 'https://einvoice-stage.ecpay.com.tw',
+        'prod_url': 'https://einvoice.ecpay.com.tw',
+        'test_merchant_id': '2000132',
+        'test_hash_key': 'ejCk326UnaZWKisg',
+        'test_hash_iv': 'q9jcZX8Ib9LM8wYk',
+        'endpoints': {
+            'issue_b2c': '/B2CInvoice/Issue',
+            'issue_b2b': '/B2BInvoice/Issue',
+            'void': '/Invoice/IssueInvalid',
+            'allowance': '/Invoice/AllowanceByCollegiate',
+            'print': '/Invoice/Print',
+        },
+        'encryption': 'URL Encode → AES-128-CBC → Base64',
+    },
+    'SmilePay': {
+        'display_name': '速買配',
+        'auth_method': 'Verify_key',
+        'test_url': 'https://ssl.smse.com.tw/api_test',
+        'prod_url': 'https://ssl.smse.com.tw/api',
+        'test_merchant_id': 'SEI1000034',
+        'test_hash_key': '9D73935693EE0237FABA6AB744E48661',
+        'test_hash_iv': '',
+        'endpoints': {
+            'issue': '/SPEinvoice_Storage.asp',
+            'void': '/SPEinvoice_Invalid.asp',
+            'allowance': '/SPEinvoice_AllowanceByCollegiate.asp',
+            'print': '/SPEinvoice_Print_Single.asp',
+        },
+        'encryption': 'URL Parameters + Verify_key',
+    },
+    'Amego': {
+        'display_name': '光貿科技',
+        'auth_method': 'MD5 Signature',
+        'test_url': 'https://invoice-api.amego.tw',
+        'prod_url': 'https://invoice-api.amego.tw',
+        'test_merchant_id': '12345678',
+        'test_hash_key': 'sHeq7t8G1wiQvhAuIM27',
+        'test_hash_iv': '',
+        'endpoints': {
+            'issue': '/api/invoice/issue',
+            'void': '/api/invoice/void',
+            'allowance': '/api/invoice/allowance',
+            'print': '/api/invoice/print',
+        },
+        'encryption': 'JSON + MD5(data + time + appKey)',
+    },
+}
+
+
+def generate_master_md(provider: str, project_name: str = '', custom_config: Optional[Dict] = None) -> str:
+    """
+    生成 MASTER.md 內容
+    """
+    if provider not in PROVIDER_CONFIGS:
+        raise ValueError(f"Unknown provider: {provider}")
+
+    config = PROVIDER_CONFIGS[provider].copy()
+    if custom_config:
+        config.update(custom_config)
+
+    now = datetime.now().strftime('%Y-%m-%d %H:%M')
+
+    content = f"""# Taiwan Invoice - 專案配置
+
+> 此檔案為 AI 助手的持久化配置，請勿手動刪除
+
+## 基本資訊
+
+| 項目 | 值 |
+|------|-----|
+| **專案名稱** | {project_name or '未命名專案'} |
+| **加值中心** | {config['display_name']} ({provider}) |
+| **建立時間** | {now} |
+| **環境** | 測試環境 |
+
+---
+
+## 服務商配置
+
+### {config['display_name']} ({provider})
+
+**認證方式**: {config['auth_method']}
+
+**API 端點**:
+- 測試: `{config['test_url']}`
+- 正式: `{config['prod_url']}`
+
+**測試憑證**:
+```
+MerchantID: {config['test_merchant_id']}
+HashKey: {config['test_hash_key']}
+HashIV: {config['test_hash_iv'] or 'N/A'}
+```
+
+**加密流程**:
+```
+{config['encryption']}
+```
+
+---
+
+## API 端點
+
+| 操作 | 端點 |
+|------|------|
+"""
+
+    for op, endpoint in config['endpoints'].items():
+        content += f"| {op} | `{endpoint}` |\n"
+
+    content += f"""
+---
+
+## 發票類型設定
+
+### B2C (二聯式)
+
+- 金額: **含稅價**
+- BuyerIdentifier: `0000000000`
+- TaxAmount: `0`
+- 可使用載具/捐贈
+
+### B2B (三聯式)
+
+- 金額: **未稅價**
+- 需填寫統編 (8碼)
+- 需計算稅額: `TaxAmount = round(Total - Total/1.05)`
+- **不可**使用載具/捐贈
+
+---
+
+## 環境變數建議
+
+```env
+# {config['display_name']} 配置
+INVOICE_PROVIDER={provider}
+INVOICE_MERCHANT_ID=
+INVOICE_HASH_KEY=
+INVOICE_HASH_IV=
+INVOICE_ENV=test
+```
+
+---
+
+## 開發檢查清單
+
+- [ ] 設定環境變數
+- [ ] 實作加密/解密函數
+- [ ] 建立 InvoiceService 介面
+- [ ] 實作 {provider}InvoiceService
+- [ ] 處理 B2C/B2B 金額計算差異
+- [ ] 儲存 invoiceProvider 和 randomNumber
+- [ ] 實作錯誤處理與 logger
+- [ ] 測試環境驗證
+
+---
+
+## 注意事項
+
+1. **randomNumber**: 開立成功後務必儲存，列印時需要
+2. **invoiceProvider**: 開立時儲存使用的服務商，列印時使用
+3. **時間戳記**: {"ECPay 需在 10 分鐘內" if provider == 'ECPay' else "Amego 需在 60 秒內" if provider == 'Amego' else "注意伺服器時間"}
+4. **載具與捐贈**: 互斥，不可同時設定
+
+---
+
+*Generated by Taiwan Invoice Skill v2.3.0*
+"""
+
+    return content
+
+
+def init_config(provider: str, target_dir: str, project_name: str = '', force: bool = False) -> str:
+    """
+    初始化配置
+    """
+    config_dir = os.path.join(target_dir, DEFAULT_CONFIG_DIR)
+    master_path = os.path.join(config_dir, MASTER_FILENAME)
+
+    # 檢查是否已存在
+    if os.path.exists(master_path) and not force:
+        raise FileExistsError(f"Config already exists: {master_path}. Use --force to overwrite.")
+
+    # 建立目錄
+    os.makedirs(config_dir, exist_ok=True)
+
+    # 生成內容
+    content = generate_master_md(provider, project_name)
+
+    # 寫入檔案
+    with open(master_path, 'w', encoding='utf-8') as f:
+        f.write(content)
+
+    return master_path
+
+
+def show_config(target_dir: str) -> Optional[str]:
+    """
+    顯示當前配置
+    """
+    master_path = os.path.join(target_dir, DEFAULT_CONFIG_DIR, MASTER_FILENAME)
+
+    if not os.path.exists(master_path):
+        return None
+
+    with open(master_path, 'r', encoding='utf-8') as f:
+        return f.read()
+
+
+def format_ascii_box(title: str, content: str, width: int = 70) -> str:
+    """
+    格式化 ASCII Box
+    """
+    lines = []
+    lines.append('╔' + '═' * (width - 2) + '╗')
+    lines.append('║' + f' {title}'.center(width - 2) + '║')
+    lines.append('╠' + '═' * (width - 2) + '╣')
+
+    for line in content.split('\n'):
+        if len(line) > width - 4:
+            line = line[:width - 7] + '...'
+        lines.append('║' + ' ' + line.ljust(width - 4) + ' ' + '║')
+
+    lines.append('╚' + '═' * (width - 2) + '╝')
+    return '\n'.join(lines)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='Taiwan Invoice - 持久化配置工具',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  python persist.py init ECPay                    # 初始化 ECPay 配置
+  python persist.py init SmilePay -p "MyProject"  # 指定專案名稱
+  python persist.py show                          # 顯示當前配置
+  python persist.py init Amego --force            # 強制覆蓋
+        """
+    )
+
+    subparsers = parser.add_subparsers(dest='command', help='Commands')
+
+    # init 命令
+    init_parser = subparsers.add_parser('init', help='Initialize configuration')
+    init_parser.add_argument('provider', choices=['ECPay', 'SmilePay', 'Amego'],
+                             help='Invoice provider')
+    init_parser.add_argument('-p', '--project', default='',
+                             help='Project name')
+    init_parser.add_argument('-d', '--dir', default='.',
+                             help='Target directory (default: current)')
+    init_parser.add_argument('-f', '--force', action='store_true',
+                             help='Force overwrite existing config')
+
+    # show 命令
+    show_parser = subparsers.add_parser('show', help='Show current configuration')
+    show_parser.add_argument('-d', '--dir', default='.',
+                             help='Target directory (default: current)')
+
+    # list 命令
+    list_parser = subparsers.add_parser('list', help='List available providers')
+
+    args = parser.parse_args()
+
+    if args.command == 'init':
+        try:
+            path = init_config(args.provider, args.dir, args.project, args.force)
+            print(format_ascii_box(
+                '✓ Configuration Initialized',
+                f"Provider: {args.provider}\nPath: {path}\n\nNext: Set your credentials in the MASTER.md file"
+            ))
+        except FileExistsError as e:
+            print(f"Error: {e}")
+            sys.exit(1)
+        except ValueError as e:
+            print(f"Error: {e}")
+            sys.exit(1)
+
+    elif args.command == 'show':
+        content = show_config(args.dir)
+        if content:
+            print(content)
+        else:
+            print("No configuration found. Run 'python persist.py init <provider>' to create one.")
+
+    elif args.command == 'list':
+        print("\nAvailable Providers:")
+        print("=" * 50)
+        for provider, config in PROVIDER_CONFIGS.items():
+            print(f"\n  {provider}")
+            print(f"    {config['display_name']}")
+            print(f"    Auth: {config['auth_method']}")
+        print()
+
+    else:
+        parser.print_help()
+
+
+if __name__ == '__main__':
+    main()

package/assets/taiwan-invoice/scripts/recommend.py

@@ -82,6 +82,17 @@ def load_providers() -> List[Dict[str, str]]:
         return list(reader)
 
 
+def load_reasoning_rules() -> List[Dict[str, str]]:
+    """載入推理規則"""
+    filepath = os.path.join(DATA_DIR, 'reasoning.csv')
+    if not os.path.exists(filepath):
+        return []
+
+    with open(filepath, 'r', encoding='utf-8') as f:
+        reader = csv.DictReader(f)
+        return list(reader)
+
+
 def analyze_requirements(query: str) -> Dict[str, Tuple[int, List[str]]]:
     """
     分析使用者需求，計算各加值中心分數
@@ -97,7 +108,29 @@ def analyze_requirements(query: str) -> Dict[str, Tuple[int, List[str]]]:
         'Amego': (0, []),
     }
 
-    # 根據關鍵字累計分數
+    # 從 reasoning.csv 載入規則
+    reasoning_rules = load_reasoning_rules()
+    confidence_weights = {'HIGH': 3, 'MEDIUM': 2, 'LOW': 1}
+
+    for rule in reasoning_rules:
+        scenario = rule.get('scenario', '').lower()
+        use_cases = rule.get('use_cases', '').lower()
+
+        # 檢查場景或使用案例是否匹配查詢
+        scenario_words = scenario.replace(' ', '')
+        if any(word in query_lower for word in scenario.split()) or \
+           any(word in query_lower for word in use_cases.split()):
+            provider = rule.get('recommended_provider', '')
+            confidence = rule.get('confidence', 'LOW')
+            reason = rule.get('reason', '')
+
+            if provider in scores:
+                weight = confidence_weights.get(confidence, 1)
+                current_score, reasons = scores[provider]
+                if reason and reason not in reasons:
+                    scores[provider] = (current_score + weight, reasons + [reason])
+
+    # 根據關鍵字累計分數 (fallback)
     for keyword, rules in RECOMMENDATION_RULES.items():
         if keyword.lower() in query_lower:
             for provider, weight, reason in rules:

package/assets/taiwan-invoice/scripts/search.py

@@ -23,22 +23,29 @@ from core import (
 )
 
 
-def format_ascii_box(title: str, content: List[str], width: int = 80) -> str:
+def format_ascii_box(title: str, content: List[str], width: int = 80, style: str = 'double') -> str:
     """
     格式化 ASCII Box 輸出
+
+    style: 'single' (─│) or 'double' (═║)
     """
+    if style == 'double':
+        h, v, tl, tr, bl, br, lm, rm = '═', '║', '╔', '╗', '╚', '╝', '╠', '╣'
+    else:
+        h, v, tl, tr, bl, br, lm, rm = '─', '│', '┌', '┐', '└', '┘', '├', '┤'
+
     lines = []
-    lines.append('┌' + '─' * (width - 2) + '┐')
-    lines.append('│' + f' {title}'.ljust(width - 2) + '│')
-    lines.append('├' + '─' * (width - 2) + '┤')
+    lines.append(tl + h * (width - 2) + tr)
+    lines.append(v + f' {title}'.ljust(width - 2) + v)
+    lines.append(lm + h * (width - 2) + rm)
 
     for line in content:
         # 處理過長的行
         if len(line) > width - 4:
             line = line[:width - 7] + '...'
-        lines.append('│ ' + line.ljust(width - 4) + ' │')
+        lines.append(v + ' ' + line.ljust(width - 4) + ' ' + v)
 
-    lines.append('└' + '─' * (width - 2) + '┘')
+    lines.append(bl + h * (width - 2) + br)
     return '\n'.join(lines)
 
 
@@ -104,6 +111,66 @@ def format_all_results(results: Dict[str, List[Dict[str, Any]]], query: str) ->
     return '\n'.join(output)
 
 
+def format_markdown_result(result: Dict[str, Any], index: int) -> str:
+    """
+    格式化單個結果為 Markdown
+    """
+    lines = []
+    score = result.get('_score', 0)
+    lines.append(f"### Result {index} (Score: {score})")
+    lines.append("")
+
+    for key, value in result.items():
+        if key == '_score' or not value:
+            continue
+        lines.append(f"- **{key}**: {value}")
+
+    lines.append("")
+    return '\n'.join(lines)
+
+
+def format_markdown_domain(results: List[Dict[str, Any]], domain: str, query: str) -> str:
+    """
+    格式化域結果為 Markdown
+    """
+    if not results:
+        return f"No results found in '{domain}' for query: {query}\n"
+
+    lines = []
+    lines.append(f"## {domain.upper()}")
+    lines.append(f"")
+    lines.append(f"> Query: `{query}` | Results: {len(results)}")
+    lines.append("")
+
+    for i, result in enumerate(results, 1):
+        lines.append(format_markdown_result(result, i))
+
+    return '\n'.join(lines)
+
+
+def format_markdown_all(results: Dict[str, List[Dict[str, Any]]], query: str) -> str:
+    """
+    格式化所有域結果為 Markdown
+    """
+    if not results:
+        return f"# No results found for query: {query}\n"
+
+    lines = []
+    lines.append(f"# Taiwan Invoice Search Results")
+    lines.append(f"")
+    lines.append(f"**Query**: `{query}`")
+    lines.append(f"")
+    lines.append("---")
+    lines.append("")
+
+    for domain, domain_results in results.items():
+        lines.append(format_markdown_domain(domain_results, domain, query))
+        lines.append("---")
+        lines.append("")
+
+    return '\n'.join(lines)
+
+
 def list_domains():
     """
     列出所有可用的搜索域
@@ -148,7 +215,7 @@ Examples:
                         help='Search all domains')
     parser.add_argument('-l', '--list', action='store_true',
                         help='List available domains')
-    parser.add_argument('-f', '--format', choices=['ascii', 'simple', 'json'],
+    parser.add_argument('-f', '--format', choices=['ascii', 'simple', 'json', 'markdown', 'md'],
                         default='ascii', help='Output format (default: ascii)')
 
     args = parser.parse_args()
@@ -172,6 +239,8 @@ Examples:
         if args.format == 'json':
             import json
             print(json.dumps(results, ensure_ascii=False, indent=2))
+        elif args.format in ('markdown', 'md'):
+            print(format_markdown_all(results, query))
         else:
             print(format_all_results(results, query))
         return
@@ -180,13 +249,16 @@ Examples:
     domain = args.domain
     if not domain:
         domain = detect_domain(query)
-        print(f"[Auto-detected domain: {domain}]")
+        if args.format not in ('json', 'markdown', 'md'):
+            print(f"[Auto-detected domain: {domain}]")
 
     results = search(query, domain, args.max_results)
 
     if args.format == 'json':
         import json
         print(json.dumps(results, ensure_ascii=False, indent=2))
+    elif args.format in ('markdown', 'md'):
+        print(format_markdown_domain(results, domain, query))
     elif args.format == 'simple':
         for i, result in enumerate(results, 1):
             print(f"\n[{i}] Score: {result.get('_score', 0)}")

package/assets/templates/platforms/agent.json

@@ -1,16 +1,18 @@
 {
   "platform": "antigravity",
   "displayName": "Antigravity / Generic Agent",
-  "installType": "full",
+  "installType": "workflow",
   "folderStructure": {
     "root": ".agent",
-    "skillPath": "skills/taiwan-invoice",
-    "filename": "SKILL.md"
+    "skillPath": "workflows",
+    "filename": "taiwan-invoice.md",
+    "sharedRoot": ".shared",
+    "sharedPath": "taiwan-invoice"
   },
-  "scriptPath": "skills/taiwan-invoice/scripts",
+  "scriptPath": ".shared/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."
+    "description": "Taiwan E-Invoice API integration for ECPay, SmilePay, and Amego",
+    "auto_execution_mode": "3"
   },
   "sections": {
     "examples": true,
@@ -18,7 +20,7 @@
     "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.",
-  "skillOrWorkflow": "Skill"
+  "title": "taiwan-invoice",
+  "description": "台灣電子發票 API 整合工具。支援 ECPay、SmilePay、Amego 三家加值中心的 B2C/B2B 發票開立、作廢、折讓、查詢、列印功能。",
+  "skillOrWorkflow": "Workflow"
 }

package/dist/index.js

@@ -14990,7 +14990,7 @@ var AI_FOLDERS = {
   claude: [".claude"],
   cursor: [".cursor"],
   windsurf: [".windsurf"],
-  antigravity: [".agent"],
+  antigravity: [".agent", ".shared"],
   copilot: [".github"],
   kiro: [".kiro"],
   codex: [".codex"],
@@ -15087,10 +15087,150 @@ async function copyTaiwanInvoiceAssets(targetSkillDir, sections) {
     await (0, import_promises.mkdir)(scriptsTarget, { recursive: true });
     await (0, import_promises.cp)((0, import_node_path.join)(sourceDir, "scripts"), scriptsTarget, { recursive: true });
   }
+  if (sections.scripts && await exists((0, import_node_path.join)(sourceDir, "data"))) {
+    const dataTarget = (0, import_node_path.join)(targetSkillDir, "data");
+    await (0, import_promises.mkdir)(dataTarget, { recursive: true });
+    await (0, import_promises.cp)((0, import_node_path.join)(sourceDir, "data"), dataTarget, { recursive: true });
+  }
+}
+async function renderWorkflowFile(config) {
+  const frontmatter = renderFrontmatter(config.frontmatter);
+  const sharedPath = config.folderStructure.sharedPath || "taiwan-invoice";
+  const content = `# ${config.title}
+
+${config.description}
+
+## Prerequisites
+
+Check if Python is installed:
+
+\`\`\`bash
+python3 --version || python --version
+\`\`\`
+
+---
+
+## How to Use This Workflow
+
+When user requests Taiwan E-Invoice work (issue, void, allowance, print, query), follow this workflow:
+
+### Step 1: Analyze User Requirements
+
+Extract key information:
+- **Provider**: ECPay, SmilePay, or Amego
+- **Invoice type**: B2C (\u4E8C\u806F\u5F0F) or B2B (\u4E09\u806F\u5F0F)
+- **Operation**: issue, void, allowance, print, query
+
+### Step 2: Recommend Provider (Optional)
+
+\`\`\`bash
+python3 .shared/${sharedPath}/scripts/recommend.py "<keywords>"
+\`\`\`
+
+Example:
+\`\`\`bash
+python3 .shared/${sharedPath}/scripts/recommend.py "\u96FB\u5546 \u9AD8\u4EA4\u6613\u91CF \u7A69\u5B9A"
+\`\`\`
+
+### Step 3: Search for Information
+
+\`\`\`bash
+python3 .shared/${sharedPath}/scripts/search.py "<keyword>" --domain <domain>
+\`\`\`
+
+Available domains:
+| Domain | Description |
+|--------|-------------|
+| provider | Provider comparison |
+| operation | API endpoints |
+| error | Error codes |
+| field | Field mappings |
+| tax | Tax rules |
+| troubleshoot | Troubleshooting |
+
+### Step 4: Generate Service Code
+
+\`\`\`bash
+python3 .shared/${sharedPath}/scripts/generate-invoice-service.py <Provider> --output ts
+\`\`\`
+
+### Step 5: Initialize Project Config (Optional)
+
+\`\`\`bash
+python3 .shared/${sharedPath}/scripts/persist.py init <Provider>
+\`\`\`
+
+---
+
+## Quick Reference
+
+### B2C Invoice (\u4E8C\u806F\u5F0F)
+- Amount: **Tax-inclusive**
+- BuyerIdentifier: \`0000000000\`
+- TaxAmount: \`0\`
+- Can use carrier/donation
+
+### B2B Invoice (\u4E09\u806F\u5F0F)
+- Amount: **Tax-exclusive**
+- Must fill 8-digit tax ID
+- Calculate tax: \`TaxAmount = round(Total - Total/1.05)\`
+- **Cannot** use carrier/donation
+
+---
+
+## Test Credentials
+
+### ECPay
+\`\`\`
+MerchantID: 2000132
+HashKey: ejCk326UnaZWKisg
+HashIV: q9jcZX8Ib9LM8wYk
+\`\`\`
+
+### SmilePay
+\`\`\`
+Grvc: SEI1000034
+Verify_key: 9D73935693EE0237FABA6AB744E48661
+\`\`\`
+
+### Amego
+\`\`\`
+Invoice: 12345678
+App Key: sHeq7t8G1wiQvhAuIM27
+\`\`\`
+
+---
+
+*Generated by Taiwan Invoice Skill*
+`;
+  return frontmatter + content;
 }
 async function generatePlatformFiles(targetDir, aiType) {
   const config = await loadPlatformConfig(aiType);
   const createdFolders = [];
+  if (config.installType === "workflow") {
+    const workflowDir = (0, import_node_path.join)(
+      targetDir,
+      config.folderStructure.root,
+      config.folderStructure.skillPath
+    );
+    await (0, import_promises.mkdir)(workflowDir, { recursive: true });
+    const workflowContent = await renderWorkflowFile(config);
+    const workflowFilePath = (0, import_node_path.join)(workflowDir, config.folderStructure.filename);
+    await (0, import_promises.writeFile)(workflowFilePath, workflowContent, "utf-8");
+    createdFolders.push(config.folderStructure.root);
+    if (config.folderStructure.sharedRoot && config.folderStructure.sharedPath) {
+      const sharedDir = (0, import_node_path.join)(
+        targetDir,
+        config.folderStructure.sharedRoot,
+        config.folderStructure.sharedPath
+      );
+      await (0, import_promises.mkdir)(sharedDir, { recursive: true });
+      await copyTaiwanInvoiceAssets(sharedDir, config.sections);
+      createdFolders.push(config.folderStructure.sharedRoot);
+    }
+    return createdFolders;
+  }
   const skillDir = (0, import_node_path.join)(
     targetDir,
     config.folderStructure.root,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taiwan-invoice-skill",
-  "version": "2.2.0",
+  "version": "2.4.0",
   "description": "CLI to install Taiwan E-Invoice skill for AI coding assistants",
   "bin": {
     "taiwan-invoice": "./dist/index.js"