@givolt/i3-composer-agent 2.2.0 → 2.2.2

package/bin/legacy-native-files.json

@@ -0,0 +1,329 @@
+{
+  "description": "Published native file inventory through 2.2.1; directory ownership never includes user additions.",
+  "files": [
+    "agents/code-reviewer.md",
+    "agents/security-auditor.md",
+    "agents/test-engineer.md",
+    "agents/web-performance-auditor.md",
+    "commands/build.md",
+    "commands/code-simplify.md",
+    "commands/constraints.md",
+    "commands/i3-build.md",
+    "commands/i3-code-simplify.md",
+    "commands/i3-constraints.md",
+    "commands/i3-plan.md",
+    "commands/i3-review.md",
+    "commands/i3-ship.md",
+    "commands/i3-spec.md",
+    "commands/i3-test.md",
+    "commands/i3-webperf.md",
+    "commands/plan.md",
+    "commands/review.md",
+    "commands/ship.md",
+    "commands/spec.md",
+    "commands/test.md",
+    "commands/webperf.md",
+    "docs/agents.md",
+    "i3-composer-agent-LICENSE",
+    "i3-composer-agent-NOTICE.md",
+    "i3-composer-agent/.agents/plugins/marketplace.json",
+    "i3-composer-agent/.claude-plugin/marketplace.json",
+    "i3-composer-agent/.claude-plugin/plugin.json",
+    "i3-composer-agent/.claude/commands/i3-build.md",
+    "i3-composer-agent/.claude/commands/i3-code-simplify.md",
+    "i3-composer-agent/.claude/commands/i3-constraints.md",
+    "i3-composer-agent/.claude/commands/i3-plan.md",
+    "i3-composer-agent/.claude/commands/i3-review.md",
+    "i3-composer-agent/.claude/commands/i3-ship.md",
+    "i3-composer-agent/.claude/commands/i3-spec.md",
+    "i3-composer-agent/.claude/commands/i3-test.md",
+    "i3-composer-agent/.claude/commands/i3-webperf.md",
+    "i3-composer-agent/.codex-plugin/plugin.json",
+    "i3-composer-agent/.gemini/commands/i3-build.toml",
+    "i3-composer-agent/.gemini/commands/i3-code-simplify.toml",
+    "i3-composer-agent/.gemini/commands/i3-constraints.toml",
+    "i3-composer-agent/.gemini/commands/i3-planning.toml",
+    "i3-composer-agent/.gemini/commands/i3-review.toml",
+    "i3-composer-agent/.gemini/commands/i3-ship.toml",
+    "i3-composer-agent/.gemini/commands/i3-spec.toml",
+    "i3-composer-agent/.gemini/commands/i3-test.toml",
+    "i3-composer-agent/.gemini/commands/i3-webperf.toml",
+    "i3-composer-agent/LICENSE",
+    "i3-composer-agent/README.md",
+    "i3-composer-agent/agents/code-reviewer.md",
+    "i3-composer-agent/agents/security-auditor.md",
+    "i3-composer-agent/agents/test-engineer.md",
+    "i3-composer-agent/agents/web-performance-auditor.md",
+    "i3-composer-agent/bin/agent-targets.json",
+    "i3-composer-agent/bin/asset-fingerprint.cjs",
+    "i3-composer-agent/bin/cleanup-backups.cjs",
+    "i3-composer-agent/bin/i3-composer-agent.cjs",
+    "i3-composer-agent/bin/install.cjs",
+    "i3-composer-agent/bin/native-content.cjs",
+    "i3-composer-agent/bin/skills-registry.LICENSE",
+    "i3-composer-agent/bin/tool-menu.cjs",
+    "i3-composer-agent/bin/tool-selector.cjs",
+    "i3-composer-agent/bin/wizard.cjs",
+    "i3-composer-agent/commands/i3-build.toml",
+    "i3-composer-agent/commands/i3-code-simplify.toml",
+    "i3-composer-agent/commands/i3-constraints.toml",
+    "i3-composer-agent/commands/i3-planning.toml",
+    "i3-composer-agent/commands/i3-review.toml",
+    "i3-composer-agent/commands/i3-ship.toml",
+    "i3-composer-agent/commands/i3-spec.toml",
+    "i3-composer-agent/commands/i3-test.toml",
+    "i3-composer-agent/commands/i3-webperf.toml",
+    "i3-composer-agent/docs/adoption-guide.md",
+    "i3-composer-agent/docs/agents.md",
+    "i3-composer-agent/docs/antigravity-setup.md",
+    "i3-composer-agent/docs/codebuddy-setup.md",
+    "i3-composer-agent/docs/codex-setup.md",
+    "i3-composer-agent/docs/commandcode-setup.md",
+    "i3-composer-agent/docs/copilot-cli-setup.md",
+    "i3-composer-agent/docs/copilot-setup.md",
+    "i3-composer-agent/docs/cursor-setup.md",
+    "i3-composer-agent/docs/gemini-cli-setup.md",
+    "i3-composer-agent/docs/getting-started.md",
+    "i3-composer-agent/docs/opencode-setup.md",
+    "i3-composer-agent/docs/other-hosts.md",
+    "i3-composer-agent/docs/windsurf-setup.md",
+    "i3-composer-agent/docs/workbuddy-setup.md",
+    "i3-composer-agent/evals/README.md",
+    "i3-composer-agent/evals/cases/i3-api-and-interface-design.json",
+    "i3-composer-agent/evals/cases/i3-browser-testing-with-devtools.json",
+    "i3-composer-agent/evals/cases/i3-ci-cd-and-automation.json",
+    "i3-composer-agent/evals/cases/i3-code-review-and-quality.json",
+    "i3-composer-agent/evals/cases/i3-code-simplification.json",
+    "i3-composer-agent/evals/cases/i3-constraint-driven-development.json",
+    "i3-composer-agent/evals/cases/i3-context-engineering.json",
+    "i3-composer-agent/evals/cases/i3-debugging-and-error-recovery.json",
+    "i3-composer-agent/evals/cases/i3-deprecation-and-migration.json",
+    "i3-composer-agent/evals/cases/i3-documentation-and-adrs.json",
+    "i3-composer-agent/evals/cases/i3-doubt-driven-development.json",
+    "i3-composer-agent/evals/cases/i3-frontend-ui-engineering.json",
+    "i3-composer-agent/evals/cases/i3-git-workflow-and-versioning.json",
+    "i3-composer-agent/evals/cases/i3-idea-refine.json",
+    "i3-composer-agent/evals/cases/i3-incremental-implementation.json",
+    "i3-composer-agent/evals/cases/i3-interview-me.json",
+    "i3-composer-agent/evals/cases/i3-observability-and-instrumentation.json",
+    "i3-composer-agent/evals/cases/i3-performance-optimization.json",
+    "i3-composer-agent/evals/cases/i3-planning-and-task-breakdown.json",
+    "i3-composer-agent/evals/cases/i3-security-and-hardening.json",
+    "i3-composer-agent/evals/cases/i3-shipping-and-launch.json",
+    "i3-composer-agent/evals/cases/i3-source-driven-development.json",
+    "i3-composer-agent/evals/cases/i3-spec-driven-development.json",
+    "i3-composer-agent/evals/cases/i3-test-driven-development.json",
+    "i3-composer-agent/evals/cases/i3-using-agent-skills.json",
+    "i3-composer-agent/evals/fixtures/i3-api-and-interface-design/service-brief.md",
+    "i3-composer-agent/evals/fixtures/i3-browser-testing-with-devtools/README.md",
+    "i3-composer-agent/evals/fixtures/i3-browser-testing-with-devtools/index.html",
+    "i3-composer-agent/evals/fixtures/i3-browser-testing-with-devtools/server.js",
+    "i3-composer-agent/evals/fixtures/i3-ci-cd-and-automation/package.json",
+    "i3-composer-agent/evals/fixtures/i3-ci-cd-and-automation/src/slug.js",
+    "i3-composer-agent/evals/fixtures/i3-ci-cd-and-automation/test/slug.test.js",
+    "i3-composer-agent/evals/fixtures/i3-code-review-and-quality/user-search.diff",
+    "i3-composer-agent/evals/fixtures/i3-code-simplification/config-parser.js",
+    "i3-composer-agent/evals/fixtures/i3-code-simplification/config-parser.test.js",
+    "i3-composer-agent/evals/fixtures/i3-context-engineering/context-audit.md",
+    "i3-composer-agent/evals/fixtures/i3-debugging-and-error-recovery/pagination.js",
+    "i3-composer-agent/evals/fixtures/i3-debugging-and-error-recovery/pagination.test.js",
+    "i3-composer-agent/evals/fixtures/i3-debugging-and-error-recovery/time-pressure.md",
+    "i3-composer-agent/evals/fixtures/i3-deprecation-and-migration/api-inventory.md",
+    "i3-composer-agent/evals/fixtures/i3-documentation-and-adrs/decision-context.md",
+    "i3-composer-agent/evals/fixtures/i3-doubt-driven-development/migration-plan.md",
+    "i3-composer-agent/evals/fixtures/i3-frontend-ui-engineering/Button.tsx",
+    "i3-composer-agent/evals/fixtures/i3-frontend-ui-engineering/design-system.md",
+    "i3-composer-agent/evals/fixtures/i3-git-workflow-and-versioning/.eval/working-tree.patch",
+    "i3-composer-agent/evals/fixtures/i3-git-workflow-and-versioning/app.js",
+    "i3-composer-agent/evals/fixtures/i3-git-workflow-and-versioning/app.test.js",
+    "i3-composer-agent/evals/fixtures/i3-incremental-implementation/reports.js",
+    "i3-composer-agent/evals/fixtures/i3-incremental-implementation/reports.test.js",
+    "i3-composer-agent/evals/fixtures/i3-incremental-implementation/tasks/plan.md",
+    "i3-composer-agent/evals/fixtures/i3-observability-and-instrumentation/operations.md",
+    "i3-composer-agent/evals/fixtures/i3-observability-and-instrumentation/payment-retry.js",
+    "i3-composer-agent/evals/fixtures/i3-performance-optimization/benchmark.js",
+    "i3-composer-agent/evals/fixtures/i3-performance-optimization/products.js",
+    "i3-composer-agent/evals/fixtures/i3-planning-and-task-breakdown/notifications-spec.md",
+    "i3-composer-agent/evals/fixtures/i3-security-and-hardening/webhook.js",
+    "i3-composer-agent/evals/fixtures/i3-security-and-hardening/webhook.test.js",
+    "i3-composer-agent/evals/fixtures/i3-shipping-and-launch/authority-pressure.md",
+    "i3-composer-agent/evals/fixtures/i3-shipping-and-launch/launch-status.md",
+    "i3-composer-agent/evals/fixtures/i3-source-driven-development/framework-task.md",
+    "i3-composer-agent/evals/fixtures/i3-spec-driven-development/billing-brief.md",
+    "i3-composer-agent/evals/fixtures/i3-test-driven-development/BUG.md",
+    "i3-composer-agent/evals/fixtures/i3-test-driven-development/README.md",
+    "i3-composer-agent/evals/fixtures/i3-test-driven-development/package.json",
+    "i3-composer-agent/evals/fixtures/i3-test-driven-development/src/split.js",
+    "i3-composer-agent/evals/fixtures/i3-test-driven-development/test/split.test.js",
+    "i3-composer-agent/evals/fixtures/i3-using-agent-skills/incident.md",
+    "i3-composer-agent/evals/fixtures/incremental-implementation-pressure/draft-export.js",
+    "i3-composer-agent/evals/fixtures/incremental-implementation-pressure/scenario.md",
+    "i3-composer-agent/evals/fixtures/spec-driven-development-decomposition/portal-brief.md",
+    "i3-composer-agent/evals/fixtures/test-driven-development-ecosystem/README.md",
+    "i3-composer-agent/evals/fixtures/test-driven-development-ecosystem/ledger.py",
+    "i3-composer-agent/evals/fixtures/test-driven-development-ecosystem/test_ledger.py",
+    "i3-composer-agent/evals/plugin/code-review-fires/graders/off-by-one.md",
+    "i3-composer-agent/evals/plugin/code-review-fires/graders/severity-labels.md",
+    "i3-composer-agent/evals/plugin/code-review-fires/graders/skill-fired.md",
+    "i3-composer-agent/evals/plugin/code-review-fires/prompt.md",
+    "i3-composer-agent/evals/plugin/code-review-stays-quiet-on-commit-message/graders/not-fired.md",
+    "i3-composer-agent/evals/plugin/code-review-stays-quiet-on-commit-message/prompt.md",
+    "i3-composer-agent/evals/plugin/code-review-stays-quiet/graders/not-fired.md",
+    "i3-composer-agent/evals/plugin/code-review-stays-quiet/graders/tdd-fired.md",
+    "i3-composer-agent/evals/plugin/code-review-stays-quiet/prompt.md",
+    "i3-composer-agent/evals/zh-CN/cases/i3-api-and-interface-design.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-browser-testing-with-devtools.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-ci-cd-and-automation.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-code-review-and-quality.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-code-simplification.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-constraint-driven-development.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-context-engineering.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-debugging-and-error-recovery.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-deprecation-and-migration.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-documentation-and-adrs.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-doubt-driven-development.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-frontend-ui-engineering.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-git-workflow-and-versioning.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-idea-refine.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-incremental-implementation.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-interview-me.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-observability-and-instrumentation.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-performance-optimization.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-planning-and-task-breakdown.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-security-and-hardening.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-shipping-and-launch.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-source-driven-development.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-spec-driven-development.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-test-driven-development.json",
+    "i3-composer-agent/evals/zh-CN/cases/i3-using-agent-skills.json",
+    "i3-composer-agent/hooks/SDD-CACHE.md",
+    "i3-composer-agent/hooks/SIMPLIFY-IGNORE.md",
+    "i3-composer-agent/hooks/sdd-cache-post.sh",
+    "i3-composer-agent/hooks/sdd-cache-pre.sh",
+    "i3-composer-agent/hooks/sdd-cache-test.sh",
+    "i3-composer-agent/hooks/session-start-test.sh",
+    "i3-composer-agent/hooks/session-start.sh",
+    "i3-composer-agent/hooks/simplify-ignore-test.sh",
+    "i3-composer-agent/hooks/simplify-ignore.sh",
+    "i3-composer-agent/package.json",
+    "i3-composer-agent/plugin.json",
+    "i3-composer-agent/references/accessibility-checklist.md",
+    "i3-composer-agent/references/definition-of-done.md",
+    "i3-composer-agent/references/observability-checklist.md",
+    "i3-composer-agent/references/orchestration-patterns.md",
+    "i3-composer-agent/references/performance-checklist.md",
+    "i3-composer-agent/references/security-checklist.md",
+    "i3-composer-agent/references/testing-patterns.md",
+    "i3-composer-agent/scripts/lib/skill-lint.js",
+    "i3-composer-agent/scripts/run-evals.js",
+    "i3-composer-agent/scripts/validate-artifact-paths.js",
+    "i3-composer-agent/scripts/validate-commands.js",
+    "i3-composer-agent/scripts/validate-reference-links.js",
+    "i3-composer-agent/scripts/validate-skills.js",
+    "i3-composer-agent/scripts/validate-versions.js",
+    "i3-composer-agent/skills/i3-api-and-interface-design/SKILL.md",
+    "i3-composer-agent/skills/i3-browser-testing-with-devtools/SKILL.md",
+    "i3-composer-agent/skills/i3-ci-cd-and-automation/SKILL.md",
+    "i3-composer-agent/skills/i3-code-review-and-quality/SKILL.md",
+    "i3-composer-agent/skills/i3-code-simplification/SKILL.md",
+    "i3-composer-agent/skills/i3-constraint-driven-development/SKILL.md",
+    "i3-composer-agent/skills/i3-constraint-driven-development/references/floor-guard.md",
+    "i3-composer-agent/skills/i3-context-engineering/SKILL.md",
+    "i3-composer-agent/skills/i3-debugging-and-error-recovery/SKILL.md",
+    "i3-composer-agent/skills/i3-deprecation-and-migration/SKILL.md",
+    "i3-composer-agent/skills/i3-documentation-and-adrs/SKILL.md",
+    "i3-composer-agent/skills/i3-doubt-driven-development/SKILL.md",
+    "i3-composer-agent/skills/i3-frontend-ui-engineering/SKILL.md",
+    "i3-composer-agent/skills/i3-git-workflow-and-versioning/SKILL.md",
+    "i3-composer-agent/skills/i3-idea-refine/SKILL.md",
+    "i3-composer-agent/skills/i3-idea-refine/examples.md",
+    "i3-composer-agent/skills/i3-idea-refine/frameworks.md",
+    "i3-composer-agent/skills/i3-idea-refine/refinement-criteria.md",
+    "i3-composer-agent/skills/i3-idea-refine/scripts/idea-refine.sh",
+    "i3-composer-agent/skills/i3-incremental-implementation/SKILL.md",
+    "i3-composer-agent/skills/i3-interview-me/SKILL.md",
+    "i3-composer-agent/skills/i3-observability-and-instrumentation/SKILL.md",
+    "i3-composer-agent/skills/i3-performance-optimization/SKILL.md",
+    "i3-composer-agent/skills/i3-performance-optimization/references/optimization-patterns.md",
+    "i3-composer-agent/skills/i3-planning-and-task-breakdown/SKILL.md",
+    "i3-composer-agent/skills/i3-security-and-hardening/SKILL.md",
+    "i3-composer-agent/skills/i3-security-and-hardening/references/hardening-patterns.md",
+    "i3-composer-agent/skills/i3-shipping-and-launch/SKILL.md",
+    "i3-composer-agent/skills/i3-source-driven-development/SKILL.md",
+    "i3-composer-agent/skills/i3-spec-driven-development/SKILL.md",
+    "i3-composer-agent/skills/i3-test-driven-development/SKILL.md",
+    "i3-composer-agent/skills/i3-using-agent-skills/SKILL.md",
+    "references/accessibility-checklist.md",
+    "references/definition-of-done.md",
+    "references/i3-composer-agent/LICENSE",
+    "references/observability-checklist.md",
+    "references/orchestration-patterns.md",
+    "references/performance-checklist.md",
+    "references/security-checklist.md",
+    "references/testing-patterns.md",
+    "skills/api-and-interface-design/SKILL.md",
+    "skills/browser-testing-with-devtools/SKILL.md",
+    "skills/ci-cd-and-automation/SKILL.md",
+    "skills/code-review-and-quality/SKILL.md",
+    "skills/code-simplification/SKILL.md",
+    "skills/constraint-driven-development/SKILL.md",
+    "skills/constraint-driven-development/references/floor-guard.md",
+    "skills/context-engineering/SKILL.md",
+    "skills/debugging-and-error-recovery/SKILL.md",
+    "skills/deprecation-and-migration/SKILL.md",
+    "skills/documentation-and-adrs/SKILL.md",
+    "skills/doubt-driven-development/SKILL.md",
+    "skills/frontend-ui-engineering/SKILL.md",
+    "skills/git-workflow-and-versioning/SKILL.md",
+    "skills/i3-api-and-interface-design/SKILL.md",
+    "skills/i3-browser-testing-with-devtools/SKILL.md",
+    "skills/i3-ci-cd-and-automation/SKILL.md",
+    "skills/i3-code-review-and-quality/SKILL.md",
+    "skills/i3-code-simplification/SKILL.md",
+    "skills/i3-constraint-driven-development/SKILL.md",
+    "skills/i3-constraint-driven-development/references/floor-guard.md",
+    "skills/i3-context-engineering/SKILL.md",
+    "skills/i3-debugging-and-error-recovery/SKILL.md",
+    "skills/i3-deprecation-and-migration/SKILL.md",
+    "skills/i3-documentation-and-adrs/SKILL.md",
+    "skills/i3-doubt-driven-development/SKILL.md",
+    "skills/i3-frontend-ui-engineering/SKILL.md",
+    "skills/i3-git-workflow-and-versioning/SKILL.md",
+    "skills/i3-idea-refine/SKILL.md",
+    "skills/i3-idea-refine/examples.md",
+    "skills/i3-idea-refine/frameworks.md",
+    "skills/i3-idea-refine/refinement-criteria.md",
+    "skills/i3-idea-refine/scripts/idea-refine.sh",
+    "skills/i3-incremental-implementation/SKILL.md",
+    "skills/i3-interview-me/SKILL.md",
+    "skills/i3-observability-and-instrumentation/SKILL.md",
+    "skills/i3-performance-optimization/SKILL.md",
+    "skills/i3-performance-optimization/references/optimization-patterns.md",
+    "skills/i3-planning-and-task-breakdown/SKILL.md",
+    "skills/i3-security-and-hardening/SKILL.md",
+    "skills/i3-security-and-hardening/references/hardening-patterns.md",
+    "skills/i3-shipping-and-launch/SKILL.md",
+    "skills/i3-source-driven-development/SKILL.md",
+    "skills/i3-spec-driven-development/SKILL.md",
+    "skills/i3-test-driven-development/SKILL.md",
+    "skills/i3-using-agent-skills/SKILL.md",
+    "skills/idea-refine/SKILL.md",
+    "skills/idea-refine/examples.md",
+    "skills/idea-refine/frameworks.md",
+    "skills/idea-refine/refinement-criteria.md",
+    "skills/idea-refine/scripts/idea-refine.sh",
+    "skills/incremental-implementation/SKILL.md",
+    "skills/interview-me/SKILL.md",
+    "skills/observability-and-instrumentation/SKILL.md",
+    "skills/performance-optimization/SKILL.md",
+    "skills/performance-optimization/references/optimization-patterns.md",
+    "skills/planning-and-task-breakdown/SKILL.md",
+    "skills/security-and-hardening/SKILL.md",
+    "skills/security-and-hardening/references/hardening-patterns.md",
+    "skills/shipping-and-launch/SKILL.md",
+    "skills/source-driven-development/SKILL.md",
+    "skills/spec-driven-development/SKILL.md",
+    "skills/test-driven-development/SKILL.md",
+    "skills/using-agent-skills/SKILL.md"
+  ]
+}

