@k2works/claude-code-booster 1.6.0 → 1.8.0

package/lib/assets/.claude/skills/analyzing-business/SKILL.md

@@ -24,7 +24,7 @@ description: ビジネスアーキテクチャ分析を支援。要件定義の
 
 ### 4. 成果物
 
-- @docs/design/business_architecture.md - ビジネスアーキテクチャ分析書
+- @docs/analysis/business_architecture.md - ビジネスアーキテクチャ分析書
 
 ### 5. 作業内容
 

package/lib/assets/ops/scripts/mkdocs.js

@@ -3,27 +3,27 @@
 import { execSync } from 'child_process';
 import fs from 'fs';
 import path from 'path';
-
-const isWindows = process.platform === 'win32';
+import { cleanDockerEnv, isDockerAvailable, openUrl } from './shared.js';
 
 /**
- * Windows 環境で DOCKER_HOST を正規化した環境変数を返す
- * @returns {NodeJS.ProcessEnv}
+ * docker compose コマンドを実行
+ * @param {string} args - docker compose に渡す引数
  */
-function dockerEnv() {
-  const env = { ...process.env };
-  if (isWindows && env.DOCKER_HOST === 'npipe://./pipe/docker_engine') {
-    env.DOCKER_HOST = 'npipe:////./pipe/docker_engine';
-  }
-  return env;
+function dockerCompose(args) {
+  execSync(`docker compose ${args}`, { stdio: 'inherit', env: cleanDockerEnv() });
 }
 
 /**
- * docker compose コマンドを実行
- * @param {string} args - docker compose に渡す引数
+ * Docker が利用可能か確認し、不可なら警告メッセージを表示して false を返す
+ * @returns {boolean} Docker が利用可能なら true
  */
-function dockerCompose(args) {
-  execSync(`docker compose ${args}`, { stdio: 'inherit', env: dockerEnv() });
+function requireDocker() {
+  if (isDockerAvailable()) {
+    return true;
+  }
+  console.warn('Warning: Docker is not running. Skipping this task.');
+  console.warn('Please start Docker Desktop and try again.');
+  return false;
 }
 
 /**
@@ -32,6 +32,7 @@ function dockerCompose(args) {
  */
 export default function (gulp) {
   gulp.task('mkdocs:serve', (done) => {
+    if (!requireDocker()) { done(); return; }
     try {
       console.log('Starting MkDocs server...');
       dockerCompose('up -d mkdocs');
@@ -43,6 +44,7 @@ export default function (gulp) {
   });
 
   gulp.task('mkdocs:build', (done) => {
+    if (!requireDocker()) { done(); return; }
     try {
       console.log('Building MkDocs documentation...');
       const siteDir = path.join(process.cwd(), 'site');
@@ -58,6 +60,7 @@ export default function (gulp) {
   });
 
   gulp.task('mkdocs:stop', (done) => {
+    if (!requireDocker()) { done(); return; }
     try {
       console.log('Stopping MkDocs server...');
       dockerCompose('down');
@@ -70,8 +73,7 @@ export default function (gulp) {
 
   gulp.task('mkdocs:open', (done) => {
     try {
-      const command = isWindows ? 'start http://localhost:8000' : 'open http://localhost:8000';
-      execSync(command, { stdio: 'inherit' });
+      openUrl('http://localhost:8000');
       done();
     } catch (error) {
       done(error);

package/lib/assets/ops/scripts/shared.js

@@ -0,0 +1,40 @@
+'use strict';
+
+import { execSync } from 'child_process';
+
+/**
+ * DOCKER_HOST を除外した環境変数を返す
+ * Docker Desktop 使用時に DOCKER_HOST が設定されていると接続エラーが発生するため除外する
+ * @returns {Object} DOCKER_HOST を除外した環境変数
+ */
+export function cleanDockerEnv() {
+  const env = { ...process.env };
+  delete env.DOCKER_HOST;
+  return env;
+}
+
+/**
+ * Docker デーモンが利用可能か確認する
+ * @returns {boolean} Docker が利用可能なら true
+ */
+export function isDockerAvailable() {
+  try {
+    execSync('docker info', { stdio: 'ignore', env: cleanDockerEnv() });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * URL をデフォルトブラウザで開く（クロスプラットフォーム対応）
+ * @param {string} url - 開く URL
+ */
+export function openUrl(url) {
+  const platform = process.platform;
+  const cmd =
+    platform === 'win32' ? `start "" "${url}"` :
+    platform === 'darwin' ? `open "${url}"` :
+    `xdg-open "${url}"`;
+  execSync(cmd, { stdio: 'ignore' });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k2works/claude-code-booster",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "AI Agent Development Support Tool",
   "main": "main.js",
   "bin": {