create-takt-sdd 0.1.2 → 0.2.0

package/dist/cli.js

@@ -16,6 +16,8 @@ function parseArgs(argv) {
         help: false,
         version: false,
         tag: undefined,
+        withoutSkills: false,
+        refsPath: "references/takt",
     };
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
@@ -44,6 +46,18 @@ function parseArgs(argv) {
             case "--dry-run":
                 args.dryRun = true;
                 break;
+            case "--without-skills":
+                args.withoutSkills = true;
+                break;
+            case "--refs-path": {
+                const value = argv[++i];
+                if (!value) {
+                    console.error('Error: --refs-path requires a value (e.g. "references/takt")');
+                    process.exit(1);
+                }
+                args.refsPath = value;
+                break;
+            }
             case "-h":
             case "--help":
                 args.help = true;
@@ -76,6 +90,8 @@ async function main() {
         force: args.force,
         dryRun: args.dryRun,
         tag: args.tag,
+        withoutSkills: args.withoutSkills,
+        refsPath: args.refsPath,
         cwd: process.cwd(),
     });
 }

package/dist/generated/takt-ref.js

@@ -0,0 +1,2 @@
+// Auto-generated by scripts/embed-takt-ref.js — do not edit
+export const TAKT_REF_HASH = "78dead335de8ae6d5477eac82c581ce8273ccf35";

package/dist/i18n.js

