prizmkit 1.0.14 → 1.0.15

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.14",
-  "bundledAt": "2026-03-15T11:21:10.029Z",
-  "bundledFrom": "94ac498"
+  "frameworkVersion": "1.0.15",
+  "bundledAt": "2026-03-15T12:24:22.555Z",
+  "bundledFrom": "8b809a8"
 }

package/bundled/dev-pipeline/retry-bug.sh

@@ -24,9 +24,27 @@ SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 SESSION_TIMEOUT=${SESSION_TIMEOUT:-0}
 HEARTBEAT_INTERVAL=${HEARTBEAT_INTERVAL:-30}
 
-# AI CLI detection
+# AI CLI detection: AI_CLI env > .prizmkit/config.json > CODEBUDDY_CLI > auto-detect
 if [[ -n "${AI_CLI:-}" ]]; then
     CLI_CMD="$AI_CLI"
+elif [[ -f ".prizmkit/config.json" ]]; then
+    _config_cli=$(python3 -c "
+import json, sys
+try:
+    with open('.prizmkit/config.json') as f:
+        d = json.load(f)
+    v = d.get('ai_cli', '')
+    if v: print(v)
+except: pass
+" 2>/dev/null || true)
+    CLI_CMD="${_config_cli:-}"
+    if [[ -z "$CLI_CMD" ]]; then
+        if [[ -n "${CODEBUDDY_CLI:-}" ]]; then CLI_CMD="$CODEBUDDY_CLI"
+        elif command -v cbc &>/dev/null; then CLI_CMD="cbc"
+        elif command -v claude &>/dev/null; then CLI_CMD="claude"
+        else echo "ERROR: No AI CLI found. Set AI_CLI or configure .prizmkit/config.json" >&2; exit 1
+        fi
+    fi
 elif [[ -n "${CODEBUDDY_CLI:-}" ]]; then
     CLI_CMD="$CODEBUDDY_CLI"
 elif command -v cbc &>/dev/null; then
@@ -34,7 +52,7 @@ elif command -v cbc &>/dev/null; then
 elif command -v claude &>/dev/null; then
     CLI_CMD="claude"
 else
-    echo "ERROR: No AI CLI found. Install CodeBuddy (cbc) or Claude Code (claude)." >&2
+    echo "ERROR: No AI CLI found. Install CodeBuddy (cbc) or Claude Code (claude), or set AI_CLI." >&2
     exit 1
 fi
 

package/bundled/dev-pipeline/retry-feature.sh

@@ -24,9 +24,27 @@ SCRIPTS_DIR="$SCRIPT_DIR/scripts"
 SESSION_TIMEOUT=${SESSION_TIMEOUT:-0}
 HEARTBEAT_INTERVAL=${HEARTBEAT_INTERVAL:-30}
 
-# AI CLI detection: AI_CLI > CODEBUDDY_CLI > auto-detect
+# AI CLI detection: AI_CLI env > .prizmkit/config.json > CODEBUDDY_CLI > auto-detect
 if [[ -n "${AI_CLI:-}" ]]; then
     CLI_CMD="$AI_CLI"
+elif [[ -f ".prizmkit/config.json" ]]; then
+    _config_cli=$(python3 -c "
+import json, sys
+try:
+    with open('.prizmkit/config.json') as f:
+        d = json.load(f)
+    v = d.get('ai_cli', '')
+    if v: print(v)
+except: pass
+" 2>/dev/null || true)
+    CLI_CMD="${_config_cli:-}"
+    if [[ -z "$CLI_CMD" ]]; then
+        if [[ -n "${CODEBUDDY_CLI:-}" ]]; then CLI_CMD="$CODEBUDDY_CLI"
+        elif command -v cbc &>/dev/null; then CLI_CMD="cbc"
+        elif command -v claude &>/dev/null; then CLI_CMD="claude"
+        else echo "ERROR: No AI CLI found. Set AI_CLI or configure .prizmkit/config.json" >&2; exit 1
+        fi
+    fi
 elif [[ -n "${CODEBUDDY_CLI:-}" ]]; then
     CLI_CMD="$CODEBUDDY_CLI"
 elif command -v cbc &>/dev/null; then
@@ -34,7 +52,7 @@ elif command -v cbc &>/dev/null; then
 elif command -v claude &>/dev/null; then
     CLI_CMD="claude"
 else
-    echo "ERROR: No AI CLI found. Install CodeBuddy (cbc) or Claude Code (claude)." >&2
+    echo "ERROR: No AI CLI found. Install CodeBuddy (cbc) or Claude Code (claude), or set AI_CLI." >&2
     exit 1
 fi
 

package/bundled/rules/prizm/prizm-documentation.md

@@ -1,5 +1,5 @@
 ---
-description: "PrizmKit documentation rules"
+description: "PrizmKit .prizm-docs maintenance rules — when/how to update structured AI documentation"
 globs:
   - "**/*.ts"
   - "**/*.tsx"
@@ -11,9 +11,70 @@ globs:
   - "**/*.java"
 ---
 
-When modifying source files in this project:
-1. Check if `.prizm-docs/root.prizm` exists
-2. If it does, read it before making changes to understand project structure
-3. After making changes, update affected `.prizm-docs/` files
-4. Follow the Prizm doc format (KEY: value, not prose)
-5. Size limits: L0 = 4KB, L1 = 3KB, L2 = 5KB
+WHEN TO UPDATE .prizm-docs/:
+- Feature development (new interface, new module, new behavior) → UPDATE .prizm-docs/
+- Bug fix (fixing broken logic, no structural change) → SKIP, do NOT update
+- Rationale: bugs are incomplete features. Recording bug details causes doc bloat with no AI value.
+- Before modifying any source file, read `.prizm-docs/root.prizm` if it exists to understand project structure.
+
+FORMAT RULES (enforced by pre-commit hook — violations block commit):
+- ALL CAPS section headers: MODULE:, FILES:, RESPONSIBILITY:, UPDATED:, etc.
+- KEY: value pairs and dash-prefixed lists only
+- PROHIBITED: prose paragraphs, markdown headers (##/###), code blocks (```), emoji, ASCII art
+- This format is designed for AI token efficiency, not human readability. Do not add human-friendly formatting.
+
+SIZE LIMITS (hard — pre-commit hook blocks commits exceeding these):
+- L0 root.prizm: 4KB max
+- L1 module.prizm: 3KB max
+- L2 detail.prizm: 5KB max
+
+SIZE OVERFLOW HANDLING:
+- L0 approaching 4KB: consolidate MODULE_INDEX, keep only top-5 RULES, remove PATTERNS detail
+- L1 approaching 3KB: move implementation details to L2, keep only INTERFACES signatures
+- L2 approaching 5KB: archive CHANGELOG entries older than 90 days to changelog-archive.prizm
+- NEVER exceed hard limits — pre-commit hook will block the commit
+
+REQUIRED FIELDS PER LEVEL:
+
+L0 root.prizm:
+- PRIZM_VERSION
+- PROJECT
+- LANG
+- MODULE_INDEX (with -> pointers to L1 files)
+- RULES (top-level project rules)
+- UPDATED
+
+L1 module.prizm:
+- MODULE
+- FILES
+- RESPONSIBILITY
+- INTERFACES (public/exported only)
+- DEPENDENCIES
+- UPDATED
+
+L2 detail.prizm:
+- MODULE
+- FILES
+- KEY_FILES
+- DEPENDENCIES
+- TRAPS
+- CHANGELOG
+- UPDATED
+
+L2 GENERATION TEMPLATE (use when AI first touches a sub-module with no L2 doc):
+
+MODULE: <path>
+FILES: <comma-separated file list>
+RESPONSIBILITY: <one-line>
+KEY_FILES:
+- <file>: <role, line count, complexity note>
+DEPENDENCIES:
+- uses: <lib>: <why>
+- imports: <module>: <what>
+TRAPS:
+- <gotcha, race condition, or non-obvious coupling>
+CHANGELOG:
+- <YYYY-MM-DD> | add: initial L2 documentation
+UPDATED: <YYYY-MM-DD>
+
+TRAPS is critical — always record gotchas, race conditions, non-obvious behavior, and surprising coupling between modules.

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.14",
+  "version": "1.0.15",
   "skills": {
     "prizm-kit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",
@@ -293,22 +293,45 @@
     "frontend": {
       "label": "前端项目 (React/Vue/Angular)",
       "base": "core",
-      "include": ["prizmkit-tool-perf-profiler", "prizmkit-tool-security-audit", "prizmkit-tool-ci-cd-generator"]
+      "include": [
+        "prizmkit-tool-perf-profiler",
+        "prizmkit-tool-security-audit",
+        "prizmkit-tool-ci-cd-generator"
+      ]
     },
     "backend": {
       "label": "后端服务 (API/微服务)",
       "base": "core",
-      "include": ["prizmkit-tool-db-migration", "prizmkit-tool-api-doc-generator", "prizmkit-tool-monitoring-setup", "prizmkit-tool-deployment-strategy", "prizmkit-tool-security-audit", "prizmkit-tool-error-triage", "prizmkit-tool-log-analyzer"]
+      "include": [
+        "prizmkit-tool-db-migration",
+        "prizmkit-tool-api-doc-generator",
+        "prizmkit-tool-monitoring-setup",
+        "prizmkit-tool-deployment-strategy",
+        "prizmkit-tool-security-audit",
+        "prizmkit-tool-error-triage",
+        "prizmkit-tool-log-analyzer"
+      ]
     },
     "fullstack": {
       "label": "全栈项目",
       "base": "core",
-      "include": ["prizmkit-tool-db-migration", "prizmkit-tool-api-doc-generator", "prizmkit-tool-ci-cd-generator", "prizmkit-tool-security-audit", "prizmkit-tool-deployment-strategy", "prizmkit-tool-perf-profiler"]
+      "include": [
+        "prizmkit-tool-db-migration",
+        "prizmkit-tool-api-doc-generator",
+        "prizmkit-tool-ci-cd-generator",
+        "prizmkit-tool-security-audit",
+        "prizmkit-tool-deployment-strategy",
+        "prizmkit-tool-perf-profiler"
+      ]
     },
     "library": {
       "label": "工具库/SDK",
       "base": "core",
-      "include": ["prizmkit-tool-api-doc-generator", "prizmkit-tool-ci-cd-generator", "prizmkit-tool-dependency-health"]
+      "include": [
+        "prizmkit-tool-api-doc-generator",
+        "prizmkit-tool-ci-cd-generator",
+        "prizmkit-tool-dependency-health"
+      ]
     }
   },
   "external_skills": {
@@ -325,21 +348,30 @@
         "description": "Intelligent file and code search skill",
         "source": "https://skills.sh/skills/find-skill/SKILL.md",
         "registry": "skills.sh",
-        "tags": ["search", "utility"]
+        "tags": [
+          "search",
+          "utility"
+        ]
       },
       {
         "name": "uiuxpromax",
         "description": "UI/UX design review and suggestions",
         "source": "https://skills.sh/skills/uiuxpromax/SKILL.md",
         "registry": "skills.sh",
-        "tags": ["design", "frontend"]
+        "tags": [
+          "design",
+          "frontend"
+        ]
       },
       {
         "name": "thinkthought",
         "description": "Structured reasoning and problem decomposition",
         "source": "https://skills.sh/skills/thinkthought/SKILL.md",
         "registry": "skills.sh",
-        "tags": ["reasoning", "universal"]
+        "tags": [
+          "reasoning",
+          "universal"
+        ]
       }
     ]
   }

package/bundled/templates/hooks/commit-intent-claude.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "echo 'PRIZMKIT_DOC_UPDATE_REQUIRED: Before committing, you MUST update .prizm-docs/ per Prizm auto-update protocol. Steps: 1) Run git diff --cached --name-status. 2) Map changed files to modules via root.prizm MODULE_INDEX. 3) Read and update affected .prizm files (only changed sections). 4) Append to changelog.prizm. 5) Stage .prizm files with git add .prizm-docs/. 6) Then proceed with commit using prizmkit-committer workflow. RULES: Never rewrite entire .prizm files. Never add prose. Only update affected sections.'"
+            "command": "SRC=$(git diff --cached --name-only 2>/dev/null | grep -cE '\\.(ts|tsx|js|jsx|py|go|rs|java)$'); if [ \"$SRC\" -gt 0 ]; then PRIZM=$(git diff --cached --name-only 2>/dev/null | grep -c '^\\.prizm-docs/'); if [ \"$PRIZM\" -gt 0 ]; then echo \"PRIZMKIT_DOC_STATUS: $SRC source file(s) staged | .prizm-docs/ updated ($PRIZM file(s))\"; else echo \"PRIZMKIT_DOC_STATUS: $SRC source file(s) staged | .prizm-docs/ NOT UPDATED — update if this is a feature change\"; fi; fi"
           }
         ]
       }