package/bin/native-command-validation.cjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { loadInstallation } = require('./lib/installation.cjs');
+const { frontmatterYamlErrors } = require('./lib/skill-lint.cjs');
+
+try {
+  const { root, catalog } = loadInstallation();
+  let errors = 0;
+  for (const category of ['commands', 'agents']) {
+    for (const name of catalog[category]) {
+      const relative = `${category}/${name}.md`;
+      const text = fs.readFileSync(path.join(root, relative), 'utf8');
+      const issues = frontmatterYamlErrors(text);
+      const frontmatter = text.match(/^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/)?.[1] || '';
+      if (!/^description:\s*\S/m.test(frontmatter)) issues.push('缺少 description');
+      if (category === 'agents' && !new RegExp(`^name:\\s*["']?${name}["']?\\s*$`, 'm').test(frontmatter)) issues.push('角色 name 与文件名不一致');
+      if (!text.replace(/^---[\s\S]*?\n---/, '').trim()) issues.push('缺少提示正文');
+      console.log(`${issues.length ? '✗' : '✓'} ${relative}`);
+      for (const issue of issues) { console.error(`  ${issue}`); errors++; }
+    }
+  }
+  console.log(`已检查 ${catalog.commands.length} 个命令、${catalog.agents.length} 个角色；${errors} 个错误。`);
+  process.exitCode = errors ? 1 : 0;
+} catch (error) { console.error(error.message); process.exitCode = 1; }

