@justin_666/square-couplets-master-skills 1.0.4 → 1.0.6

package/bin/doufang-image.js

@@ -7,18 +7,38 @@
 
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
+import { readFileSync } from 'fs';
 import { spawn } from 'child_process';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const packageRoot = resolve(__dirname, '..');
 
+/**
+ * Get package version
+ */
+function getVersion() {
+  try {
+    const packageJsonPath = join(packageRoot, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version || 'unknown';
+  } catch (e) {
+    return 'unknown';
+  }
+}
+
 // Path to the skill script
 const skillScript = join(packageRoot, 'skills', 'generate-doufang-image', 'index.js');
 
 // Forward all arguments to the skill script
 const args = process.argv.slice(2);
 
+// Handle version flag
+if (args[0] === '--version' || args[0] === '-v' || args[0] === 'version') {
+  console.log(getVersion());
+  process.exit(0);
+}
+
 const child = spawn('node', [skillScript, ...args], {
   stdio: 'inherit',
   cwd: process.cwd()

package/bin/doufang-init.js

@@ -15,6 +15,19 @@ const __dirname = dirname(__filename);
 // Get package root directory
 const packageRoot = resolve(__dirname, '..');
 
+/**
+ * Get package version
+ */
+function getVersion() {
+  try {
+    const packageJsonPath = join(packageRoot, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version || 'unknown';
+  } catch (e) {
+    return 'unknown';
+  }
+}
+
 /**
  * Get the path to skills directory
  */
@@ -142,8 +155,18 @@ You are a Doufang assistant. When the user uses the \`/doufang\` command or asks
 
 ## Execution Guidelines
 
-- **Direct CLI Execution**: When user requests Doufang functionality, directly execute the appropriate CLI command using terminal, do NOT create .js files
-- **Read API Key**: Automatically read GEMINI_API_KEY from .env or .env.local file
+- **CRITICAL: Direct CLI Execution Only**: 
+  - When user requests Doufang functionality, you MUST directly execute the CLI command in the terminal
+  - **NEVER create temporary .js, .ts, or any script files**
+  - **NEVER write code to files** - just execute the command directly
+  - Use the terminal/command execution tool to run: \`doufang-prompt\`, \`doufang-image\`, or \`doufang-optimize\`
+  
+- **Command Execution Examples**:
+  - User: "生成財富主題的 prompt" → Execute: \`doufang-prompt "財富"\`
+  - User: "用上述 prompt 生成 2K 圖片" → Execute: \`doufang-image "<prompt>" gemini-3-pro-image-preview 2K\`
+  - User: "優化這個 prompt" → Execute: \`doufang-optimize "<prompt>"\`
+
+- **Read API Key**: Automatically read GEMINI_API_KEY from .env or .env.local file (CLI commands handle this automatically)
 - **Ask for Details**: If user doesn't provide required parameters (like keyword or prompt), ask for clarification
 - **Error Handling**: If API key is missing, guide user to set GEMINI_API_KEY in .env file
 - **Output Format**: For prompt generation, output JSON format. For image generation, save to output/ directory and provide file path
@@ -151,19 +174,27 @@ You are a Doufang assistant. When the user uses the \`/doufang\` command or asks
 ## Common Workflows
 
 ### Generate Image from Keyword
-1. Generate prompt: \`doufang-prompt "財富"\`
+1. Execute: \`doufang-prompt "財富"\` (directly in terminal, no script creation)
 2. Extract imagePrompt from JSON output
-3. Generate image: \`doufang-image "<imagePrompt>" gemini-3-pro-image-preview 2K\`
+3. Execute: \`doufang-image "<imagePrompt>" gemini-3-pro-image-preview 2K\` (directly in terminal, no script creation)
 
 ### Generate Image with Reference
-1. Generate prompt with reference: \`doufang-prompt "健康" images/reference.png\`
+1. Execute: \`doufang-prompt "健康" images/reference.png\` (directly in terminal)
 2. Extract imagePrompt from JSON output
-3. Generate image: \`doufang-image "<imagePrompt>" gemini-3-pro-image-preview 2K images/reference.png\`
+3. Execute: \`doufang-image "<imagePrompt>" gemini-3-pro-image-preview 2K images/reference.png\` (directly in terminal)
 
 ### Optimize and Generate
-1. Generate prompt: \`doufang-prompt "財富"\`
-2. Optimize prompt: \`doufang-optimize "<imagePrompt>"\`
-3. Generate image with optimized prompt: \`doufang-image "<optimizedPrompt>" gemini-3-pro-image-preview 2K\`
+1. Execute: \`doufang-prompt "財富"\` (directly in terminal)
+2. Execute: \`doufang-optimize "<imagePrompt>"\` (directly in terminal)
+3. Execute: \`doufang-image "<optimizedPrompt>" gemini-3-pro-image-preview 2K\` (directly in terminal)
+
+## IMPORTANT REMINDERS
+
+- **DO NOT** create any .js, .ts, .mjs, or script files
+- **DO NOT** write code to files
+- **DO** execute CLI commands directly using terminal/command execution
+- The CLI commands (\`doufang-prompt\`, \`doufang-image\`, \`doufang-optimize\`) are already installed and ready to use
+- Just run the commands - they handle everything automatically
 
 ## Skills Location
 
@@ -308,6 +339,12 @@ function main() {
   const args = process.argv.slice(2);
   const command = args[0];
   
+  // Handle version flag (check before parsing other options)
+  if (command === '--version' || command === '-v' || command === 'version') {
+    console.log(getVersion());
+    process.exit(0);
+  }
+  
   // Parse --ai option
   let aiOption = null;
   for (let i = 0; i < args.length; i++) {
@@ -317,6 +354,9 @@ function main() {
     } else if (args[i]?.startsWith('--ai=')) {
       aiOption = args[i].replace('--ai=', '');
       break;
+    } else if (args[i] === '--version' || args[i] === '-v' || args[i] === 'version') {
+      console.log(getVersion());
+      process.exit(0);
     }
   }
   
@@ -329,6 +369,7 @@ Usage:
 
 Options:
   --ai <assistant>    AI assistant to configure (cursor, windsurf, antigravity, or claude)
+  --version, -v       Show version number
 
 Examples:
   doufang init --ai cursor

package/bin/doufang-optimize.js

@@ -7,18 +7,38 @@
 
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
+import { readFileSync } from 'fs';
 import { spawn } from 'child_process';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const packageRoot = resolve(__dirname, '..');
 
+/**
+ * Get package version
+ */
+function getVersion() {
+  try {
+    const packageJsonPath = join(packageRoot, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version || 'unknown';
+  } catch (e) {
+    return 'unknown';
+  }
+}
+
 // Path to the skill script
 const skillScript = join(packageRoot, 'skills', 'optimize-doufang-prompt', 'index.js');
 
 // Forward all arguments to the skill script
 const args = process.argv.slice(2);
 
+// Handle version flag
+if (args[0] === '--version' || args[0] === '-v' || args[0] === 'version') {
+  console.log(getVersion());
+  process.exit(0);
+}
+
 const child = spawn('node', [skillScript, ...args], {
   stdio: 'inherit',
   cwd: process.cwd()

package/bin/doufang-prompt.js

@@ -7,18 +7,38 @@
 
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
+import { readFileSync } from 'fs';
 import { spawn } from 'child_process';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const packageRoot = resolve(__dirname, '..');
 
+/**
+ * Get package version
+ */
+function getVersion() {
+  try {
+    const packageJsonPath = join(packageRoot, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version || 'unknown';
+  } catch (e) {
+    return 'unknown';
+  }
+}
+
 // Path to the skill script
 const skillScript = join(packageRoot, 'skills', 'generate-doufang-prompt', 'index.js');
 
 // Forward all arguments to the skill script
 const args = process.argv.slice(2);
 
+// Handle version flag
+if (args[0] === '--version' || args[0] === '-v' || args[0] === 'version') {
+  console.log(getVersion());
+  process.exit(0);
+}
+
 const child = spawn('node', [skillScript, ...args], {
   stdio: 'inherit',
   cwd: process.cwd()

package/bin/doufang-skills.js

@@ -15,6 +15,19 @@ const __dirname = dirname(__filename);
 // Get package root directory (parent of bin/)
 const packageRoot = resolve(__dirname, '..');
 
+/**
+ * Get package version
+ */
+function getVersion() {
+  try {
+    const packageJsonPath = join(packageRoot, 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version || 'unknown';
+  } catch (e) {
+    return 'unknown';
+  }
+}
+
 /**
  * Get the path to skills directory
  */
@@ -120,6 +133,12 @@ function main() {
   const args = process.argv.slice(2);
   const command = args[0];
 
+  // Handle version flag
+  if (command === '--version' || command === '-v' || command === 'version') {
+    console.log(getVersion());
+    process.exit(0);
+  }
+  
   if (!command || command === 'list' || command === 'ls') {
     listSkills();
   } else if (command === 'show' || command === 'view') {
@@ -150,6 +169,7 @@ Commands:
   list, ls              List all available skills
   show <skill-name>     Show a specific skill's content
   path <skill-name>     Get the file path to a skill
+  version, --version    Show version number
   help                  Show this help message
 
 Examples:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justin_666/square-couplets-master-skills",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "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",
@@ -59,12 +59,13 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "dependencies": {},
+  "dependencies": {
+    "dotenv": "^17.2.3"
+  },
   "devDependencies": {
     "@google/genai": "^1.37.0",
     "@types/node": "^22.14.0",
     "@vitejs/plugin-react": "^5.0.0",
-    "dotenv": "^17.2.3",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "tsx": "^4.21.0",

package/skills/generate-doufang-image/SKILL.md

@@ -151,6 +151,12 @@ Error: Network connection error. Please check your internet connection and try a
 
 ## Implementation Notes
 
+- **CRITICAL: Use CLI Command Directly**
+  - Execute: `doufang-image <prompt> [model] [size] [reference-image] [output-path]`
+  - **DO NOT create temporary .js, .ts, or any script files**
+  - **DO NOT write code** - just execute the CLI command directly
+  - The CLI command handles all API calls, error handling, and file operations automatically
+
 - Use retry mechanism for transient errors (500, 503, network errors)
 - Compress reference images if they exceed 500KB
 - Validate image formats (JPEG, PNG supported)

package/skills/generate-doufang-image/index.js

@@ -8,7 +8,33 @@
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
 import { readFileSync, writeFileSync, existsSync, statSync, mkdirSync } from 'fs';
-import { config } from 'dotenv';
+import { execSync } from 'child_process';
+import { createRequire } from 'module';
+
+// Load environment variables helper
+async function loadEnvironmentVariables() {
+  try {
+    const dotenv = await import('dotenv');
+    const envLocalPath = join(projectRoot, '.env.local');
+    const envPath = join(projectRoot, '.env');
+    const cwdEnvLocalPath = join(process.cwd(), '.env.local');
+    const cwdEnvPath = join(process.cwd(), '.env');
+
+    if (existsSync(envLocalPath)) {
+      dotenv.config({ path: envLocalPath });
+    } else if (existsSync(envPath)) {
+      dotenv.config({ path: envPath });
+    } else if (existsSync(cwdEnvLocalPath)) {
+      dotenv.config({ path: cwdEnvLocalPath });
+    } else if (existsSync(cwdEnvPath)) {
+      dotenv.config({ path: cwdEnvPath });
+    } else {
+      dotenv.config();
+    }
+  } catch (e) {
+    // dotenv not available, continue without it (will use environment variables)
+  }
+}
 
 // Resolve project root and service path
 const __filename = fileURLToPath(import.meta.url);
@@ -18,10 +44,39 @@ const projectRoot = resolve(skillDir, '../..');
 
 // Try to find services directory
 function findServicesPath() {
+  // Get npm global prefix to find globally installed packages
+  let globalPrefix = null;
+  try {
+    globalPrefix = execSync('npm config get prefix', { encoding: 'utf-8' }).trim();
+  } catch (e) {
+    // Ignore error, try other methods
+  }
+  
+  // Try to resolve package location using createRequire (works in ES modules)
+  let packageRoot = null;
+  try {
+    const require = createRequire(import.meta.url);
+    const packageJsonPath = require.resolve('@justin_666/square-couplets-master-skills/package.json');
+    packageRoot = dirname(packageJsonPath);
+  } catch (e) {
+    // Package not found via require.resolve, will try other paths
+  }
+  
   const possiblePaths = [
+    // Global npm package (highest priority - most reliable for installed packages)
+    ...(globalPrefix ? [
+      join(globalPrefix, 'lib', 'node_modules', '@justin_666', 'square-couplets-master-skills', 'services'),
+      join(globalPrefix, 'node_modules', '@justin_666', 'square-couplets-master-skills', 'services'),
+    ] : []),
+    // From resolved package root (if it has services)
+    ...(packageRoot ? [join(packageRoot, 'services')] : []),
+    // Local project root
     join(projectRoot, 'services'),
+    // Local node_modules
     join(projectRoot, 'node_modules', '@justin_666', 'square-couplets-master-skills', 'services'),
+    // Current working directory
     join(process.cwd(), 'services'),
+    // Current working directory node_modules
     join(process.cwd(), 'node_modules', '@justin_666', 'square-couplets-master-skills', 'services'),
   ];
 
@@ -40,13 +95,19 @@ function findServicesPath() {
 // Load environment variables
 const envLocalPath = join(projectRoot, '.env.local');
 const envPath = join(projectRoot, '.env');
+const cwdEnvLocalPath = join(process.cwd(), '.env.local');
+const cwdEnvPath = join(process.cwd(), '.env');
 
 if (existsSync(envLocalPath)) {
-  config({ path: envLocalPath });
+  dotenvConfig({ path: envLocalPath });
 } else if (existsSync(envPath)) {
-  config({ path: envPath });
+  dotenvConfig({ path: envPath });
+} else if (existsSync(cwdEnvLocalPath)) {
+  dotenvConfig({ path: cwdEnvLocalPath });
+} else if (existsSync(cwdEnvPath)) {
+  dotenvConfig({ path: cwdEnvPath });
 } else {
-  config();
+  dotenvConfig();
 }
 
 async function main() {

package/skills/generate-doufang-prompt/SKILL.md

@@ -106,3 +106,11 @@ When user provides a keyword or wish phrase, generate a professional Doufang art
 - User already has a complete prompt
 - User wants to modify an existing prompt (use `optimize-doufang-prompt` instead)
 - User wants to generate the actual image (use `generate-doufang-image` instead)
+
+## Implementation Notes
+
+- **CRITICAL: Use CLI Command Directly**
+  - Execute: `doufang-prompt <keyword> [reference-image]`
+  - **DO NOT create temporary .js, .ts, or any script files**
+  - **DO NOT write code** - just execute the CLI command directly
+  - The CLI command handles all API calls and returns JSON output automatically

package/skills/generate-doufang-prompt/index.js

@@ -8,7 +8,33 @@
 import { fileURLToPath } from 'url';
 import { dirname, join, resolve } from 'path';
 import { readFileSync, existsSync, statSync } from 'fs';
-import { config } from 'dotenv';
+import { execSync } from 'child_process';
+import { createRequire } from 'module';
+
+// Load environment variables helper
+async function loadEnvironmentVariables() {
+  try {
+    const dotenv = await import('dotenv');
+    const envLocalPath = join(projectRoot, '.env.local');
+    const envPath = join(projectRoot, '.env');
+    const cwdEnvLocalPath = join(process.cwd(), '.env.local');
+    const cwdEnvPath = join(process.cwd(), '.env');
+
+    if (existsSync(envLocalPath)) {
+      dotenv.config({ path: envLocalPath });
+    } else if (existsSync(envPath)) {
+      dotenv.config({ path: envPath });
+    } else if (existsSync(cwdEnvLocalPath)) {
+      dotenv.config({ path: cwdEnvLocalPath });
+    } else if (existsSync(cwdEnvPath)) {
+      dotenv.config({ path: cwdEnvPath });
+    } else {
+      dotenv.config();
+    }
+  } catch (e) {
+    // dotenv not available, continue without it (will use environment variables)
+  }
+}
 
 // Resolve project root and service path
 const __filename = fileURLToPath(import.meta.url);
@@ -18,40 +44,76 @@ const projectRoot = resolve(skillDir, '../..');
 
 // Try to find services directory
 function findServicesPath() {
+  // Get npm global prefix to find globally installed packages
+  let globalPrefix = null;
+  try {
+    globalPrefix = execSync('npm config get prefix', { encoding: 'utf-8' }).trim();
+  } catch (e) {
+    // Ignore error, try other methods
+  }
+  
+  // Try to resolve package location using createRequire (works in ES modules)
+  let packageRoot = null;
+  try {
+    const require = createRequire(import.meta.url);
+    const packageJsonPath = require.resolve('@justin_666/square-couplets-master-skills/package.json');
+    packageRoot = dirname(packageJsonPath);
+  } catch (e) {
+    // Package not found via require.resolve, will try other paths
+  }
+  
   const possiblePaths = [
+    // Global npm package (highest priority - most reliable for installed packages)
+    ...(globalPrefix ? [
+      join(globalPrefix, 'lib', 'node_modules', '@justin_666', 'square-couplets-master-skills', 'services'),
+      join(globalPrefix, 'node_modules', '@justin_666', 'square-couplets-master-skills', 'services'),
+    ] : []),
+    // From resolved package root (if it has services)
+    ...(packageRoot ? [join(packageRoot, 'services')] : []),
+    // Local project root
     join(projectRoot, 'services'),
+    // Local node_modules
     join(projectRoot, 'node_modules', '@justin_666', 'square-couplets-master-skills', 'services'),
+    // Current working directory
     join(process.cwd(), 'services'),
+    // Current working directory node_modules
     join(process.cwd(), 'node_modules', '@justin_666', 'square-couplets-master-skills', 'services'),
   ];
 
+  // Debug: log all paths being checked (only in development)
+  if (process.env.DEBUG_DOUFANG) {
+    console.log('🔍 Checking paths for services directory:');
+    for (const path of possiblePaths) {
+      console.log(`   - ${path} ${existsSync(path) ? '✅' : '❌'}`);
+    }
+  }
+  
   for (const path of possiblePaths) {
     try {
       if (statSync(path).isDirectory()) {
+        if (process.env.DEBUG_DOUFANG) {
+          console.log(`✅ Found services at: ${path}`);
+        }
         return path;
       }
     } catch (e) {
       // Path doesn't exist, try next
     }
   }
+  
+  // If not found, provide helpful error message
+  if (process.env.DEBUG_DOUFANG) {
+    console.log('❌ Services directory not found in any of the checked paths');
+  }
   return null;
 }
 
-// Load environment variables
-const envLocalPath = join(projectRoot, '.env.local');
-const envPath = join(projectRoot, '.env');
-
-if (existsSync(envLocalPath)) {
-  config({ path: envLocalPath });
-} else if (existsSync(envPath)) {
-  config({ path: envPath });
-} else {
-  // Try current working directory
-  config();
-}
 
 async function main() {
   try {
+    // Load environment variables first
+    await loadEnvironmentVariables();
+    
     // Parse command line arguments
     const args = process.argv.slice(2);
     const keyword = args[0];
@@ -87,16 +149,28 @@ async function main() {
     // Dynamic import of service (support both .ts and .js)
     let serviceModule;
     try {
-      // Try .js first (for npm package)
+      // Try .js first (for compiled npm package)
       serviceModule = await import(`file://${join(servicesPath, 'geminiService.js')}`);
     } catch (e) {
       try {
-        // Try .ts (for development)
-        serviceModule = await import(`file://${join(servicesPath, 'geminiService.ts')}`);
+        // Try .ts (for development or source packages)
+        // Node.js cannot directly import .ts files
+        console.error('❌ Error: Cannot import TypeScript service module');
+        console.error('   The package contains TypeScript source files (.ts) which cannot be directly executed');
+        console.error('');
+        console.error('💡 Solution: Use the CLI command instead (recommended):');
+        console.error(`   doufang-prompt "${keyword}"${referenceImagePath ? ` ${referenceImagePath}` : ''}`);
+        console.error('');
+        console.error('   Or if you need to use the script directly:');
+        console.error('   1. Install tsx: npm install -g tsx');
+        console.error(`   2. Run: tsx skills/generate-doufang-prompt/index.js "${keyword}"${referenceImagePath ? ` ${referenceImagePath}` : ''}`);
+        process.exit(1);
       } catch (e2) {
         console.error('❌ Error: Cannot import service module');
         console.error('   Tried:', join(servicesPath, 'geminiService.js'));
         console.error('   Tried:', join(servicesPath, 'geminiService.ts'));
+        console.error('   💡 Solution: Use the CLI command instead:');
+        console.error(`      doufang-prompt "${keyword}"${referenceImagePath ? ` ${referenceImagePath}` : ''}`);
         process.exit(1);
       }
     }

package/skills/optimize-doufang-prompt/SKILL.md

@@ -152,3 +152,11 @@ This skill works best when:
 ## Output Format
 
 Return the optimized prompt as a string, maintaining all other aspects of the original prompt while only modifying the composition and margin-related instructions.
+
+## Implementation Notes
+
+- **CRITICAL: Use CLI Command Directly**
+  - Execute: `doufang-optimize <prompt>`
+  - **DO NOT create temporary .js, .ts, or any script files**
+  - **DO NOT write code** - just execute the CLI command directly
+  - The CLI command handles prompt optimization and returns the optimized prompt automatically