prizmkit 1.1.100 → 1.1.102

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

@@ -0,0 +1,240 @@
+#!/usr/bin/env python3
+"""Validate .prizmkit/prizm-docs files for PrizmKit projects."""
+
+from __future__ import annotations
+
+import re
+import subprocess
+import sys
+from pathlib import Path, PurePosixPath
+
+DOCS_ROOT = Path(".prizmkit/prizm-docs")
+ROOT_PRIZM = DOCS_ROOT / "root.prizm"
+VALID_MODES = {"--all", "--staged"}
+
+AUXILIARY_METADATA_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*(CHANGELOG|CREATED([ _-]?(AT|ON|DATE))?|"
+    r"UPDATED([ _-]?(AT|ON|DATE))?|MODIFIED([ _-]?(AT|ON|DATE))?|"
+    r"LAST[ _-]?(UPDATED|MODIFIED)([ _-]?(AT|ON|DATE))?|DATE|TIMESTAMP):",
+    re.IGNORECASE | re.MULTILINE,
+)
+WORKFLOW_ID_RE = re.compile(
+    r"(^|[^A-Za-z0-9_])([FBR]-[0-9]{3}|T-[0-9]{3})(-[A-Z])?([^A-Za-z0-9_]|$)",
+    re.IGNORECASE,
+)
+WORKFLOW_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*((bug|feature|refactor|task)[ _-]?id|"
+    r"(session|run|pipeline|workflow)([ _-]?id)?)([ \t]*(:|=)|[ \t]+)",
+    re.IGNORECASE | re.MULTILINE,
+)
+WORKFLOW_COMPOUND_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*(bug|feature|refactor|task|session|run|pipeline|workflow)"
+    r"([ _-](bug|feature|refactor|task|session|run|pipeline|workflow|id))+"
+    r"([ \t]*(:|=)|[ \t]+)",
+    re.IGNORECASE | re.MULTILINE,
+)
+ARTIFACT_PATH_RE = re.compile(
+    r"(^|[^A-Za-z0-9_.-])\.prizmkit/(specs|dev-pipeline)($|/|[^A-Za-z0-9_.-])"
+)
+ABSOLUTE_PATH_RE = re.compile(
+    r"(^|[^A-Za-z0-9_./:-])"
+    r"(/Users/|/home/|/tmp/|/private/tmp/|/var/folders/|/workspace/|/workspaces/|"
+    r"/opt/|/srv/|/root/|/var/tmp/|/Volumes/|/mnt/[A-Za-z]/|[A-Za-z]:/)"
+)
+BRANCH_EXACT_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*(BRANCH|BRANCH_NAME|CURRENT_BRANCH|SOURCE_BRANCH|BASE_BRANCH|"
+    r"HEAD_BRANCH|GIT_BRANCH|TARGET_BRANCH)[ \t_-]*(:|=|[ \t])",
+    re.MULTILINE,
+)
+BRANCH_UPPER_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*[A-Z][A-Z0-9_]*_BRANCH[ \t_-]*(:|=|[ \t])"
+    r"[ \t]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|"
+    r"(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)"
+    r"[ \t]*(#.*)?$",
+    re.MULTILINE,
+)
+BRANCH_NAME_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*(branch[ _-]*name|current[ _-]*branch|source[ _-]*branch|"
+    r"base[ _-]*branch|head[ _-]*branch|git[ _-]*branch|target[ _-]*branch)"
+    r"[ \t_-]*(:|=|[ \t])",
+    re.IGNORECASE | re.MULTILINE,
+)
+BRANCH_TITLE_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*([A-Za-z0-9]+[ _-]+)+branch([ \t]*(:|=)|[ \t]+)"
+    r"[ \t]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|"
+    r"(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)"
+    r"[ \t]*(#.*)?$",
+    re.IGNORECASE | re.MULTILINE,
+)
+BRANCH_SIMPLE_FIELD_RE = re.compile(
+    r"^[ \t]*[-*]?[ \t]*branch[ \t_-]*(:|=|[ \t])"
+    r"[ \t]*(main|master|develop|development|trunk|[A-Za-z0-9._-]+/[A-Za-z0-9._/-]+|"
+    r"(feature|fix|bugfix|hotfix|release|chore|refactor|task|dev)[/_-][A-Za-z0-9._/-]+)"
+    r"[ \t]*(#.*)?$",
+    re.IGNORECASE | re.MULTILINE,
+)
+
+
+def emit_error(file_path: str, message: str) -> None:
+    print(f"ERROR: {file_path} {message}", file=sys.stderr)
+
+
+def run_git(args: list[str], *, capture: bool = True) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        ["git", *args],
+        text=True,
+        encoding="utf-8",
+        errors="replace",
+        stdout=subprocess.PIPE if capture else subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+        check=False,
+    )
+
+
+def collect_files(mode: str) -> list[str]:
+    if mode == "--all":
+        return sorted(path.as_posix() for path in DOCS_ROOT.rglob("*.prizm") if path.is_file())
+
+    result = run_git(["diff", "--cached", "--name-only"])
+    if result.returncode != 0:
+        return []
+    return [line.strip() for line in result.stdout.splitlines() if line.strip().endswith(".prizm")]
+
+
+def read_check_content(file_path: str, mode: str) -> tuple[bytes, str] | None:
+    if mode == "--staged":
+        exists = run_git(["cat-file", "-e", f":{file_path}"], capture=False)
+        if exists.returncode != 0:
+            return None
+        blob = subprocess.run(
+            ["git", "show", f":{file_path}"],
+            stdout=subprocess.PIPE,
+            stderr=subprocess.DEVNULL,
+            check=False,
+        )
+        if blob.returncode != 0:
+            return None
+        raw = blob.stdout
+    else:
+        path = Path(file_path)
+        if not path.is_file():
+            return None
+        raw = path.read_bytes()
+
+    return raw, raw.decode("utf-8", errors="replace")
+
+
+def is_l1_doc(file_path: str) -> bool:
+    parent = PurePosixPath(file_path).parent.as_posix()
+    return parent == DOCS_ROOT.as_posix()
+
+
+def size_limit(file_path: str) -> tuple[int, str, str]:
+    if file_path.endswith("root.prizm"):
+        return 4096, "L0", "Consolidate MODULE_INDEX, keep top-5 RULES."
+    if is_l1_doc(file_path):
+        return 3072, "L1", "Move implementation details to L2."
+    return 5120, "L2", "Remove stale or trivially derivable entries."
+
+
+def contains_root_field(text: str, field: str) -> bool:
+    return re.search(rf"^{re.escape(field)}:", text, re.MULTILINE) is not None
+
+
+def validate_file(file_path: str, raw: bytes, text: str) -> int:
+    errors = 0
+
+    if re.search(r"^#{1,6} ", text, re.MULTILINE):
+        emit_error(file_path, "contains markdown headers (##). Use KEY: value format.")
+        errors += 1
+
+    if re.search(r"^```", text, re.MULTILINE):
+        emit_error(file_path, "contains code blocks. Use file_path:line_number reference.")
+        errors += 1
+
+    base_name = PurePosixPath(file_path).name.lower()
+    if base_name in {"changelog.prizm", "changelog-archive.prizm"} or (
+        "changelog" in base_name and base_name.endswith(".prizm")
+    ):
+        emit_error(file_path, "is auxiliary history. Use git history instead of changelog .prizm files.")
+        errors += 1
+
+    if AUXILIARY_METADATA_RE.search(text):
+        emit_error(
+            file_path,
+            "contains auxiliary history metadata. Use durable KEY: value sections only; git tracks history.",
+        )
+        errors += 1
+
+    if WORKFLOW_ID_RE.search(text) or WORKFLOW_FIELD_RE.search(text) or WORKFLOW_COMPOUND_FIELD_RE.search(text):
+        emit_error(
+            file_path,
+            "contains workflow metadata. Translate IDs, branch names, worktree paths, and pipeline artifacts into durable product/domain language.",
+        )
+        errors += 1
+
+    normalized_text = text.replace("\\", "/")
+    if ARTIFACT_PATH_RE.search(normalized_text):
+        emit_error(
+            file_path,
+            "contains PrizmKit artifact paths. Translate specs/dev-pipeline references into durable product/domain language.",
+        )
+        errors += 1
+
+    if ABSOLUTE_PATH_RE.search(normalized_text):
+        emit_error(file_path, "contains absolute worktree paths. Use repository-relative source paths only.")
+        errors += 1
+
+    if (
+        BRANCH_EXACT_FIELD_RE.search(text)
+        or BRANCH_UPPER_FIELD_RE.search(text)
+        or BRANCH_NAME_FIELD_RE.search(text)
+        or BRANCH_TITLE_FIELD_RE.search(text)
+        or BRANCH_SIMPLE_FIELD_RE.search(text)
+    ):
+        emit_error(file_path, "contains branch names. Describe durable product/domain context instead.")
+        errors += 1
+
+    limit, level, hint = size_limit(file_path)
+    size = len(raw)
+    if size > limit:
+        emit_error(file_path, f"exceeds {level} limit ({size}B > {limit}B). {hint}")
+        errors += 1
+
+    if file_path.endswith("root.prizm"):
+        for field in ["PRIZM_VERSION", "PROJECT", "LANG", "RULES"]:
+            if not contains_root_field(text, field):
+                emit_error(file_path, f"missing required field {field}:")
+                errors += 1
+        if not contains_root_field(text, "MODULE_INDEX") and not contains_root_field(text, "MODULE_GROUPS"):
+            emit_error(file_path, "missing required field MODULE_INDEX: or MODULE_GROUPS:")
+            errors += 1
+
+    return errors
+
+
+def main(argv: list[str]) -> int:
+    mode = argv[1] if len(argv) > 1 else "--staged"
+    if len(argv) > 2 or mode not in VALID_MODES:
+        print("Usage: validate-prizm-docs.py [--all | --staged]", file=sys.stderr)
+        return 1
+
+    if not ROOT_PRIZM.is_file():
+        return 0
+
+    errors = 0
+    for file_path in collect_files(mode):
+        content = read_check_content(file_path, mode)
+        if content is None:
+            continue
+        raw, text = content
+        errors += validate_file(file_path, raw, text)
+
+    if errors > 0:
+        print(f"PrizmKit: {errors} format error(s) in .prizm files. Fix before committing.", file=sys.stderr)
+        return 1
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main(sys.argv))