package/bin/native-layout.cjs

@@ -0,0 +1,135 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { nativeContent } = require('./native-content.cjs');
+const name = 'i3-composer-agent';
+
+function replaceOnce(text, before, after, label) {
+  if (text.split(before).length !== 2) throw new Error(`原生适配规则 ${label} 与发行包不匹配，请检查脚本变更。`);
+  return text.replace(before, after);
+}
+
+function nativeScript(text, relative) {
+  const setup = "const INSTALLATION = require('./lib/installation.cjs').loadInstallation();";
+  text = text.replaceAll("require('./lib/skill-lint')", "require('./lib/skill-lint.cjs')");
+  if (relative === 'scripts/lib/skill-lint.js') return text;
+  if (relative === 'scripts/validate-skills.js') {
+    text = replaceOnce(text, "const SKILLS_DIR = path.resolve(__dirname, '..', 'skills');", `${setup}\nconst SKILLS_DIR = INSTALLATION.skillsDirectory;`, relative);
+    return replaceOnce(text, 'fs.readdirSync(SKILLS_DIR)', 'INSTALLATION.catalog.skills', relative);
+  }
+  const rootDeclaration = relative === 'scripts/run-evals.js'
+    ? "const ROOT = path.join(__dirname, '..');" : "const ROOT = path.resolve(__dirname, '..');";
+  text = replaceOnce(text, rootDeclaration, `${setup}\nconst ROOT = INSTALLATION.root;`, relative);
+  if (relative === 'scripts/run-evals.js') {
+    text = text.replaceAll("path.join(ROOT, 'evals',", "path.join(INSTALLATION.resources.evals,")
+      .replaceAll("path.join(ROOT, 'evals/zh-CN/cases')", "path.join(INSTALLATION.resources.evals, 'zh-CN/cases')");
+    return replaceOnce(text, 'fs.readdirSync(SKILLS_DIR)', 'INSTALLATION.catalog.skills', relative);
+  }
+  if (relative === 'scripts/validate-reference-links.js') {
+    text = replaceOnce(text, 'fs.readdirSync(SKILLS_DIR)', 'INSTALLATION.catalog.skills', relative);
+    return replaceOnce(text, 'references\\/[A-Za-z0-9._-]+\\.md', 'references\\/(?:[A-Za-z0-9._-]+\\/)*[A-Za-z0-9._-]+\\.md', relative);
+  }
+  if (relative === 'scripts/validate-artifact-paths.js') {
+    const guarded = text.match(/const GUARDED_FILES = \[[\s\S]*?\n\];/)?.[0];
+    if (!guarded) throw new Error(`缺少原生产物检查配置：${relative}`);
+    return text.replace(guarded, `const GUARDED_FILES = [
+  ...INSTALLATION.catalog.commands.map(name => 'commands/' + name + '.md'),
+  'skills/i3-spec-driven-development/SKILL.md',
+  'skills/i3-planning-and-task-breakdown/SKILL.md',
+  ...INSTALLATION.manifest.assets.filter(file => /^docs\\/i3-composer-agent\\/(getting-started|adoption-guide|copilot-setup)\\.md$/.test(file)),
+];`);
+  }
+  throw new Error(`尚未适配的公共脚本：${relative}`);
+}
+
+function renderAsset(buffer, asset) {
+  const relative = asset.sourceRelative || '';
+  if (relative.startsWith('evals/fixtures/')) return buffer;
+  let text = buffer.toString('utf8');
+  if (asset.kind === 'runtime') return Buffer.from(text.replace('__I3_INSTALL_VERSION__', asset.version));
+  if (asset.kind === 'script') return Buffer.from(nativeScript(text, relative));
+  if (relative === 'hooks/session-start.sh') {
+    return Buffer.from(replaceOnce(text, 'SKILLS_DIR="$(dirname "$SCRIPT_DIR")/skills"',
+      'SKILLS_DIR="$(dirname "$(dirname "$SCRIPT_DIR")")/skills"', relative));
+  }
+  if (/^hooks\/.*-test\.sh$/.test(relative)) {
+    // Tests use their sibling hooks, including when invoked from another cwd.
+    text = text.replace(/(set -[^\n]+\n)/, '$1\nI3_HOOK_TEST_DIR="$(cd "$(dirname "$0")" && pwd)"\n');
+    text = text.replace(/"hooks\/\$script"/g, '"$I3_HOOK_TEST_DIR/$script"')
+      .replace(/(?<![A-Za-z0-9_/-])hooks\/([a-z-]+\.sh)(?![A-Za-z0-9_-])/g, '"$I3_HOOK_TEST_DIR/$1"');
+    return Buffer.from(text);
+  }
+  if (!relative.endsWith('.md')) return buffer;
+  if (['skill', 'command', 'persona', 'reference'].includes(asset.kind)) text = nativeContent(text, asset);
+  if (asset.kind === 'skill') {
+    text = text.replace(/^bash (skills\/[a-z0-9-]+\/scripts\/[a-z0-9.-]+\.sh)$/gm, (command, source) => {
+      const mapped = asset.mapping?.[source];
+      if (!mapped) throw new Error(`技能引用了未安装的脚本：${source}`);
+      const file = path.join(asset.base, mapped).replaceAll('\\', '/');
+      return "bash '" + file.replaceAll("'", "'\\''") + "'";
+    });
+  }
+  // Shared references move; skill-local references and executable assets stay.
+  text = text.replace(/((?:\.\.\/){2,})references\/(?!i3-composer-agent\/)/g, `$1references/${name}/`);
+  // Resolve actual Markdown links through the same source-to-destination map.
+  text = text.replace(/(\]\()([^\s)#]+)(#[^\s)]+)?(\))/g, (match, open, link, fragment = '', close) => {
+    if (/^(?:[a-z]+:|\/)/i.test(link)) return match;
+    const source = path.posix.normalize(path.posix.join(path.posix.dirname(relative), link));
+    const mapped = asset.mapping?.[source];
+    if (!mapped) return match;
+    return open + path.posix.relative(path.posix.dirname(asset.relative), mapped) + fragment + close;
+  });
+  if (asset.kind === 'command' || asset.kind === 'persona') {
+    text = text.replaceAll('docs/agents.md', `docs/${name}/agents.md`);
+  }
+  if (relative.startsWith('hooks/')) text = text.replace(/\bhooks\/(?!i3-composer-agent\/)/g, `hooks/${name}/`);
+  return Buffer.from(text);
+}
+
+// Enumerate individual files so user-created files inside installed directories
+// never become implicitly owned. Package allowlists remain authoritative.
+function nativeAssets(root, target, packageFiles, version) {
+  const assets = [];
+  const mapping = {};
+  function visit(sourceRelative, relative, kind) {
+    const source = path.join(root, sourceRelative);
+    const stat = fs.lstatSync(source);
+    if (stat.isSymbolicLink()) throw new Error(`包内容中包含符号链接（symlink）：${source}`);
+    if (stat.isDirectory()) {
+      for (const entry of fs.readdirSync(source).sort()) {
+        if (['.DS_Store', 'results', 'node_modules', '.git', '__pycache__'].includes(entry)) continue;
+        visit(`${sourceRelative}/${entry}`, `${relative}/${entry}`, kind);
+      }
+    } else if (stat.isFile()) {
+      if (assets.some(asset => asset.relative === relative)) return;
+      mapping[sourceRelative] = relative;
+      assets.push({ source, sourceRelative, relative, destination: path.join(target.base, relative), kind, version });
+    } else throw new Error(`不支持的包文件：${source}`);
+  }
+  visit('skills', 'skills', 'skill');
+  visit('.claude/commands', 'commands', 'command');
+  visit('agents', 'agents', 'persona');
+  visit('references', `references/${name}`, 'reference');
+  visit('README.md', `docs/${name}/README.md`, 'docs');
+  for (const file of packageFiles) {
+    const category = file.split('/')[0];
+    if (!['evals', 'hooks', 'scripts', 'docs'].includes(category)) continue;
+    if (file === 'scripts/validate-commands.js' || file === 'scripts/validate-versions.js') continue;
+    const relative = `${category}/${name}${file.slice(category.length)}`.replace(/\.js$/, category === 'scripts' ? '.cjs' : '.js');
+    visit(file, relative, category === 'scripts' ? 'script' : category);
+  }
+  visit('bin/native-runtime.cjs', `scripts/${name}/lib/installation.cjs`, 'runtime');
+  visit('bin/native-command-validation.cjs', `scripts/${name}/validate-commands.cjs`, 'native-validator');
+  visit('bin/native-version-validation.cjs', `scripts/${name}/validate-versions.cjs`, 'native-validator');
+  target.catalog = {
+    skills: fs.readdirSync(path.join(root, 'skills')).filter(id => fs.existsSync(path.join(root, 'skills', id, 'SKILL.md'))).sort(),
+    commands: fs.readdirSync(path.join(root, '.claude/commands')).filter(file => file.endsWith('.md')).map(file => file.slice(0, -3)).sort(),
+    agents: fs.readdirSync(path.join(root, 'agents')).filter(file => file.endsWith('.md')).map(file => file.slice(0, -3)).sort(),
+  };
+  target.resources = Object.fromEntries(['references', 'evals', 'hooks', 'scripts', 'docs'].map(category => [category, `${category}/${name}`]));
+  for (const asset of assets) { asset.mapping = mapping; asset.base = target.base; }
+  return assets;
+}
+
+module.exports = { nativeAssets, renderAsset };