package/bundled/templates/hooks/commit-intent-codebuddy.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "echo 'PRIZMKIT_DOC_UPDATE_REQUIRED: Before committing, you MUST update .prizm-docs/ per Prizm auto-update protocol. Steps: 1) Run git diff --cached --name-status. 2) Map changed files to modules via root.prizm MODULE_INDEX. 3) Read and update affected .prizm files (only changed sections). 4) Append to changelog.prizm. 5) Stage .prizm files with git add .prizm-docs/. 6) Then proceed with commit using prizmkit-committer workflow. RULES: Never rewrite entire .prizm files. Never add prose. Only update affected sections.'"
+            "command": "SRC=$(git diff --cached --name-only 2>/dev/null | grep -cE '\\.(ts|tsx|js|jsx|py|go|rs|java)$'); if [ \"$SRC\" -gt 0 ]; then PRIZM=$(git diff --cached --name-only 2>/dev/null | grep -c '^\\.prizm-docs/'); if [ \"$PRIZM\" -gt 0 ]; then echo \"PRIZMKIT_DOC_STATUS: $SRC source file(s) staged | .prizm-docs/ updated ($PRIZM file(s))\"; else echo \"PRIZMKIT_DOC_STATUS: $SRC source file(s) staged | .prizm-docs/ NOT UPDATED — update if this is a feature change\"; fi; fi"
           }
         ]
       }

