@justin_666/square-couplets-master-skills 1.0.1 → 1.0.2

package/README.md

@@ -136,13 +136,46 @@
 
 本專案的 Claude Agent Skills 已發布到 npm，可以通過以下方式安裝：
 
-### 全域安裝（推薦）
+### 全域安裝 CLI（推薦）
 
 ```bash
 npm install -g @justin_666/square-couplets-master-skills
 ```
 
-安裝後，您可以在任何地方使用 `doufang-skills` 命令：
+### 在您的專案中初始化 Skills
+
+安裝後，前往您的專案目錄並初始化 skills：
+
+```bash
+# 前往您的專案
+cd /path/to/your/project
+
+# 為 Cursor 初始化
+doufang init --ai cursor
+
+# 或為 Windsurf 初始化
+doufang init --ai windsurf
+
+# 或為 Antigravity 初始化
+doufang init --ai antigravity
+
+# 或為 Claude Code 初始化
+doufang init --ai claude
+```
+
+### 使用 Slash Command
+
+初始化後，在 Cursor / Windsurf / Antigravity 中使用 slash command：
+
+```
+/doufang Generate a prompt for wealth theme
+/doufang Create a 2K image using Gemini 3 Pro
+/doufang Optimize this prompt to reduce white space
+```
+
+### CLI 工具命令
+
+安裝後，您還可以使用 `doufang-skills` 命令：
 
 ```bash
 # 列出所有可用的 skills

package/bin/doufang-init.js

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+
+/**
+ * Doufang Skills Initialization Tool
+ * Sets up skills for Cursor / Windsurf / Antigravity
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join, resolve } from 'path';
+import { readFileSync, writeFileSync, mkdirSync, existsSync, copyFileSync, statSync, readdirSync } from 'fs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get package root directory
+const packageRoot = resolve(__dirname, '..');
+
+/**
+ * Get the path to skills directory
+ */
+function getSkillsPath() {
+  const possiblePaths = [
+    join(packageRoot, 'skills'),
+    join(packageRoot, 'node_modules', '@justin_666', 'square-couplets-master-skills', 'skills'),
+    join(process.cwd(), 'node_modules', '@justin_666', 'square-couplets-master-skills', 'skills'),
+  ];
+
+  for (const path of possiblePaths) {
+    try {
+      if (statSync(path).isDirectory()) {
+        return path;
+      }
+    } catch (e) {
+      // Path doesn't exist, try next
+    }
+  }
+
+  return join(packageRoot, 'skills');
+}
+
+/**
+ * Copy directory recursively
+ */
+function copyDir(src, dest) {
+  if (!existsSync(dest)) {
+    mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = readdirSync(src, { withFileTypes: true });
+  
+  for (const entry of entries) {
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
+    
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Initialize for Cursor
+ */
+function initCursor(projectPath) {
+  const skillsPath = getSkillsPath();
+  const targetSkillsPath = join(projectPath, 'skills');
+  
+  console.log('📦 Setting up Doufang Skills for Cursor...');
+  
+  // Copy skills directory to project
+  if (existsSync(skillsPath)) {
+    console.log(`   Copying skills from ${skillsPath}...`);
+    copyDir(skillsPath, targetSkillsPath);
+    console.log(`   ✅ Skills copied to ${targetSkillsPath}`);
+  } else {
+    console.error(`   ❌ Skills directory not found at ${skillsPath}`);
+    return false;
+  }
+  
+  // Create .cursorrules file
+  const cursorRulesPath = join(projectPath, '.cursorrules');
+  const cursorRules = `# Doufang Skills Configuration
+
+This project uses Doufang Skills for generating Chinese New Year artwork.
+
+## Available Skills
+
+- \`generate-doufang-prompt\`: Generate professional Doufang artwork prompts
+- \`generate-doufang-image\`: Generate Doufang artwork images using Gemini API
+- \`optimize-doufang-prompt\`: Optimize prompts to reduce white margins
+
+## Usage
+
+Use the slash command: \`/doufang\` followed by your request.
+
+Examples:
+- \`/doufang Generate a prompt for wealth theme\`
+- \`/doufang Create a 2K image using Gemini 3 Pro\`
+- \`/doufang Optimize this prompt to reduce white space\`
+
+Skills are located in the \`skills/\` directory.
+`;
+  
+  writeFileSync(cursorRulesPath, cursorRules);
+  console.log(`   ✅ Created ${cursorRulesPath}`);
+  
+  console.log('\n✨ Cursor setup complete!');
+  console.log('\n📝 Usage:');
+  console.log('   Type "/doufang" in Cursor chat followed by your request');
+  console.log('   Example: /doufang Generate a prompt for wealth theme');
+  
+  return true;
+}
+
+/**
+ * Initialize for Windsurf
+ */
+function initWindsurf(projectPath) {
+  const skillsPath = getSkillsPath();
+  const targetSkillsPath = join(projectPath, 'skills');
+  
+  console.log('📦 Setting up Doufang Skills for Windsurf...');
+  
+  // Copy skills directory
+  if (existsSync(skillsPath)) {
+    console.log(`   Copying skills from ${skillsPath}...`);
+    copyDir(skillsPath, targetSkillsPath);
+    console.log(`   ✅ Skills copied to ${targetSkillsPath}`);
+  } else {
+    console.error(`   ❌ Skills directory not found at ${skillsPath}`);
+    return false;
+  }
+  
+  // Create .windsurfrules file
+  const windsurfRulesPath = join(projectPath, '.windsurfrules');
+  const windsurfRules = `# Doufang Skills Configuration
+
+This project uses Doufang Skills for generating Chinese New Year artwork.
+
+## Available Skills
+
+- \`generate-doufang-prompt\`: Generate professional Doufang artwork prompts
+- \`generate-doufang-image\`: Generate Doufang artwork images using Gemini API
+- \`optimize-doufang-prompt\`: Optimize prompts to reduce white margins
+
+## Usage
+
+Use the slash command: \`/doufang\` followed by your request.
+
+Examples:
+- \`/doufang Generate a prompt for wealth theme\`
+- \`/doufang Create a 2K image using Gemini 3 Pro\`
+- \`/doufang Optimize this prompt to reduce white space\`
+
+Skills are located in the \`skills/\` directory.
+`;
+  
+  writeFileSync(windsurfRulesPath, windsurfRules);
+  console.log(`   ✅ Created ${windsurfRulesPath}`);
+  
+  console.log('\n✨ Windsurf setup complete!');
+  console.log('\n📝 Usage:');
+  console.log('   Type "/doufang" in Windsurf chat followed by your request');
+  console.log('   Example: /doufang Generate a prompt for wealth theme');
+  
+  return true;
+}
+
+/**
+ * Initialize for Antigravity
+ */
+function initAntigravity(projectPath) {
+  const skillsPath = getSkillsPath();
+  const targetSkillsPath = join(projectPath, 'skills');
+  
+  console.log('📦 Setting up Doufang Skills for Antigravity...');
+  
+  // Copy skills directory
+  if (existsSync(skillsPath)) {
+    console.log(`   Copying skills from ${skillsPath}...`);
+    copyDir(skillsPath, targetSkillsPath);
+    console.log(`   ✅ Skills copied to ${targetSkillsPath}`);
+  } else {
+    console.error(`   ❌ Skills directory not found at ${skillsPath}`);
+    return false;
+  }
+  
+  // Create .antigravityrules file
+  const antigravityRulesPath = join(projectPath, '.antigravityrules');
+  const antigravityRules = `# Doufang Skills Configuration
+
+This project uses Doufang Skills for generating Chinese New Year artwork.
+
+## Available Skills
+
+- \`generate-doufang-prompt\`: Generate professional Doufang artwork prompts
+- \`generate-doufang-image\`: Generate Doufang artwork images using Gemini API
+- \`optimize-doufang-prompt\`: Optimize prompts to reduce white margins
+
+## Usage
+
+Use the slash command: \`/doufang\` followed by your request.
+
+Examples:
+- \`/doufang Generate a prompt for wealth theme\`
+- \`/doufang Create a 2K image using Gemini 3 Pro\`
+- \`/doufang Optimize this prompt to reduce white space\`
+
+Skills are located in the \`skills/\` directory.
+`;
+  
+  writeFileSync(antigravityRulesPath, antigravityRules);
+  console.log(`   ✅ Created ${antigravityRulesPath}`);
+  
+  console.log('\n✨ Antigravity setup complete!');
+  console.log('\n📝 Usage:');
+  console.log('   Type "/doufang" in Antigravity chat followed by your request');
+  console.log('   Example: /doufang Generate a prompt for wealth theme');
+  
+  return true;
+}
+
+/**
+ * Main CLI handler
+ */
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  
+  // Parse --ai option
+  let aiOption = null;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--ai' && args[i + 1]) {
+      aiOption = args[i + 1];
+      break;
+    } else if (args[i]?.startsWith('--ai=')) {
+      aiOption = args[i].replace('--ai=', '');
+      break;
+    }
+  }
+  
+  if (command !== 'init') {
+    console.log(`
+Doufang Skills Initialization Tool
+
+Usage:
+  doufang init --ai <ai-assistant>
+
+Options:
+  --ai <assistant>    AI assistant to configure (cursor, windsurf, antigravity, or claude)
+
+Examples:
+  doufang init --ai cursor
+  doufang init --ai windsurf
+  doufang init --ai antigravity
+  doufang init --ai claude
+
+For more information, visit:
+  https://github.com/poirotw66/Square_Couplets_Master
+    `);
+    process.exit(1);
+  }
+  
+  if (!aiOption) {
+    console.error('❌ Error: Please specify an AI assistant with --ai option');
+    console.error('   Example: doufang init --ai cursor');
+    process.exit(1);
+  }
+  
+  const projectPath = process.cwd();
+  const ai = aiOption.toLowerCase();
+  
+  let success = false;
+  
+  switch (ai) {
+    case 'cursor':
+      success = initCursor(projectPath);
+      break;
+    case 'windsurf':
+      success = initWindsurf(projectPath);
+      break;
+    case 'antigravity':
+      success = initAntigravity(projectPath);
+      break;
+    case 'claude':
+      // Claude Code uses same setup as Cursor
+      success = initCursor(projectPath);
+      break;
+    default:
+      console.error(`❌ Error: Unknown AI assistant "${ai}"`);
+      console.error('   Supported: cursor, windsurf, antigravity, claude');
+      process.exit(1);
+  }
+  
+  if (!success) {
+    process.exit(1);
+  }
+}
+
+// Run CLI
+main();

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "@justin_666/square-couplets-master-skills",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Claude Agent Skills for generating Chinese New Year Doufang (diamond-shaped couplet) artwork using Google Gemini AI",
   "type": "module",
   "main": "bin/doufang-skills.js",
   "bin": {
-    "doufang-skills": "bin/doufang-skills.js"
+    "doufang-skills": "bin/doufang-skills.js",
+    "doufang": "bin/doufang-init.js"
   },
   "scripts": {
     "dev": "vite",
     "build": "vite build",
     "preview": "vite preview",
-    "prepublishOnly": "node -e \"require('fs').chmodSync('bin/doufang-skills.js', 0o755)\""
+    "prepublishOnly": "node -e \"const fs = require('fs'); fs.chmodSync('bin/doufang-skills.js', 0o755); fs.chmodSync('bin/doufang-init.js', 0o755);\""
   },
   "keywords": [
     "claude",

package/skills/README.md

@@ -38,13 +38,46 @@ skills 文件位於 `skills/` 目錄中。
 npm install @justin_666/square-couplets-master-skills
 ```
 
-## 🎯 在 Cursor 中使用
+## 🎯 在 Cursor / Windsurf / Antigravity 中使用
 
-### 步驟 1：配置 Cursor 以識別 Skills
+### 快速設置（推薦）
 
-Cursor 會自動掃描專案目錄中的 `skills/` 文件夾。有兩種方式讓 Cursor 找到這些 skills：
+1. **安裝 CLI 工具**：
+   ```bash
+   npm install -g @justin_666/square-couplets-master-skills
+   ```
+
+2. **前往您的專案**：
+   ```bash
+   cd /path/to/your/project
+   ```
+
+3. **初始化 Skills**：
+   ```bash
+   # Cursor
+   doufang init --ai cursor
+   
+   # Windsurf
+   doufang init --ai windsurf
+   
+   # Antigravity
+   doufang init --ai antigravity
+   
+   # Claude Code
+   doufang init --ai claude
+   ```
+
+4. **使用 Slash Command**：
+   在 Cursor / Windsurf / Antigravity 的聊天中輸入：
+   ```
+   /doufang Generate a prompt for wealth theme
+   /doufang Create a 2K image using Gemini 3 Pro
+   /doufang Optimize this prompt to reduce white space
+   ```
+
+### 手動設置
 
-#### 方法 A：在當前專案中使用（推薦）
+如果您想手動設置：
 
 1. **確保 skills 目錄在專案根目錄**：
    ```
@@ -59,29 +92,32 @@ Cursor 會自動掃描專案目錄中的 `skills/` 文件夾。有兩種方式
    └── ...
    ```
 
-2. **或者從 npm 包中引用**：
-   如果已安裝 npm 包，skills 位於：
-   ```
-   node_modules/@justin_666/square-couplets-master-skills/skills/
-   ```
+2. **創建配置文件**：
+   - Cursor: 創建 `.cursorrules` 文件
+   - Windsurf: 創建 `.windsurfrules` 文件
+   - Antigravity: 創建 `.antigravityrules` 文件
 
-#### 方法 B：全局配置（進階）
+### 使用方式
 
-1. 創建一個全局 skills 目錄（例如 `~/.cursor/skills/`）
-2. 將 skills 文件複製到該目錄
-3. 在 Cursor 設置中配置 skills 路徑
+#### Slash Command（推薦）
 
-### 步驟 2：使用 Skills
+使用 `/doufang` 後跟您的請求：
+
+```
+/doufang Generate a prompt for wealth theme
+/doufang Create a 2K image using Gemini 3 Pro
+/doufang Optimize this prompt to reduce white space
+```
 
 #### 自動載入
 
-當您在 Cursor 中輸入相關任務時，對應的 skill 會自動載入：
+當您在對話中輸入相關任務時，對應的 skill 會自動載入：
 
 **示例對話：**
 ```
 您: "幫我生成一個關於財富的春聯斗方 prompt"
-Cursor: [自動載入 generate-doufang-prompt skill]
-      → 生成提示詞和祝福語
+AI: [自動載入 generate-doufang-prompt skill]
+   → 生成提示詞和祝福語
 ```
 
 #### 手動調用