package/bin/native-migration.cjs

@@ -0,0 +1,93 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { fingerprint } = require('./asset-fingerprint.cjs');
+const inventory = require('./legacy-native-files.json').files;
+const name = 'i3-composer-agent';
+
+function allowed(relative) {
+  return typeof relative === 'string' && !relative.includes('\0') && !relative.includes(':') && !relative.includes('\\')
+    && !relative.split('/').some(part => ['', '.', '..'].includes(part))
+    && (/^(skills|commands|agents|references|evals|hooks|scripts|docs)\//.test(relative)
+      || relative.startsWith(`${name}/`) || [`${name}-LICENSE`, `${name}-NOTICE.md`].includes(relative));
+}
+
+function fileAt(base, relative) {
+  if (!allowed(relative)) return undefined;
+  let file = base;
+  for (const part of relative.split('/')) {
+    file = path.join(file, part);
+    try { if (fs.lstatSync(file).isSymbolicLink()) return undefined; }
+    catch (error) { if (error.code === 'ENOENT') return undefined; throw error; }
+  }
+  return file;
+}
+
+function migrationAssets(target, previous, current) {
+  if (!previous) return [];
+  const assets = [];
+  const oldFiles = new Set();
+  const retired = new Set();
+  const base = target.base;
+  function retire(relative) {
+    if (retired.has(relative) || current.has(relative)) return;
+    const file = fileAt(base, relative);
+    if (!file || !fs.statSync(file).isFile()) return;
+    retired.add(relative);
+    assets.push({ base, destination: file, relative, kind: 'legacy' });
+  }
+  for (const relative of previous.assets) {
+    const file = fileAt(base, relative);
+    if (!file) continue;
+    if (fs.statSync(file).isFile()) oldFiles.add(relative);
+    else if (previous.layoutVersion !== 2) {
+      // Old manifests registered directories, not their contents. Expand only
+      // paths in the published inventory, never the current filesystem tree.
+      for (const known of inventory) if (known.startsWith(relative + '/')) oldFiles.add(known);
+    }
+  }
+  for (const relative of oldFiles) retire(relative);
+
+  // Evaluation output is user data, not an installed package asset. Move it
+  // transactionally, including plugin and locale-specific result folders.
+  if (previous.assets.some(file => typeof file === 'string' && file.startsWith(`${name}/`))) {
+    const oldEvals = path.join(base, name, 'evals');
+    function visit(directory, relative = '') {
+      if (!fs.existsSync(directory)) return;
+      for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        const source = path.join(directory, entry.name);
+        const subpath = relative ? `${relative}/${entry.name}` : entry.name;
+        if (entry.isSymbolicLink()) continue;
+        if (entry.isDirectory()) visit(source, subpath);
+        else if (entry.isFile() && subpath.split('/').includes('results')) {
+          const destinationRelative = `evals/${name}/${subpath}`;
+          const destination = path.join(base, destinationRelative);
+          let reusable = false;
+          if (fs.existsSync(destination)) {
+            reusable = fingerprint(source) === fingerprint(destination);
+            if (!reusable) throw new Error(`评测结果迁移冲突，请先处理同名文件：${destination}`);
+          }
+          assets.push({ base, source, destination, relative: destinationRelative, kind: 'result', reusable,
+            expectedFingerprint: fingerprint(source) });
+          retire(`${name}/evals/${subpath}`);
+        }
+      }
+    }
+    if (fileAt(base, `${name}/evals`)) visit(oldEvals);
+  }
+  return assets;
+}
+
+function pruneRetiredDirectories(assets) {
+  const directories = new Set();
+  for (const asset of assets.filter(item => item.kind === 'legacy')) {
+    for (let directory = path.dirname(asset.destination); directory !== asset.base && directory.startsWith(asset.base + path.sep); directory = path.dirname(directory)) directories.add(directory);
+  }
+  for (const directory of [...directories].sort((a, b) => b.length - a.length)) {
+    try { fs.rmdirSync(directory); }
+    catch (error) { if (!['ENOENT', 'ENOTEMPTY', 'EEXIST'].includes(error.code)) throw error; }
+  }
+}
+
+module.exports = { migrationAssets, pruneRetiredDirectories };