package/bundled/templates/hooks/prizm-pre-commit.sh

@@ -0,0 +1,58 @@
+#!/bin/sh
+# prizm-pre-commit.sh — git pre-commit hook for .prizm-docs validation
+
+PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0
+
+# Only run in prizm projects
+[ -f "$PROJECT_ROOT/.prizm-docs/root.prizm" ] || exit 0
+
+VALIDATE_SCRIPT="$PROJECT_ROOT/dev-pipeline/scripts/validate-prizm-docs.sh"
+
+if [ -f "$VALIDATE_SCRIPT" ]; then
+    sh "$VALIDATE_SCRIPT" --staged
+    exit $?
+fi
+
+# Inline fallback: core checks for staged .prizm files
+FILES=$(git diff --cached --name-only 2>/dev/null | grep '\.prizm$')
+[ -z "$FILES" ] && exit 0
+
+ERRORS=0
+for FILE in $FILES; do
+    [ -f "$FILE" ] || continue
+
+    if grep -qE '^#{1,6} ' "$FILE"; then
+        echo "ERROR: $FILE contains markdown headers (##). Use KEY: value format." >&2
+        ERRORS=$((ERRORS + 1))
+    fi
+
+    if grep -q '^```' "$FILE"; then
+        echo "ERROR: $FILE contains code blocks. Use file_path:line_number reference." >&2
+        ERRORS=$((ERRORS + 1))
+    fi
+
+    SIZE=$(wc -c < "$FILE" | tr -d ' ')
+    case "$FILE" in
+        *root.prizm) LIMIT=4096 ;;
+        *)
+            DIR=$(dirname "$FILE")
+            if [ "$DIR" = ".prizm-docs" ]; then
+                LIMIT=3072
+            else
+                LIMIT=5120
+            fi
+            ;;
+    esac
+
+    if [ "$SIZE" -gt "$LIMIT" ]; then
+        echo "ERROR: $FILE exceeds size limit (${SIZE}B > ${LIMIT}B)." >&2
+        ERRORS=$((ERRORS + 1))
+    fi
+done
+
+if [ "$ERRORS" -gt 0 ]; then
+    echo "PrizmKit: $ERRORS format error(s) in .prizm files. Fix before committing." >&2
+    exit 1
+fi
+
+exit 0

