taiwan-invoice-skill 2.0.0 → 2.2.0

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

@@ -0,0 +1,340 @@
+#!/usr/bin/env python3
+"""
+Taiwan Invoice Skill - 加值中心推薦系統
+基於使用者需求推薦最適合的電子發票加值中心
+
+無外部依賴，純 Python 實現
+"""
+
+import csv
+import os
+import sys
+import argparse
+from typing import List, Dict, Any, Optional, Tuple
+
+# 取得 data 目錄路徑
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+DATA_DIR = os.path.join(os.path.dirname(SCRIPT_DIR), 'data')
+
+# 推薦規則定義
+RECOMMENDATION_RULES = {
+    # 關鍵字 → (provider, weight, reason)
+    '穩定': [('ECPay', 3, '市佔率最高，系統穩定性佳')],
+    '市佔': [('ECPay', 3, '台灣電子發票市佔率領先')],
+    '文檔': [('ECPay', 2, '提供完整 API 文檔與 SDK')],
+    'sdk': [('ECPay', 2, '官方 SDK 支援多種語言')],
+    '高交易量': [('ECPay', 3, '適合高交易量電商')],
+    '電商': [('ECPay', 2, '電商整合經驗豐富')],
+
+    '簡單': [('SmilePay', 3, '整合流程最簡單')],
+    '快速': [('SmilePay', 3, '最快速完成整合')],
+    '小型': [('SmilePay', 2, '適合小型專案')],
+    '測試': [('SmilePay', 2, '測試環境設定簡單')],
+    '無加密': [('SmilePay', 3, '無需複雜加密流程')],
+    '便宜': [('SmilePay', 2, '費用較低')],
+
+    'api': [('Amego', 3, 'MIG 4.0 最新 API 標準')],
+    '設計': [('Amego', 2, 'API 設計優良')],
+    '新': [('Amego', 2, '採用最新技術標準')],
+    'mig': [('Amego', 3, '完整支援 MIG 4.0 規範')],
+    '標準': [('Amego', 2, 'API 設計符合業界標準')],
+
+    # B2B/B2C 相關
+    'b2b': [('ECPay', 1, 'B2B 發票功能完整'), ('Amego', 1, 'B2B 計算清晰')],
+    'b2c': [('ECPay', 1, 'B2C 市佔最高'), ('SmilePay', 1, 'B2C 整合簡單')],
+    '統編': [('ECPay', 1, 'B2B 統編發票經驗豐富')],
+
+    # 功能相關
+    '列印': [('ECPay', 2, '列印功能完整'), ('SmilePay', 1, '支援列印')],
+    '作廢': [('ECPay', 1, '作廢流程完整')],
+    '折讓': [('ECPay', 1, '折讓功能完整')],
+    '載具': [('ECPay', 1, '載具支援完整'), ('SmilePay', 1, '載具整合簡單')],
+    '捐贈': [('ECPay', 1, '捐贈功能完整')],
+}
+
+# 反模式警告
+ANTI_PATTERNS = {
+    'ECPay': [
+        ('無技術資源', '加密流程較複雜，需要一定技術能力'),
+        ('極簡整合', '如果只需最簡單整合，SmilePay 可能更適合'),
+    ],
+    'SmilePay': [
+        ('高交易量', '大型電商建議使用 ECPay 以確保穩定性'),
+        ('複雜需求', 'API 功能相對基本，複雜需求可能受限'),
+        ('b2b', 'B2B 發票功能較少文檔'),
+    ],
+    'Amego': [
+        ('市佔', '市佔率相對較低'),
+        ('社群', '社群支援與範例相對較少'),
+        ('穩定', '如果穩定性是首要考量，ECPay 更保險'),
+    ],
+}
+
+
+def load_providers() -> List[Dict[str, str]]:
+    """載入加值中心資料"""
+    filepath = os.path.join(DATA_DIR, 'providers.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]]]:
+    """
+    分析使用者需求，計算各加值中心分數
+
+    Returns:
+        Dict[provider, (score, reasons)]
+    """
+    query_lower = query.lower()
+
+    scores = {
+        'ECPay': (0, []),
+        'SmilePay': (0, []),
+        'Amego': (0, []),
+    }
+
+    # 根據關鍵字累計分數
+    for keyword, rules in RECOMMENDATION_RULES.items():
+        if keyword.lower() in query_lower:
+            for provider, weight, reason in rules:
+                current_score, reasons = scores[provider]
+                if reason not in reasons:
+                    scores[provider] = (current_score + weight, reasons + [reason])
+
+    return scores
+
+
+def get_anti_pattern_warnings(query: str, recommended: str) -> List[str]:
+    """取得反模式警告"""
+    query_lower = query.lower()
+    warnings = []
+
+    if recommended in ANTI_PATTERNS:
+        for keyword, warning in ANTI_PATTERNS[recommended]:
+            if keyword.lower() in query_lower:
+                warnings.append(warning)
+
+    return warnings
+
+
+def recommend(query: str, verbose: bool = False) -> Dict[str, Any]:
+    """
+    推薦加值中心
+
+    Args:
+        query: 使用者需求描述
+        verbose: 是否輸出詳細資訊
+
+    Returns:
+        推薦結果
+    """
+    providers = load_providers()
+    scores = analyze_requirements(query)
+
+    # 排序取得推薦順序
+    sorted_providers = sorted(
+        scores.items(),
+        key=lambda x: x[1][0],
+        reverse=True
+    )
+
+    # 建立結果
+    recommended = sorted_providers[0][0]
+    recommended_score, recommended_reasons = sorted_providers[0]
+
+    # 如果沒有匹配任何關鍵字，給預設推薦
+    if recommended_score == 0:
+        recommended = 'ECPay'
+        recommended_reasons = ['市佔率最高，適合大多數場景', '文檔完整，社群支援豐富']
+        recommended_score = 1
+
+    # 取得加值中心詳細資訊
+    provider_info = None
+    for p in providers:
+        if p.get('provider') == recommended:
+            provider_info = p
+            break
+
+    # 取得警告
+    warnings = get_anti_pattern_warnings(query, recommended)
+
+    result = {
+        'query': query,
+        'recommended': recommended,
+        'score': recommended_score,
+        'reasons': recommended_reasons,
+        'warnings': warnings,
+        'alternatives': [],
+        'provider_info': provider_info,
+    }
+
+    # 加入替代方案
+    for provider, (score, reasons) in sorted_providers[1:]:
+        if score > 0:
+            result['alternatives'].append({
+                'provider': provider,
+                'score': score,
+                'reasons': reasons,
+            })
+
+    return result
+
+
+def format_ascii_box(result: Dict[str, Any]) -> str:
+    """格式化為 ASCII Box 輸出"""
+    width = 70
+    lines = []
+
+    # 頂部邊框
+    lines.append('╔' + '═' * (width - 2) + '╗')
+    lines.append('║' + ' 🎯 加值中心推薦結果 '.center(width - 2) + '║')
+    lines.append('╠' + '═' * (width - 2) + '╣')
+
+    # 查詢內容
+    query_line = f' 需求: {result["query"]}'
+    if len(query_line) > width - 4:
+        query_line = query_line[:width - 7] + '...'
+    lines.append('║' + query_line.ljust(width - 2) + '║')
+    lines.append('╠' + '─' * (width - 2) + '╣')
+
+    # 推薦結果
+    recommended = result['recommended']
+    score = result['score']
+    lines.append('║' + f' ⭐ 推薦: {recommended} (信心分數: {score})'.ljust(width - 2) + '║')
+    lines.append('║' + ' '.ljust(width - 2) + '║')
+
+    # 推薦原因
+    lines.append('║' + ' 📋 推薦原因:'.ljust(width - 2) + '║')
+    for reason in result['reasons']:
+        reason_line = f'    • {reason}'
+        if len(reason_line) > width - 4:
+            reason_line = reason_line[:width - 7] + '...'
+        lines.append('║' + reason_line.ljust(width - 2) + '║')
+
+    # 警告
+    if result['warnings']:
+        lines.append('║' + ' '.ljust(width - 2) + '║')
+        lines.append('║' + ' ⚠️  注意事項:'.ljust(width - 2) + '║')
+        for warning in result['warnings']:
+            warning_line = f'    • {warning}'
+            if len(warning_line) > width - 4:
+                warning_line = warning_line[:width - 7] + '...'
+            lines.append('║' + warning_line.ljust(width - 2) + '║')
+
+    # 替代方案
+    if result['alternatives']:
+        lines.append('║' + ' '.ljust(width - 2) + '║')
+        lines.append('╠' + '─' * (width - 2) + '╣')
+        lines.append('║' + ' 🔄 替代方案:'.ljust(width - 2) + '║')
+        for alt in result['alternatives']:
+            alt_line = f'    • {alt["provider"]} (分數: {alt["score"]})'
+            lines.append('║' + alt_line.ljust(width - 2) + '║')
+            for reason in alt['reasons'][:2]:  # 只顯示前 2 個原因
+                reason_line = f'      - {reason}'
+                if len(reason_line) > width - 4:
+                    reason_line = reason_line[:width - 7] + '...'
+                lines.append('║' + reason_line.ljust(width - 2) + '║')
+
+    # 加值中心資訊
+    if result['provider_info']:
+        info = result['provider_info']
+        lines.append('║' + ' '.ljust(width - 2) + '║')
+        lines.append('╠' + '─' * (width - 2) + '╣')
+        lines.append('║' + f' 📦 {info.get("display_name", recommended)} 資訊:'.ljust(width - 2) + '║')
+        lines.append('║' + f'    認證方式: {info.get("auth_method", "N/A")}'.ljust(width - 2) + '║')
+        lines.append('║' + f'    測試網址: {info.get("test_url", "N/A")}'.ljust(width - 2) + '║')
+        features = info.get('features', '')
+        if features:
+            feat_line = f'    特色: {features}'
+            if len(feat_line) > width - 4:
+                feat_line = feat_line[:width - 7] + '...'
+            lines.append('║' + feat_line.ljust(width - 2) + '║')
+
+    # 底部邊框
+    lines.append('╚' + '═' * (width - 2) + '╝')
+
+    return '\n'.join(lines)
+
+
+def format_json(result: Dict[str, Any]) -> str:
+    """格式化為 JSON 輸出"""
+    import json
+    return json.dumps(result, ensure_ascii=False, indent=2)
+
+
+def format_simple(result: Dict[str, Any]) -> str:
+    """格式化為簡單文字輸出"""
+    lines = []
+    lines.append(f"推薦加值中心: {result['recommended']}")
+    lines.append(f"信心分數: {result['score']}")
+    lines.append("")
+    lines.append("推薦原因:")
+    for reason in result['reasons']:
+        lines.append(f"  - {reason}")
+
+    if result['warnings']:
+        lines.append("")
+        lines.append("注意事項:")
+        for warning in result['warnings']:
+            lines.append(f"  - {warning}")
+
+    if result['alternatives']:
+        lines.append("")
+        lines.append("替代方案:")
+        for alt in result['alternatives']:
+            lines.append(f"  - {alt['provider']} (分數: {alt['score']})")
+
+    return '\n'.join(lines)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='Taiwan Invoice 加值中心推薦系統',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+範例:
+  python recommend.py "電商 高交易量 穩定"
+  python recommend.py "簡單整合 快速上線" --format json
+  python recommend.py "API設計優先 MIG標準" --format simple
+
+關鍵字範例:
+  穩定性: 穩定, 市佔, 高交易量, 電商
+  簡易性: 簡單, 快速, 小型, 測試
+  API品質: api, 設計, 新, mig, 標準
+  功能: b2b, b2c, 列印, 作廢, 折讓, 載具, 捐贈
+"""
+    )
+
+    parser.add_argument('query', help='需求描述 (關鍵字以空格分隔)')
+    parser.add_argument(
+        '-f', '--format',
+        choices=['ascii', 'json', 'simple'],
+        default='ascii',
+        help='輸出格式 (預設: ascii)'
+    )
+    parser.add_argument(
+        '-v', '--verbose',
+        action='store_true',
+        help='顯示詳細資訊'
+    )
+
+    args = parser.parse_args()
+
+    # 執行推薦
+    result = recommend(args.query, args.verbose)
+
+    # 輸出結果
+    if args.format == 'json':
+        print(format_json(result))
+    elif args.format == 'simple':
+        print(format_simple(result))
+    else:
+        print(format_ascii_box(result))
+
+
+if __name__ == '__main__':
+    main()

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

@@ -0,0 +1,201 @@
+#!/usr/bin/env python3
+"""
+Taiwan Invoice Skill - Search CLI
+電子發票智能搜索命令行工具
+
+用法:
+    python search.py "ecpay B2C" --domain operation
+    python search.py "1999 error" --domain error
+    python search.py "稅額計算" --domain tax
+    python search.py "綠界" --all
+"""
+
+import argparse
+import sys
+from typing import Dict, List, Any
+
+from core import (
+    search,
+    search_all,
+    detect_domain,
+    get_available_domains,
+    get_domain_info
+)
+
+
+def format_ascii_box(title: str, content: List[str], width: int = 80) -> str:
+    """
+    格式化 ASCII Box 輸出
+    """
+    lines = []
+    lines.append('┌' + '─' * (width - 2) + '┐')
+    lines.append('│' + f' {title}'.ljust(width - 2) + '│')
+    lines.append('├' + '─' * (width - 2) + '┤')
+
+    for line in content:
+        # 處理過長的行
+        if len(line) > width - 4:
+            line = line[:width - 7] + '...'
+        lines.append('│ ' + line.ljust(width - 4) + ' │')
+
+    lines.append('└' + '─' * (width - 2) + '┘')
+    return '\n'.join(lines)
+
+
+def format_result(result: Dict[str, Any], domain: str) -> List[str]:
+    """
+    格式化單個搜索結果
+    """
+    lines = []
+    score = result.get('_score', 0)
+    lines.append(f'Score: {score}')
+    lines.append('')
+
+    for key, value in result.items():
+        if key == '_score' or not value:
+            continue
+
+        # 截斷過長的值
+        value_str = str(value)
+        if len(value_str) > 60:
+            value_str = value_str[:57] + '...'
+
+        lines.append(f'{key}: {value_str}')
+
+    return lines
+
+
+def format_domain_results(results: List[Dict[str, Any]], domain: str, query: str) -> str:
+    """
+    格式化整個域的搜索結果
+    """
+    if not results:
+        return f"No results found in '{domain}' for query: {query}"
+
+    output = []
+    output.append(f"\n{'='*60}")
+    output.append(f"Domain: {domain.upper()} | Query: {query} | Results: {len(results)}")
+    output.append('='*60)
+
+    for i, result in enumerate(results, 1):
+        lines = format_result(result, domain)
+        box = format_ascii_box(f'Result {i}', lines, width=60)
+        output.append(box)
+        output.append('')
+
+    return '\n'.join(output)
+
+
+def format_all_results(results: Dict[str, List[Dict[str, Any]]], query: str) -> str:
+    """
+    格式化所有域的搜索結果
+    """
+    if not results:
+        return f"No results found for query: {query}"
+
+    output = []
+    output.append(f"\n{'#'*60}")
+    output.append(f"# SEARCH ALL DOMAINS: {query}")
+    output.append('#'*60)
+
+    for domain, domain_results in results.items():
+        output.append(format_domain_results(domain_results, domain, query))
+
+    return '\n'.join(output)
+
+
+def list_domains():
+    """
+    列出所有可用的搜索域
+    """
+    print("\n可用的搜索域 (Available Domains):")
+    print("="*50)
+
+    for domain in get_available_domains():
+        info = get_domain_info(domain)
+        if info:
+            print(f"\n  {domain}")
+            print(f"    檔案: {info['file']}")
+            print(f"    記錄數: {info['total_records']}")
+            print(f"    搜索欄位: {', '.join(info['search_cols'])}")
+
+    print()
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='Taiwan Invoice Skill - BM25 Search Engine',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  python search.py "ecpay B2C"                    # Auto-detect domain
+  python search.py "開立發票" --domain operation  # Search operations
+  python search.py "10000016" --domain error      # Search error codes
+  python search.py "統編" --domain field          # Search field mappings
+  python search.py "B2B 稅額" --domain tax        # Search tax rules
+  python search.py "列印空白" --domain troubleshoot  # Search troubleshooting
+  python search.py "ECPay" --all                  # Search all domains
+  python search.py --list                         # List available domains
+        """
+    )
+
+    parser.add_argument('query', nargs='?', help='Search query')
+    parser.add_argument('-d', '--domain', choices=get_available_domains(),
+                        help='Search domain (auto-detect if not specified)')
+    parser.add_argument('-n', '--max-results', type=int, default=5,
+                        help='Maximum results per domain (default: 5)')
+    parser.add_argument('-a', '--all', action='store_true',
+                        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'],
+                        default='ascii', help='Output format (default: ascii)')
+
+    args = parser.parse_args()
+
+    # 列出域
+    if args.list:
+        list_domains()
+        return
+
+    # 檢查查詢
+    if not args.query:
+        parser.print_help()
+        return
+
+    query = args.query
+
+    # 搜索所有域
+    if args.all:
+        results = search_all(query, args.max_results)
+
+        if args.format == 'json':
+            import json
+            print(json.dumps(results, ensure_ascii=False, indent=2))
+        else:
+            print(format_all_results(results, query))
+        return
+
+    # 單域搜索
+    domain = args.domain
+    if not domain:
+        domain = detect_domain(query)
+        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 == 'simple':
+        for i, result in enumerate(results, 1):
+            print(f"\n[{i}] Score: {result.get('_score', 0)}")
+            for key, value in result.items():
+                if key != '_score' and value:
+                    print(f"  {key}: {value}")
+    else:
+        print(format_domain_results(results, domain, query))
+
+
+if __name__ == '__main__':
+    main()

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"
 }