package/bin/native-runtime.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+// Installed as scripts/i3-composer-agent/lib/installation.cjs. Resolve from
+// this file, never the caller's working directory or the host's package.json.
+const fs = require('node:fs');
+const path = require('node:path');
+const EXPECTED_VERSION = '__I3_INSTALL_VERSION__';
+const root = path.resolve(__dirname, '../../..');
+const manifestPath = path.join(root, '.i3-composer-agent.json');
+
+function resolveOwned(relative) {
+  if (typeof relative !== 'string' || relative.includes('\\') || relative.includes(':')
+      || relative.includes('\0') || relative.split('/').some(part => ['', '.', '..'].includes(part))) {
+    throw new Error(`安装清单路径无效：${relative}`);
+  }
+  let file = root;
+  for (const part of relative.split('/')) {
+    file = path.join(file, part);
+    if (!fs.existsSync(file)) throw new Error(`安装内容缺失：${relative}`);
+    if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`安装内容不能通过符号链接替代：${relative}`);
+  }
+  if (!fs.statSync(file).isFile()) throw new Error(`安装文件无效：${relative}`);
+  return file;
+}
+
+function loadInstallation() {
+  let manifest;
+  try { manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')); }
+  catch (error) { throw new Error(`无法读取安装清单 ${manifestPath}：${error.message}`); }
+  if (manifest.name !== 'i3-composer-agent' || manifest.layoutVersion !== 2
+      || manifest.version !== EXPECTED_VERSION || !Array.isArray(manifest.assets) || !manifest.assets.length) {
+    throw new Error(`安装清单的名称、布局或版本不匹配：${manifestPath}`);
+  }
+  const assets = new Set(manifest.assets);
+  for (const [category, suffix] of [['skills', '/SKILL.md'], ['commands', '.md'], ['agents', '.md']]) {
+    const names = manifest.catalog?.[category];
+    if (!Array.isArray(names) || !names.length || new Set(names).size !== names.length) {
+      throw new Error(`安装清单缺少有效的 ${category} 目录项：${manifestPath}`);
+    }
+    for (const name of names) {
+      if (typeof name !== 'string' || !/^[a-z0-9][a-z0-9-]*$/.test(name)
+          || !assets.has(`${category}/${name}${suffix}`)) throw new Error(`安装清单目录项无效：${category}/${name}`);
+    }
+  }
+  for (const relative of assets) resolveOwned(relative);
+  const resources = {};
+  for (const category of ['references', 'evals', 'hooks', 'scripts', 'docs']) {
+    const relative = `${category}/i3-composer-agent`;
+    if (manifest.resources?.[category] !== relative || ![...assets].some(file => file.startsWith(relative + '/'))) {
+      throw new Error(`安装清单缺少资源：${category}`);
+    }
+    resources[category] = path.join(root, relative);
+  }
+  return { root, manifest, catalog: manifest.catalog, resources, skillsDirectory: path.join(root, 'skills') };
+}
+
+module.exports = { loadInstallation };