package/bundled/templates/hooks/validate-prizm-docs.sh

@@ -0,0 +1,84 @@
+#!/bin/sh
+# validate-prizm-docs.sh — validate .prizm file format and size limits
+# Usage: validate-prizm-docs.sh [--all | --staged]
+
+MODE="${1:---staged}"
+ERRORS=0
+
+# Not a prizm project — exit silently
+[ -f ".prizm-docs/root.prizm" ] || exit 0
+
+# Collect files to check
+if [ "$MODE" = "--all" ]; then
+    FILES=$(find .prizm-docs -name '*.prizm' 2>/dev/null)
+elif [ "$MODE" = "--staged" ]; then
+    FILES=$(git diff --cached --name-only 2>/dev/null | grep '\.prizm$')
+else
+    echo "Usage: validate-prizm-docs.sh [--all | --staged]" >&2
+    exit 1
+fi
+
+# Nothing to check — exit silently
+[ -z "$FILES" ] && exit 0
+
+for FILE in $FILES; do
+    [ -f "$FILE" ] || continue
+
+    # Check markdown headers
+    if grep -qE '^#{1,6} ' "$FILE"; then
+        echo "ERROR: $FILE contains markdown headers (##). Use KEY: value format." >&2
+        ERRORS=$((ERRORS + 1))
+    fi
+
+    # Check code blocks
+    if grep -q '^```' "$FILE"; then
+        echo "ERROR: $FILE contains code blocks. Use file_path:line_number reference." >&2
+        ERRORS=$((ERRORS + 1))
+    fi
+
+    # Size limits — determine level by path depth
+    SIZE=$(wc -c < "$FILE" | tr -d ' ')
+    case "$FILE" in
+        *root.prizm)
+            LIMIT=4096; LEVEL="L0"
+            HINT="Consolidate MODULE_INDEX, keep top-5 RULES."
+            ;;
+        *)
+            # L1 = direct child of .prizm-docs/, L2 = nested deeper
+            DIR=$(dirname "$FILE")
+            if [ "$DIR" = ".prizm-docs" ]; then
+                LIMIT=3072; LEVEL="L1"
+                HINT="Move implementation details to L2."
+            else
+                LIMIT=5120; LEVEL="L2"
+                HINT="Archive CHANGELOG entries older than 90 days."
+            fi
+            ;;
+    esac
+
+    if [ "$SIZE" -gt "$LIMIT" ]; then
+        echo "ERROR: $FILE exceeds $LEVEL limit (${SIZE}B > ${LIMIT}B). $HINT" >&2
+        ERRORS=$((ERRORS + 1))
+    fi
+
+    # Required fields in root.prizm
+    case "$FILE" in
+        *root.prizm)
+            if ! grep -q 'PRIZM_VERSION:' "$FILE"; then
+                echo "ERROR: $FILE missing required field PRIZM_VERSION:" >&2
+                ERRORS=$((ERRORS + 1))
+            fi
+            if ! grep -q 'MODULE_INDEX:' "$FILE"; then
+                echo "ERROR: $FILE missing required field MODULE_INDEX:" >&2
+                ERRORS=$((ERRORS + 1))
+            fi
+            ;;
+    esac
+done
+
+if [ "$ERRORS" -gt 0 ]; then
+    echo "PrizmKit: $ERRORS format error(s) in .prizm files. Fix before committing." >&2
+    exit 1
+fi
+
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {

package/src/detect-platform.js

@@ -6,9 +6,9 @@
 import { execFileSync } from 'child_process';
 
 /**
- * 允许检测的命令白名单
+ * 允许检测的命令白名单（仅用于 which 检测）
  */
-const ALLOWED_COMMANDS = ['cbc', 'claude'];
+const ALLOWED_COMMANDS = ['cbc', 'claude', 'claude-internal'];
 
 /**
  * 检查命令是否存在于 PATH 中
@@ -26,21 +26,33 @@ function commandExists(cmd) {
 }
 
 /**
- * 检测已安装的 AI CLI 工具，并返回推荐的默认平台。
- * @returns {{ cbc: boolean, claude: boolean, suggested: string }}
+ * 检测已安装的 AI CLI 工具，并返回推荐的默认平台和 CLI 命令。
+ *
+ * 注意：platform 控制目录结构（.codebuddy/ 或 .claude/），
+ *       suggestedCli 是实际运行的可执行命令，二者相互独立。
+ *
+ * @returns {{ cbc: boolean, claude: boolean, claudeInternal: boolean, suggested: string, suggestedCli: string }}
  */
 export function detectPlatform() {
   const cbc = commandExists('cbc');
   const claude = commandExists('claude');
+  const claudeInternal = commandExists('claude-internal');
 
+  // platform 建议：基于目录结构，优先 both
   let suggested = 'codebuddy';
-  if (cbc && claude) {
+  if ((cbc) && (claude || claudeInternal)) {
     suggested = 'both';
-  } else if (claude && !cbc) {
+  } else if ((claude || claudeInternal) && !cbc) {
     suggested = 'claude';
-  } else if (cbc && !claude) {
+  } else if (cbc && !claude && !claudeInternal) {
     suggested = 'codebuddy';
   }
 
-  return { cbc, claude, suggested };
+  // CLI 命令建议：优先 cbc，其次 claude-internal，再次 claude
+  let suggestedCli = '';
+  if (cbc) suggestedCli = 'cbc';
+  else if (claudeInternal) suggestedCli = 'claude-internal';
+  else if (claude) suggestedCli = 'claude';
+
+  return { cbc, claude, claudeInternal, suggested, suggestedCli };
 }

package/src/index.js

@@ -33,6 +33,7 @@ export async function runScaffold(directory, options) {
   const cliStatus = [
     detected.cbc ? chalk.green('cbc ✓') : chalk.gray('cbc ✗'),
     detected.claude ? chalk.green('claude ✓') : chalk.gray('claude ✗'),
+    detected.claudeInternal ? chalk.green('claude-internal ✓') : chalk.gray('claude-internal ✗'),
   ].join('  ');
   console.log(`  检测到的 CLI 工具:  ${cliStatus}`);
   console.log(`  目标目录:          ${projectRoot}`);
@@ -64,16 +65,16 @@ export async function runScaffold(directory, options) {
 
   // === 交互式模式 ===
   try {
-    // 1. 选择平台
+    // 1. 选择平台（控制安装的目录结构）
     const platform = await select({
-      message: '选择目标平台:',
+      message: '选择目标平台 (决定安装的目录结构):',
       choices: [
         {
-          name: `CodeBuddy CLI (cbc)${detected.cbc ? chalk.green(' ← 已检测到') : ''}`,
+          name: `CodeBuddy (.codebuddy/)${detected.cbc ? chalk.green(' ← 已检测到 cbc') : ''}`,
           value: 'codebuddy',
         },
         {
-          name: `Claude Code CLI (claude)${detected.claude ? chalk.green(' ← 已检测到') : ''}`,
+          name: `Claude Code (.claude/)${(detected.claude || detected.claudeInternal) ? chalk.green(' ← 已检测到') : ''}`,
           value: 'claude',
         },
         {
@@ -84,11 +85,10 @@ export async function runScaffold(directory, options) {
       default: detected.suggested,
     });
 
-    // 1.5. AI CLI 命令配置
-    const defaultCli = detected.cbc ? 'cbc' : detected.claude ? 'claude' : '';
+    // 1.5. AI CLI 命令配置（独立于平台，决定实际运行的可执行命令）
     const aiCli = await input({
-      message: '底层 AI CLI 可执行命令 (留空自动检测):',
-      default: defaultCli,
+      message: '底层 AI CLI 可执行命令 (可自定义，如 claude-internal --dangerously-skip-permissions):',
+      default: detected.suggestedCli,
     });
 
     // 2. 选择技能套件

package/src/scaffold.js

@@ -439,6 +439,60 @@ async function installSettings(platform, projectRoot, options, dryRun) {
   }
 }
 
+/**
+ * 安装 git pre-commit hook（prizm 格式校验）
+ */
+async function installGitHook(projectRoot, dryRun) {
+  const gitDir = path.join(projectRoot, '.git');
+
+  if (dryRun) {
+    console.log(chalk.gray('      [dry-run] .git/hooks/pre-commit (prizm format check)'));
+    return;
+  }
+
+  if (!fs.existsSync(gitDir)) return;
+
+  const templatePath = path.join(getTemplatesDir(), 'hooks', 'prizm-pre-commit.sh');
+  const hooksDir = path.join(gitDir, 'hooks');
+  const preCommitPath = path.join(hooksDir, 'pre-commit');
+
+  fs.mkdirSync(hooksDir, { recursive: true });
+
+  if (fs.existsSync(preCommitPath)) {
+    const existing = fs.readFileSync(preCommitPath, 'utf8');
+    if (existing.includes('PrizmKit')) return;
+    const hookContent = fs.readFileSync(templatePath, 'utf8');
+    fs.writeFileSync(preCommitPath, existing + '\n\n' + hookContent);
+  } else {
+    await fs.copy(templatePath, preCommitPath);
+    fs.chmodSync(preCommitPath, 0o755);
+  }
+
+  console.log(chalk.green('      ✓ .git/hooks/pre-commit (prizm format check)'));
+}
+
+/**
+ * 安装 validate-prizm-docs.sh 到 dev-pipeline/scripts/
+ */
+async function installValidateScript(projectRoot, dryRun) {
+  const sourcePath = path.join(getTemplatesDir(), 'hooks', 'validate-prizm-docs.sh');
+  if (!fs.existsSync(sourcePath)) return;
+
+  const targetDir = path.join(projectRoot, 'dev-pipeline', 'scripts');
+  const targetPath = path.join(targetDir, 'validate-prizm-docs.sh');
+
+  if (dryRun) {
+    console.log(chalk.gray('      [dry-run] dev-pipeline/scripts/validate-prizm-docs.sh'));
+    return;
+  }
+
+  await fs.ensureDir(targetDir);
+  await fs.copy(sourcePath, targetPath);
+  fs.chmodSync(targetPath, 0o755);
+
+  console.log(chalk.green('      ✓ dev-pipeline/scripts/validate-prizm-docs.sh'));
+}
+
 /**
  * 安装项目记忆文件（CODEBUDDY.md / CLAUDE.md）
  */
@@ -653,6 +707,16 @@ export async function scaffold(config) {
     }
   }
 
+  // 10. Git pre-commit hook
+  console.log(chalk.blue('    Git Hook:'));
+  await installGitHook(projectRoot, dryRun);
+
+  // 11. Validate script (only if pipeline enabled)
+  if (pipeline) {
+    console.log(chalk.blue('    验证脚本:'));
+    await installValidateScript(projectRoot, dryRun);
+  }
+
   // === 完成 ===
   console.log('');
   console.log(chalk.bold('  ════════════════════════════════════════════════'));
@@ -667,7 +731,8 @@ export async function scaffold(config) {
   if (!dryRun) {
     // 打印下一步提示
     const mainPlatform = platforms.includes('claude') ? 'claude' : 'codebuddy';
-    const cli = mainPlatform === 'claude' ? 'claude' : 'cbc';
+    const defaultCli = mainPlatform === 'claude' ? 'claude' : 'cbc';
+    const cli = aiCli || defaultCli;
 
     console.log('');
     console.log('  下一步:');