package/package.json

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

package/src/config.js

@@ -36,6 +36,8 @@ import {
   resolveSkillList,
   resolvePipelineFileList,
   resolveRuleNamesForRuntime,
+  findStaleManagedPipelineFiles,
+  removeStaleManagedPipelineFiles,
 } from './scaffold.js';
 import {
   removeSkillFiles,
@@ -47,13 +49,12 @@ import { detectPlatform } from './detect-platform.js';
 import {
   selectPlatform,
   selectAiCli,
-  selectRuntime,
   selectSkillSuite,
   selectRulesPreset,
   confirmTeamMode,
   confirmPipeline,
 } from './prompts.js';
-import { expandPlatforms, isKnownPlatform, platformLabel, projectMemoryFile } from './platforms.js';
+import { isKnownPlatform, platformLabel, projectMemoryFile, resolvePayloadPlatforms } from './platforms.js';
 import { normalizeRuntime, runtimeLabel } from './runtimes.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -350,11 +351,17 @@ export async function runConfig(directory, options = {}) {
 
   // Existing manifests are the source of truth. Filesystem detection is only a
   // legacy fallback for manifests created before platform was recorded.
-  const detectedPlatform = oldManifest.platform || await detectInstalledPlatforms(projectRoot) || 'claude';
+  const detectedPlatformRaw = oldManifest.platform || await detectInstalledPlatforms(projectRoot) || 'claude';
+  const detectedPlatform = detectedPlatformRaw === 'both' ? 'all' : detectedPlatformRaw;
+
+  const rawManifestRuntime = oldManifest.runtime;
+  const normalizedManifestRuntime = normalizeRuntime(rawManifestRuntime);
+  const runtimeManifestNeedsNormalization = rawManifestRuntime !== normalizedManifestRuntime;
+  const platformManifestNeedsNormalization = detectedPlatformRaw !== detectedPlatform;
 
   const currentConfig = {
     platform: detectedPlatform,
-    runtime: normalizeRuntime(oldManifest.runtime || 'unix'),
+    runtime: normalizedManifestRuntime,
     suite: oldManifest.suite || 'core',
     rules: oldManifest.options?.rules || 'recommended',
     team: oldManifest.options?.team ?? true,
@@ -369,7 +376,7 @@ export async function runConfig(directory, options = {}) {
   // Display current config
   console.log(chalk.bold('  当前配置:'));
   console.log(`    平台:     ${chalk.cyan(platformLabel(currentConfig.platform))}`);
-  console.log(`    运行系统: ${chalk.cyan(runtimeLabel(currentConfig.runtime))}`);
+  console.log(`    运行时:   ${chalk.cyan(runtimeLabel(currentConfig.runtime))}`);
   console.log(`    AI CLI:   ${currentConfig.aiCli ? chalk.cyan(currentConfig.aiCli) : chalk.gray('(未设置)')}`);
   console.log(`    技能套件: ${chalk.cyan(currentConfig.suite)}`);
   console.log(`    规则:     ${chalk.cyan(currentConfig.rules)}`);
@@ -381,10 +388,11 @@ export async function runConfig(directory, options = {}) {
 
   let newConfig;
   const optionRuntime = options.runtime !== undefined ? normalizeRuntime(options.runtime) : undefined;
+  const runtimeOptionNeedsNormalization = options.runtime !== undefined && options.runtime !== optionRuntime;
 
   if (nonInteractive) {
     // Non-interactive: only change what's explicitly specified via CLI options
-    if (!options.platform && !options.skills && !options.rules && options.runtime === undefined
+    if (!platformManifestNeedsNormalization && !runtimeManifestNeedsNormalization && !runtimeOptionNeedsNormalization && !options.platform && !options.skills && !options.rules && options.runtime === undefined
         && options.aiCli === undefined && options.team === undefined && options.pipeline === undefined) {
       console.log(chalk.yellow('  ⚠ 非交互式模式下未指定任何变更。'));
       console.log(chalk.gray('    使用 --platform, --runtime, --skills, --rules, --ai-cli, --team/--no-team, --pipeline/--no-pipeline'));
@@ -407,7 +415,7 @@ export async function runConfig(directory, options = {}) {
     try {
       console.log(chalk.bold('  选择新配置（按 Enter 保持当前值）:\n'));
 
-      const newRuntime = optionRuntime || await selectRuntime(currentConfig.runtime);
+      const newRuntime = optionRuntime || currentConfig.runtime;
       const newPlatform = await selectPlatform(currentConfig.platform, detected);
       const newAiCli = await selectAiCli(currentConfig.aiCli, detected);
 
@@ -442,11 +450,15 @@ export async function runConfig(directory, options = {}) {
   // ── Phase 3: COMPUTE DIFF ────────────────────────────────────────────────
 
   const changes = [];
-  if (newConfig.platform !== currentConfig.platform) {
+  if (platformManifestNeedsNormalization) {
+    changes.push(`平台: ${platformLabel(detectedPlatformRaw)} → ${platformLabel(newConfig.platform)}`);
+  } else if (newConfig.platform !== currentConfig.platform) {
     changes.push(`平台: ${platformLabel(currentConfig.platform)} → ${platformLabel(newConfig.platform)}`);
   }
-  if (newConfig.runtime !== currentConfig.runtime) {
-    changes.push(`运行系统: ${runtimeLabel(currentConfig.runtime)} → ${runtimeLabel(newConfig.runtime)}`);
+  if (runtimeManifestNeedsNormalization || runtimeOptionNeedsNormalization) {
+    changes.push(`运行时: ${runtimeLabel(rawManifestRuntime)} → ${runtimeLabel(newConfig.runtime)}`);
+  } else if (newConfig.runtime !== currentConfig.runtime) {
+    changes.push(`运行时: ${runtimeLabel(currentConfig.runtime)} → ${runtimeLabel(newConfig.runtime)}`);
   }
   if (newConfig.aiCli !== currentConfig.aiCli) {
     changes.push(`AI CLI: ${currentConfig.aiCli || '(未设置)'} → ${newConfig.aiCli || '(未设置)'}`);
@@ -478,9 +490,9 @@ export async function runConfig(directory, options = {}) {
   }
 
   // Warn about destructive changes
-  if (newConfig.platform !== currentConfig.platform) {
-    const oldPlatforms = expandPlatforms(currentConfig.platform);
-    const newPlatforms = expandPlatforms(newConfig.platform);
+  if (newConfig.platform !== currentConfig.platform || newConfig.aiCli !== currentConfig.aiCli) {
+    const oldPlatforms = resolvePayloadPlatforms(currentConfig.platform, currentConfig.aiCli);
+    const newPlatforms = resolvePayloadPlatforms(newConfig.platform, newConfig.aiCli);
     const dropping = oldPlatforms.filter(p => !newPlatforms.includes(p));
     if (dropping.length) {
       console.log(chalk.yellow(`\n  ⚠ 将移除 ${dropping.map(platformLabel).join(', ')} 的 PrizmKit 文件`));
@@ -509,8 +521,8 @@ export async function runConfig(directory, options = {}) {
 
   console.log(chalk.bold('\n  应用配置变更...\n'));
 
-  const oldPlatforms = expandPlatforms(currentConfig.platform);
-  const newPlatforms = expandPlatforms(newConfig.platform);
+  const oldPlatforms = resolvePayloadPlatforms(currentConfig.platform, currentConfig.aiCli);
+  const newPlatforms = resolvePayloadPlatforms(newConfig.platform, newConfig.aiCli);
   const platformsToRemove = oldPlatforms.filter(p => !newPlatforms.includes(p));
   const platformsToAdd = newPlatforms.filter(p => !oldPlatforms.includes(p));
   const platformsToUpdate = newPlatforms.filter(p => oldPlatforms.includes(p));
@@ -542,7 +554,7 @@ export async function runConfig(directory, options = {}) {
       version: pkg.version, platform: newConfig.platform, suite: newConfig.suite,
       skills: newSkillList, agents: newAgentFiles, rules: newRuleFiles,
       pipeline: newPipelineFiles, team: newConfig.team, aiCli: newConfig.aiCli,
-      runtime: newConfig.runtime, rulesPreset: newConfig.rules, extras: oldManifest?.files?.extras || [],
+      runtime: newConfig.runtime, rulesPreset: newConfig.rules, extras: oldManifest?.files?.extras || [], payloadPlatforms: newPlatforms,
     });
     const diff = diffManifest(oldManifest, newTempManifest);
 
@@ -562,9 +574,13 @@ export async function runConfig(directory, options = {}) {
   // 5d. Install/update files for new + existing platforms
   const allTargetPlatforms = [...platformsToAdd, ...platformsToUpdate];
   const needsReinstall = newConfig.platform !== currentConfig.platform
+    || platformManifestNeedsNormalization
+    || runtimeManifestNeedsNormalization
+    || runtimeOptionNeedsNormalization
     || newConfig.runtime !== currentConfig.runtime
     || newConfig.suite !== currentConfig.suite
     || newConfig.rules !== currentConfig.rules
+    || newConfig.aiCli !== currentConfig.aiCli
     || newConfig.team !== currentConfig.team;
 
   for (const p of allTargetPlatforms) {
@@ -595,7 +611,7 @@ export async function runConfig(directory, options = {}) {
   }
 
   // 5e. Pipeline changes
-  if (newConfig.pipeline !== currentConfig.pipeline || (newConfig.pipeline && newConfig.runtime !== currentConfig.runtime)) {
+  if (newConfig.pipeline !== currentConfig.pipeline || (newConfig.pipeline && (newConfig.runtime !== currentConfig.runtime || runtimeManifestNeedsNormalization || runtimeOptionNeedsNormalization))) {
     if (newConfig.pipeline) {
       console.log(chalk.blue('\n    安装 Pipeline:'));
       await installPipeline(projectRoot, false, {
@@ -609,6 +625,12 @@ export async function runConfig(directory, options = {}) {
         await removePipelineFiles(projectRoot, oldPipelineFiles, false);
       }
     }
+  } else if (newConfig.pipeline) {
+    const staleManagedPipelineFiles = await findStaleManagedPipelineFiles(projectRoot, newConfig.runtime);
+    if (staleManagedPipelineFiles.length) {
+      console.log(chalk.blue('\n    移除过期 Pipeline 框架文件:'));
+      await removeStaleManagedPipelineFiles(projectRoot, staleManagedPipelineFiles, false);
+    }
   }
 
   // 5f. Update .gitignore
@@ -616,7 +638,7 @@ export async function runConfig(directory, options = {}) {
   await installGitignore(projectRoot, { pipeline: newConfig.pipeline }, false);
 
   // 5g. Runtime-aware git hook and PrizmKit helper scripts
-  if (newConfig.runtime !== currentConfig.runtime) {
+  if (newConfig.runtime !== currentConfig.runtime || runtimeManifestNeedsNormalization || runtimeOptionNeedsNormalization) {
     console.log(chalk.blue('\n    Git Hook:'));
     await installGitHook(projectRoot, false, newConfig.runtime);
 
@@ -654,6 +676,7 @@ export async function runConfig(directory, options = {}) {
     team: newConfig.team,
     aiCli: newConfig.aiCli,
     rulesPreset: newConfig.rules,
+    payloadPlatforms: newPlatforms,
     extras: oldManifest?.files?.extras || [],
   });
 
@@ -675,7 +698,7 @@ export async function runConfig(directory, options = {}) {
 
   console.log(chalk.gray('  新配置:'));
   console.log(chalk.gray(`    平台:     ${platformLabel(newConfig.platform)}`));
-  console.log(chalk.gray(`    运行系统: ${runtimeLabel(newConfig.runtime)}`));
+  console.log(chalk.gray(`    运行时:   ${runtimeLabel(newConfig.runtime)}`));
   console.log(chalk.gray(`    AI CLI:   ${newConfig.aiCli || '(未设置)'}`));
   console.log(chalk.gray(`    技能套件: ${newConfig.suite}`));
   console.log(chalk.gray(`    规则:     ${newConfig.rules}`));

package/src/external-skills.js

@@ -14,7 +14,7 @@
 import { execSync } from 'node:child_process';
 import path from 'path';
 import fs from 'fs-extra';
-import { expandPlatforms } from './platforms.js';
+import { resolvePayloadPlatforms } from './platforms.js';
 
 /**
  * @param {Object} skill        - Skill definition from external_skills.known
@@ -23,9 +23,9 @@ import { expandPlatforms } from './platforms.js';
  *   skill.installAll {boolean} - If true, install all skills from the repo
  * @param {string} platform     - 'claude' | 'codebuddy' | 'codex' | 'all' ('both' supported only for legacy manifests)
  * @param {string} projectRoot  - Target project root
- * @param {boolean} dryRun
+ * @param {string} [aiCli]       - optional AI CLI command that may require an additional payload platform
  */
-export async function installExternalSkill(skill, platform, projectRoot, dryRun) {
+export async function installExternalSkill(skill, platform, projectRoot, dryRun, aiCli = '') {
   if (!skill.repo) {
     throw new Error(`Skill "${skill.name}" has no repo URL defined`);
   }
@@ -40,7 +40,7 @@ export async function installExternalSkill(skill, platform, projectRoot, dryRun)
     if (skill.installAll) {
       console.log(`      [dry-run] → all skills from ${skill.repo}`);
     } else {
-      const targets = getTargetDirs(platform, projectRoot)
+      const targets = getTargetDirs(platform, projectRoot, aiCli)
         .map(d => path.relative(projectRoot, path.join(d, skill.name, 'SKILL.md')));
       for (const t of targets) console.log(`      [dry-run] → ${t}`);
     }
@@ -61,7 +61,7 @@ export async function installExternalSkill(skill, platform, projectRoot, dryRun)
       .filter(d => d.isDirectory())
       .map(d => d.name);
 
-    for (const targetDir of getTargetDirs(platform, projectRoot)) {
+    for (const targetDir of getTargetDirs(platform, projectRoot, aiCli)) {
       for (const skillName of skillDirs) {
         const srcDir = path.join(agentsSkillsDir, skillName);
         const destDir = path.join(targetDir, skillName);
@@ -81,7 +81,7 @@ export async function installExternalSkill(skill, platform, projectRoot, dryRun)
 
     const content = await fs.readFile(canonicalSkillMd, 'utf8');
 
-    for (const targetDir of getTargetDirs(platform, projectRoot)) {
+    for (const targetDir of getTargetDirs(platform, projectRoot, aiCli)) {
       const skillDir = path.join(targetDir, skill.name);
       if (path.resolve(skillDir) === path.resolve(path.dirname(canonicalSkillMd))) {
         continue;
@@ -94,7 +94,7 @@ export async function installExternalSkill(skill, platform, projectRoot, dryRun)
 
   // Clean up npx skills artifacts after copying. Preserve .agents/skills when
   // Codex is selected because it is the official repository skill location.
-  if (!expandPlatforms(platform).includes('codex')) {
+  if (!resolvePayloadPlatforms(platform, aiCli).includes('codex')) {
     await fs.remove(path.join(projectRoot, '.agents')).catch(() => {});
   }
   await fs.remove(path.join(projectRoot, 'skills-lock.json')).catch(() => {});
@@ -104,15 +104,15 @@ export async function installExternalSkill(skill, platform, projectRoot, dryRun)
  * Remove all artifacts created by `npx skills` that are not needed by PrizmKit.
  * Call this once after all external skills have been installed.
  *
- * @param {string} projectRoot
  * @param {string} platform - 'claude' | 'codebuddy' | 'codex' | 'all' ('both' supported only for legacy manifests)
+ * @param {string} [aiCli] - optional AI CLI command that may require an additional payload platform
  */
-export async function cleanExternalSkillArtifacts(projectRoot, platform) {
+export async function cleanExternalSkillArtifacts(projectRoot, platform, aiCli = '') {
   const keepDirs = new Set(
-    getTargetDirs(platform, projectRoot).map(d => path.resolve(d))
+    getTargetDirs(platform, projectRoot, aiCli).map(d => path.resolve(d))
   );
 
-  const selectedPlatforms = expandPlatforms(platform);
+  const selectedPlatforms = resolvePayloadPlatforms(platform, aiCli);
   const dirsToCheck = [
     selectedPlatforms.includes('codex') ? null : '.agents',
     '.agent',
@@ -152,7 +152,7 @@ export async function cleanExternalSkillArtifacts(projectRoot, platform) {
     const abs = path.join(projectRoot, dir);
     if (!await fs.pathExists(abs)) continue;
     // Only remove if this platform dir is entirely unneeded
-    const isKept = getTargetDirs(platform, projectRoot)
+    const isKept = getTargetDirs(platform, projectRoot, aiCli)
       .some(d => path.resolve(d).startsWith(path.resolve(abs) + path.sep));
     if (isKept) continue;
     try {
@@ -166,8 +166,8 @@ export async function cleanExternalSkillArtifacts(projectRoot, platform) {
   await fs.remove(path.join(projectRoot, 'skills-lock.json')).catch(() => {});
 }
 
-function getTargetDirs(platform, projectRoot) {
-  return expandPlatforms(platform).map(p => {
+function getTargetDirs(platform, projectRoot, aiCli = '') {
+  return resolvePayloadPlatforms(platform, aiCli).map(p => {
     if (p === 'codebuddy') return path.join(projectRoot, '.codebuddy', 'skills');
     if (p === 'codex') return path.join(projectRoot, '.agents', 'skills');
     return path.join(projectRoot, '.claude', 'skills');

package/src/index.js

@@ -16,7 +16,6 @@ import { scaffold } from './scaffold.js';
 import { loadMetadata } from './metadata.js';
 import { platformLabel } from './platforms.js';
 import { normalizeRuntime, runtimeLabel } from './runtimes.js';
-import { selectRuntime } from './prompts.js';
 
 export { runUpgrade } from './upgrade.js';
 
@@ -85,10 +84,8 @@ export async function runScaffold(directory, options) {
 
   // === 交互式模式 ===
   try {
-    // 1. 选择运行系统（控制安装的流水线和编排技能）
-    const runtime = options.runtime !== undefined
-      ? normalizeRuntime(options.runtime)
-      : await selectRuntime();
+    // 1. 统一 Python runtime（旧 runtime 参数仅作为兼容别名归一）
+    const runtime = normalizeRuntime(options.runtime);
 
     // 2. 选择平台（控制安装的目录结构）
     const platform = await select({
@@ -243,7 +240,7 @@ export async function runScaffold(directory, options) {
 
     console.log('');
     console.log(chalk.bold('  安装摘要:'));
-    console.log(`    运行系统:   ${chalk.cyan(runtimeLabel(runtime))}`);
+    console.log(`    运行时:     ${chalk.cyan(runtimeLabel(runtime))}`);
     console.log(`    平台:       ${chalk.cyan(selectedPlatformLabel)}`);
     console.log(`    技能:       ${chalk.cyan(suiteLabel)}`);
     console.log(`    团队模式:   ${team ? chalk.green('启用') : chalk.gray('禁用')}`);

package/src/manifest.js

@@ -9,7 +9,8 @@
 
 import fs from 'fs-extra';
 import path from 'path';
-import { expandPlatforms, projectMemoryFile } from './platforms.js';
+import { projectMemoryFile, resolvePayloadPlatforms } from './platforms.js';
+import { normalizeRuntime } from './runtimes.js';
 
 const MANIFEST_FILE = 'manifest.json';
 const MANIFEST_DIR = '.prizmkit';
@@ -48,7 +49,7 @@ export async function writeManifest(projectRoot, data) {
  * @param {Object} params
  * @param {string} params.version - PrizmKit version
  * @param {string} params.platform - 'codebuddy' | 'claude' | 'codex' | 'all' ('both' supported only for legacy manifests)
- * @param {string} [params.runtime] - 'unix' | 'windows'
+ * @param {string} [params.runtime] - canonical Python runtime id or compatibility alias
  * @param {string} params.suite - skill suite name
  * @param {string[]} params.skills - resolved skill name list
  * @param {string[]} params.agents - agent file names (e.g. ['prizm-dev-team-dev.md'])
@@ -57,7 +58,7 @@ export async function writeManifest(projectRoot, data) {
  * @param {boolean} params.team - whether team config was installed
  * @param {string} [params.aiCli] - AI CLI command
  * @param {string} [params.rulesPreset] - rules preset name
- * @param {string[]} [params.extras] - installed extras (e.g. ['playwright-cli'])
+ * @param {string[]} [params.payloadPlatforms] - concrete platform payloads installed for platform + aiCli
  * @returns {Object} manifest
  */
 export function buildManifest({
@@ -73,14 +74,18 @@ export function buildManifest({
   aiCli,
   rulesPreset,
   extras,
+  payloadPlatforms,
 }) {
   const now = new Date().toISOString();
+  const installedPayloadPlatforms = payloadPlatforms?.length
+    ? [...new Set(payloadPlatforms)]
+    : resolvePayloadPlatforms(platform, aiCli);
   return {
     version,
     installedAt: now,
     updatedAt: now,
     platform,
-    runtime: runtime || 'unix',
+    runtime: normalizeRuntime(runtime),
     suite,
     options: {
       team: Boolean(team),
@@ -94,7 +99,8 @@ export function buildManifest({
       rules: [...rules],
       pipeline: pipeline ? [...pipeline] : [],
       extras: extras ? [...extras] : [],
-      other: [...new Set(expandPlatforms(platform).map(projectMemoryFile).filter(Boolean))],
+      payloadPlatforms: installedPayloadPlatforms,
+      other: [...new Set(installedPayloadPlatforms.map(projectMemoryFile).filter(Boolean))],
     },
   };
 }

package/src/metadata.js

@@ -9,7 +9,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { fileURLToPath } from 'url';
-import { normalizeRuntime, RUNTIME_WINDOWS } from './runtimes.js';
+import { normalizeRuntime } from './runtimes.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -72,25 +72,14 @@ export function getSkillsDir() {
 
 /**
  * Return candidate source directories for a skill in priority order.
- * Windows orchestration skills are intentionally sourced from a separate
- * tree so macOS/Linux content remains untouched.
+ * Retired Windows runtime aliases resolve to the canonical skill tree.
  */
-export function getSkillCandidatePaths(skillName, skillDef = {}, runtime = 'unix') {
-  const normalizedRuntime = normalizeRuntime(runtime);
+export function getSkillCandidatePaths(skillName, skillDef = {}, runtime = 'python') {
+  normalizeRuntime(runtime);
   const category = skillDef.category;
   const subcategory = skillDef.subcategory;
   const candidates = [];
 
-  if (normalizedRuntime === RUNTIME_WINDOWS && category) {
-    const windowsCategory = `${category}-windows`;
-    candidates.push(path.join(getBundledRoot(), 'skills-windows', skillName));
-    candidates.push(
-      subcategory
-        ? path.join(getFrameworkRoot(), 'core', 'skills', windowsCategory, subcategory, skillName)
-        : path.join(getFrameworkRoot(), 'core', 'skills', windowsCategory, skillName)
-    );
-  }
-
   candidates.push(path.join(getBundledRoot(), 'skills', skillName));
 
   if (category) {
@@ -147,9 +136,9 @@ export function getTemplatesDir() {
 /**
  * 获取 dev-pipeline 目录路径
  */
-export function getPipelineDir(runtime = 'unix') {
-  const normalizedRuntime = normalizeRuntime(runtime);
-  const dirName = normalizedRuntime === RUNTIME_WINDOWS ? 'dev-pipeline-windows' : 'dev-pipeline';
+export function getPipelineDir(runtime = 'python') {
+  normalizeRuntime(runtime);
+  const dirName = 'dev-pipeline';
   const bundledDir = path.join(getBundledRoot(), dirName);
   const coreDir = path.join(getFrameworkRoot(), dirName);