@@ -7,21 +7,30 @@ const en = {
     dryRunHeader: "[dry-run] The following files would be installed:",
     dryRunItem: (path) => `  ${path}`,
     dryRunSkipped: "[dry-run] No files were written.",
-    taktNotFound: "Warning: takt is not installed. Install it first: https://github.com/nrslib/takt",
     tarNotFound: "Error: tar command is required.",
     archiveError: "Error: .takt/ not found in the downloaded archive.",
     scriptsAdded: (count) => `Added ${count} npm scripts to package.json`,
     scriptsSkipped: (keys) => `Skipped existing scripts: ${keys.join(", ")}`,
-    scriptsCreated: "Created package.json with npm scripts",
+    scriptsCreated: "Created package.json with npm scripts and devDependencies",
+    depsAdded: (keys) => `Added devDependencies: ${keys.join(", ")}`,
+    installingSkills: "Installing takt skills to .agent/skills/...",
+    skillInstalled: (name) => `Installed skill: ${name}`,
+    skillSymlinked: (name, target) => `Symlinked ${target}/${name} -> .agent/skills/${name}`,
+    downloadingTaktRefs: (refsPath) => `Downloading takt builtins to ${refsPath}/...`,
+    taktRefsInstalled: "Installed takt references (builtins, docs)",
+    taktRefsSkipped: "Takt references already exist, skipping",
+    taktRefsError: "Warning: Failed to download takt references. Skills may not find style guides.",
     helpText: `Usage: npx create-takt-sdd [options]
 
 Options:
-  --tag <version>  Version to install ("latest", "0.2.0", default: installer version)
-  --lang <en|ja>   Message language (default: en)
-  --force          Overwrite existing .takt/ directory
-  --dry-run        Preview without writing files
-  -h, --help       Show this help
-  -v, --version    Show version`,
+  --tag <version>    Version to install ("latest", "0.2.0", default: installer version)
+  --lang <en|ja>     Message language (default: en)
+  --force            Overwrite existing .takt/ directory
+  --dry-run          Preview without writing files
+  --without-skills   Skip installing takt skills to .agent/skills/
+  --refs-path <path> Path for takt references (default: references/takt)
+  -h, --help         Show this help
+  -v, --version      Show version`,
     usageExamples: `
   Installed to: .takt/
 
@@ -45,21 +54,30 @@ const ja = {
     dryRunHeader: "[dry-run] 以下のファイルがインストールされます:",
     dryRunItem: (path) => `  ${path}`,
     dryRunSkipped: "[dry-run] ファイルは書き込まれませんでした。",
-    taktNotFound: "警告: takt がインストールされていません。先にインストールしてください: https://github.com/nrslib/takt",
     tarNotFound: "エラー: tar コマンドが必要です。",
     archiveError: "エラー: ダウンロードしたアーカイブに .takt/ が見つかりません。",
     scriptsAdded: (count) => `package.json に ${count} 個の npm scripts を追加しました`,
     scriptsSkipped: (keys) => `既存のスクリプトをスキップしました: ${keys.join(", ")}`,
-    scriptsCreated: "npm scripts 付きの package.json を作成しました",
+    scriptsCreated: "npm scripts と devDependencies 付きの package.json を作成しました",
+    depsAdded: (keys) => `devDependencies を追加しました: ${keys.join(", ")}`,
+    installingSkills: ".agent/skills/ に takt スキルをインストール中...",
+    skillInstalled: (name) => `スキルをインストールしました: ${name}`,
+    skillSymlinked: (name, target) => `シンボリックリンク作成: ${target}/${name} -> .agent/skills/${name}`,
+    downloadingTaktRefs: (refsPath) => `${refsPath}/ に takt ビルトインをダウンロード中...`,
+    taktRefsInstalled: "takt リファレンスをインストールしました（builtins, docs）",
+    taktRefsSkipped: "takt リファレンスは既に存在するためスキップしました",
+    taktRefsError: "警告: takt リファレンスのダウンロードに失敗しました。スキルがスタイルガイドを参照できない可能性があります。",
     helpText: `使い方: npx create-takt-sdd [オプション]
 
 オプション:
-  --tag <version>  インストールするバージョン ("latest", "0.2.0", デフォルト: インストーラのバージョン)
-  --lang <en|ja>   メッセージ言語 (デフォルト: en)
-  --force          既存の .takt/ を上書き
-  --dry-run        プレビューのみ（ファイル書き込みなし）
-  -h, --help       ヘルプを表示
-  -v, --version    バージョンを表示`,
+  --tag <version>    インストールするバージョン ("latest", "0.2.0", デフォルト: インストーラのバージョン)
+  --lang <en|ja>     メッセージ言語 (デフォルト: en)
+  --force            既存の .takt/ を上書き
+  --dry-run          プレビューのみ（ファイル書き込みなし）
+  --without-skills   takt スキルのインストールをスキップ
+  --refs-path <path> takt リファレンスのパス（デフォルト: references/takt）
+  -h, --help         ヘルプを表示
+  -v, --version      バージョンを表示`,
     usageExamples: `
   インストール先: .takt/
 

package/dist/install.js

@@ -1,5 +1,5 @@
 import { execSync } from "node:child_process";
-import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, symlinkSync, statSync, writeFileSync } from "node:fs";
 import https from "node:https";
 import { createWriteStream } from "node:fs";
 import { mkdtempSync } from "node:fs";
@@ -7,6 +7,7 @@ import { tmpdir } from "node:os";
 import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { getMessages } from "./i18n.js";
+import { TAKT_REF_HASH } from "./generated/takt-ref.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 function getInstallerVersion() {
@@ -15,7 +16,9 @@ function getInstallerVersion() {
     return pkg.version;
 }
 const REPO = "j5ik2o/takt-sdd";
+const TAKT_REPO = "nrslib/takt";
 const TARGET_DIR = ".takt";
+const DEFAULT_REFS_PATH = "references/takt";
 const FACET_DIRS = [
     "pieces",
     "personas",
@@ -24,6 +27,19 @@ const FACET_DIRS = [
     "knowledge",
     "output-contracts",
 ];
+const TAKT_SKILLS = [
+    "takt-analyze",
+    "takt-facet",
+    "takt-optimize",
+    "takt-piece",
+];
+const SKILL_SYMLINK_TARGETS = [
+    ".claude/skills",
+    ".codex/skills",
+];
+const SDD_DEV_DEPENDENCIES = {
+    "takt": "^0.20.0",
+};
 const SDD_SCRIPTS = {
     "sdd": "takt --pipeline --skip-git --create-worktree no -w sdd -t",
     "sdd:requirements": "takt --pipeline --skip-git --create-worktree no -w sdd-requirements -t",
@@ -134,13 +150,6 @@ function collectFiles(dir, base) {
 export async function install(options) {
     const msg = getMessages(options.lang);
     const targetPath = join(options.cwd, TARGET_DIR);
-    // takt の存在チェック
-    try {
-        execSync("which takt", { stdio: "ignore" });
-    }
-    catch {
-        warn(msg.taktNotFound);
-    }
     // tar の存在チェック
     try {
         execSync("which tar", { stdio: "ignore" });
@@ -173,16 +182,27 @@ export async function install(options) {
         if (options.dryRun) {
             info(msg.dryRunHeader);
             for (const dir of FACET_DIRS) {
-                const srcDir = join(extractedTakt, dir);
+                const srcDir = join(extractedTakt, options.lang, dir);
                 if (existsSync(srcDir)) {
-                    for (const file of collectFiles(srcDir, extractedTakt)) {
+                    for (const file of collectFiles(srcDir, join(extractedTakt, options.lang))) {
                         console.log(msg.dryRunItem(join(TARGET_DIR, file)));
                     }
                 }
             }
-            const gitignoreSrc = join(extractedTakt, ".gitignore");
-            if (existsSync(gitignoreSrc)) {
-                console.log(msg.dryRunItem(join(TARGET_DIR, ".gitignore")));
+            if (!options.withoutSkills) {
+                for (const skill of TAKT_SKILLS) {
+                    const skillSrc = join(extractedDir, ".agent", "skills", skill);
+                    if (existsSync(skillSrc)) {
+                        for (const file of collectFiles(skillSrc, join(extractedDir, ".agent", "skills"))) {
+                            console.log(msg.dryRunItem(join(".agent", "skills", file)));
+                        }
+                        for (const target of SKILL_SYMLINK_TARGETS) {
+                            console.log(msg.dryRunItem(`${target}/${skill} -> ../../.agent/skills/${skill}`));
+                        }
+                    }
+                }
+                console.log(msg.dryRunItem(`${options.refsPath}/builtins/`));
+                console.log(msg.dryRunItem(`${options.refsPath}/docs/`));
             }
             console.log("");
             info(msg.dryRunSkipped);
@@ -192,7 +212,7 @@ export async function install(options) {
         info(msg.installing);
         mkdirSync(targetPath, { recursive: true });
         for (const dir of FACET_DIRS) {
-            const srcDir = join(extractedTakt, dir);
+            const srcDir = join(extractedTakt, options.lang, dir);
             if (existsSync(srcDir)) {
                 const destDir = join(targetPath, dir);
                 if (existsSync(destDir)) {
@@ -201,12 +221,94 @@ export async function install(options) {
                 cpSync(srcDir, destDir, { recursive: true });
             }
         }
-        // .gitignore
-        const gitignoreSrc = join(extractedTakt, ".gitignore");
-        if (existsSync(gitignoreSrc)) {
-            cpSync(gitignoreSrc, join(targetPath, ".gitignore"));
+        // .gitignore は takt が初回実行時に自動配置するため、インストーラでは生成しない
+        // takt スキルのインストール
+        const agentSkillsDir = join(options.cwd, ".agent", "skills");
+        const extractedSkillsDir = join(extractedDir, ".agent", "skills");
+        if (!options.withoutSkills && existsSync(extractedSkillsDir)) {
+            info(msg.installingSkills);
+            mkdirSync(agentSkillsDir, { recursive: true });
+            for (const skill of TAKT_SKILLS) {
+                const skillSrc = join(extractedSkillsDir, skill);
+                if (!existsSync(skillSrc))
+                    continue;
+                const skillDest = join(agentSkillsDir, skill);
+                if (existsSync(skillDest)) {
+                    rmSync(skillDest, { recursive: true });
+                }
+                cpSync(skillSrc, skillDest, { recursive: true });
+                // SKILL.md 内の references/takt パスを置換
+                if (options.refsPath !== DEFAULT_REFS_PATH) {
+                    const skillMd = join(skillDest, "SKILL.md");
+                    if (existsSync(skillMd)) {
+                        const content = readFileSync(skillMd, "utf-8");
+                        const updated = content.replaceAll(DEFAULT_REFS_PATH, options.refsPath);
+                        writeFileSync(skillMd, updated, "utf-8");
+                    }
+                }
+                info(msg.skillInstalled(skill));
+            }
+            // .claude/skills/ と .codex/skills/ にシンボリックリンクを作成
+            for (const target of SKILL_SYMLINK_TARGETS) {
+                const targetDir = join(options.cwd, target);
+                mkdirSync(targetDir, { recursive: true });
+                for (const skill of TAKT_SKILLS) {
+                    if (!existsSync(join(agentSkillsDir, skill)))
+                        continue;
+                    const linkPath = join(targetDir, skill);
+                    if (existsSync(linkPath)) {
+                        rmSync(linkPath, { recursive: true });
+                    }
+                    symlinkSync(`../../.agent/skills/${skill}`, linkPath);
+                    info(msg.skillSymlinked(skill, target));
+                }
+            }
         }
-        // package.json に npm scripts を追加
+        // takt リファレンスのダウンロード（スキルが参照するbuiltins等）
+        if (!options.withoutSkills) {
+            const refsDir = join(options.cwd, options.refsPath);
+            if (!existsSync(join(refsDir, "builtins"))) {
+                info(msg.downloadingTaktRefs(options.refsPath));
+                const taktTmpDir = mkdtempSync(join(tmpdir(), "takt-refs-"));
+                try {
+                    const taktArchive = join(taktTmpDir, "takt.tar.gz");
+                    const taktTarball = `https://github.com/${TAKT_REPO}/archive/${TAKT_REF_HASH}.tar.gz`;
+                    await download(taktTarball, taktArchive);
+                    execSync(`tar -xzf "${taktArchive}" -C "${taktTmpDir}"`, { stdio: "ignore" });
+                    // takt-{hash}/ ディレクトリを探す
+                    const taktExtracted = readdirSync(taktTmpDir).find((d) => d.startsWith("takt-") && statSync(join(taktTmpDir, d)).isDirectory());
+                    if (taktExtracted) {
+                        const taktRoot = join(taktTmpDir, taktExtracted);
+                        mkdirSync(refsDir, { recursive: true });
+                        // builtins/ をコピー
+                        const builtinsSrc = join(taktRoot, "builtins");
+                        if (existsSync(builtinsSrc)) {
+                            cpSync(builtinsSrc, join(refsDir, "builtins"), { recursive: true });
+                        }
+                        // docs/faceted-prompting.ja.md をコピー
+                        const fpSrc = join(taktRoot, "docs", "faceted-prompting.ja.md");
+                        if (existsSync(fpSrc)) {
+                            mkdirSync(join(refsDir, "docs"), { recursive: true });
+                            cpSync(fpSrc, join(refsDir, "docs", "faceted-prompting.ja.md"));
+                        }
+                        info(msg.taktRefsInstalled);
+                    }
+                    else {
+                        warn(msg.taktRefsError);
+                    }
+                }
+                catch {
+                    warn(msg.taktRefsError);
+                }
+                finally {
+                    rmSync(taktTmpDir, { recursive: true, force: true });
+                }
+            }
+            else {
+                info(msg.taktRefsSkipped);
+            }
+        }
+        // package.json に npm scripts と devDependencies を追加
         const pkgPath = join(options.cwd, "package.json");
         if (existsSync(pkgPath)) {
             const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
@@ -223,6 +325,15 @@ export async function install(options) {
                 }
             }
             pkg.scripts = scripts;
+            const devDeps = pkg.devDependencies ?? {};
+            const depsAdded = [];
+            for (const [key, value] of Object.entries(SDD_DEV_DEPENDENCIES)) {
+                if (devDeps[key] === undefined) {
+                    devDeps[key] = value;
+                    depsAdded.push(key);
+                }
+            }
+            pkg.devDependencies = devDeps;
             writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
             if (added.length > 0) {
                 info(msg.scriptsAdded(added.length));
@@ -230,11 +341,15 @@ export async function install(options) {
             if (skipped.length > 0) {
                 warn(msg.scriptsSkipped(skipped));
             }
+            if (depsAdded.length > 0) {
+                info(msg.depsAdded(depsAdded));
+            }
         }
         else {
             const pkg = {
                 private: true,
                 scripts: { ...SDD_SCRIPTS },
+                devDependencies: { ...SDD_DEV_DEPENDENCIES },
             };
             writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
             info(msg.scriptsCreated);

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "create-takt-sdd",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Installer for takt-sdd: Spec-Driven Development workflow for takt",
   "type": "module",
   "bin": {
     "create-takt-sdd": "./dist/cli.js"
   },
   "scripts": {
-    "build": "tsc && node scripts/add-shebang.js",
+    "build": "node scripts/embed-takt-ref.js && tsc && node scripts/add-shebang.js",
     "prepare": "npm run build"
   },
   "keywords": [