taiwan-invoice-skill 2.4.3 → 2.5.0

package/README.md

@@ -76,7 +76,17 @@ taiwan-invoice update       # 檢查更新
 ```bash
 taiwan-invoice init --offline   # 跳過 GitHub 下載，使用內建資源
 taiwan-invoice init --force     # 覆蓋現有檔案
-taiwan-invoice init --global    # 安裝到全域目錄
+taiwan-invoice init --global    # 安裝到全域目錄（所有專案共用）
+```
+
+### 全域安裝
+
+使用 `--global` 可將技能安裝到使用者目錄，讓所有專案都能使用：
+
+```bash
+taiwan-invoice init --ai cursor --global       # ~/.cursor/skills/taiwan-invoice/
+taiwan-invoice init --ai claude --global       # ~/.claude/skills/taiwan-invoice/
+taiwan-invoice init --ai antigravity --global  # ~/.gemini/antigravity/global_skills/taiwan-invoice/
 ```
 
 ---

package/assets/templates/platforms/agent.json

@@ -5,7 +5,8 @@
   "folderStructure": {
     "root": ".agent",
     "skillPath": "skills/taiwan-invoice",
-    "filename": "SKILL.md"
+    "filename": "SKILL.md",
+    "globalRoot": "~/.gemini/antigravity/global_skills"
   },
   "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {

package/assets/templates/platforms/claude.json

@@ -5,7 +5,8 @@
   "folderStructure": {
     "root": ".claude",
     "skillPath": "skills/taiwan-invoice",
-    "filename": "SKILL.md"
+    "filename": "SKILL.md",
+    "globalRoot": "~/.claude"
   },
   "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {

package/assets/templates/platforms/codex.json

@@ -5,7 +5,8 @@
   "folderStructure": {
     "root": ".codex",
     "skillPath": "skills/taiwan-invoice",
-    "filename": "SKILL.md"
+    "filename": "SKILL.md",
+    "globalRoot": "~/.codex"
   },
   "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {

package/assets/templates/platforms/cursor.json

@@ -5,7 +5,8 @@
   "folderStructure": {
     "root": ".cursor",
     "skillPath": "skills/taiwan-invoice",
-    "filename": "SKILL.md"
+    "filename": "SKILL.md",
+    "globalRoot": "~/.cursor"
   },
   "scriptPath": "skills/taiwan-invoice/scripts",
   "frontmatter": {

package/dist/index.js

@@ -15940,154 +15940,29 @@ 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) {
+async function generatePlatformFiles(targetDir, aiType, isGlobal = false) {
   const config = await loadPlatformConfig(aiType);
   const createdFolders = [];
-  if (config.installType === "workflow") {
-    const workflowDir = (0, import_node_path.join)(
+  let skillDir;
+  if (isGlobal) {
+    let skillPath = config.folderStructure.skillPath;
+    if (config.folderStructure.globalRoot?.includes("global_skills")) {
+      skillPath = skillPath.replace(/^skills\//, "");
+    }
+    skillDir = (0, import_node_path.join)(targetDir, skillPath);
+    createdFolders.push(targetDir);
+  } else {
+    skillDir = (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,
-    config.folderStructure.skillPath
-  );
   await (0, import_promises.mkdir)(skillDir, { recursive: true });
   const skillContent = await renderSkillFile(config);
   const skillFilePath = (0, import_node_path.join)(skillDir, config.folderStructure.filename);
   await (0, import_promises.writeFile)(skillFilePath, skillContent, "utf-8");
-  createdFolders.push(config.folderStructure.root);
   await copyTaiwanInvoiceAssets(skillDir, config.sections);
   return createdFolders;
 }
@@ -16484,15 +16359,29 @@ async function initCommand(options) {
     }
     aiType = response.aiType;
   }
-  logger.info(`Installing for: ${import_chalk3.default.cyan(getAITypeDescription(aiType))}`);
-  const cwd = process.cwd();
+  let targetDir = process.cwd();
+  if (options.global && aiType !== "all") {
+    try {
+      const config = await loadPlatformConfig(aiType);
+      if (config.folderStructure.globalRoot) {
+        const globalRoot = config.folderStructure.globalRoot.replace(/^~/, os.homedir());
+        targetDir = globalRoot;
+        logger.info(`Installing globally to: ${import_chalk3.default.cyan(targetDir)}`);
+      } else {
+        logger.warn(`Global installation not supported for ${aiType}, using project directory`);
+      }
+    } catch {
+      logger.warn("Failed to load platform config, using project directory");
+    }
+  }
+  logger.info(`Installing for: ${import_chalk3.default.cyan(getAITypeDescription(aiType))}${options.global ? " (global)" : ""}`);
   let copiedFolders = [];
   let usedGitHub = false;
   try {
     if (!options.offline && aiType !== "all") {
       const progress = new InstallProgress(INSTALL_STEPS);
       progress.start();
-      const result = await tryGitHubDownload(aiType, cwd, progress);
+      const result = await tryGitHubDownload(aiType, targetDir, progress);
       if (result.success) {
         copiedFolders = result.folders;
         usedGitHub = true;
@@ -16508,9 +16397,9 @@ async function initCommand(options) {
       await animatedDelay(300);
       progress.nextStep();
       if (aiType === "all") {
-        copiedFolders = await generateAllPlatformFiles(cwd);
+        copiedFolders = await generateAllPlatformFiles(targetDir);
       } else {
-        copiedFolders = await generatePlatformFiles(cwd, aiType);
+        copiedFolders = await generatePlatformFiles(targetDir, aiType, options.global);
       }
       progress.nextStep();
       await animatedDelay(200);

package/package.json

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