taiwan-invoice-skill 2.3.0 → 2.4.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"],
@@ -15093,9 +15093,144 @@ async function copyTaiwanInvoiceAssets(targetSkillDir, sections) {
     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.3.0",
+  "version": "2.4.0",
   "description": "CLI to install Taiwan E-Invoice skill for AI coding assistants",
   "bin": {
     "taiwan-invoice": "./dist/index.js"