@givolt/i3-composer-agent 2.2.1 → 2.2.3

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,22 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { frontmatterYamlErrors } = require('./skill-lint.js');
+
+function validateAgents({ root, catalog }) {
+  let errors = 0;
+    for (const name of catalog.agents) {
+      const relative = `agents/${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 (!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++; }
+    }
+  return errors;
+}
+module.exports = { validateAgents };

package/bin/native-content.cjs

@@ -10,7 +10,6 @@ function replaceBlock(content, name, replacement) {
 // Adapt stable blocks, never their prose. Shared project commands work for
 // either Buddy client; global paths belong to the selected profile.
 function nativeContent(content, asset) {
-  if (asset.kind === 'support') return content;
   content = content.replaceAll('i3-composer-agent:', '').replaceAll('agent-skills:', '');
   if (!asset.buddyCommand) return content;
   const projectPersonas = '.codebuddy/agents/';

package/bin/native-layout.cjs

@@ -0,0 +1,169 @@
+'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) {
+  // Copied upstream test fixtures keep their original repository paths; the
+  // real installed runners always require the installation manifest.
+  const setup = "const INSTALLATION = (require('node:fs').existsSync(require('node:path').join(__dirname, 'lib', 'installation.js')) || require('node:path').basename(require('node:path').resolve(__dirname, '..')) === 'i3-composer-agent') ? require('./lib/installation.js').loadInstallation() : null;";
+  if (relative.startsWith('scripts/lib/') || relative === 'scripts/run-regressions.js') return text;
+  if (relative === 'scripts/validate-versions.js' || relative === 'scripts/validate-versions-test.js') {
+    return replaceOnce(text, 'const manifestPaths = [', setup + "\nconst MANIFEST_ROOT = INSTALLATION ? INSTALLATION.resources.adapters : require('node:path').resolve(__dirname, '..');\nconst manifestPaths = [", relative)
+      .replace('readFileSync(manifestPath, "utf8")', 'readFileSync(require("node:path").join(INSTALLATION && manifestPath === "package.json" ? INSTALLATION.toolkitRoot : MANIFEST_ROOT, manifestPath), "utf8")')
+      .replace('const expectedVersion = readManifestVersion("plugin.json");', 'const expectedVersion = readManifestVersion("plugin.json");\nif (INSTALLATION && expectedVersion !== INSTALLATION.manifest.version) throw new Error("插件版本与实际安装版本不一致");');
+  }
+  if (relative === 'scripts/floor-guard-reference-test.js') {
+    return replaceOnce(text, 'const REFERENCE = path.join(', setup + '\nconst REFERENCE = path.join(', relative)
+      .replace("__dirname, '..', 'skills',", "(INSTALLATION ? INSTALLATION.root : path.resolve(__dirname, '..')), 'skills',");
+  }
+  if (/-test\.js$/.test(relative)) return text;
+  if (relative === 'scripts/validate-skills.js') {
+    text = replaceOnce(text, "const SKILLS_DIR = path.resolve(__dirname, '..', 'skills');", setup + "\nconst SKILLS_DIR = INSTALLATION ? INSTALLATION.skillsDirectory : path.resolve(__dirname, '..', 'skills');", relative);
+    return replaceOnce(text, 'fs.readdirSync(SKILLS_DIR)', '(INSTALLATION ? INSTALLATION.catalog.skills : fs.readdirSync(SKILLS_DIR))', 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 ? INSTALLATION.root : path.resolve(__dirname, '..');", relative);
+  if (relative === 'scripts/run-evals.js') {
+    text = text.replaceAll("path.join(ROOT, 'evals',", "path.join(INSTALLATION ? INSTALLATION.resources.evals : path.join(ROOT, 'evals'),")
+      .replaceAll("path.join(ROOT, 'evals/zh-CN/cases')", "path.join(INSTALLATION ? INSTALLATION.resources.evals : path.join(ROOT, 'evals'), 'zh-CN/cases')");
+    return replaceOnce(text, 'fs.readdirSync(SKILLS_DIR)', '(INSTALLATION ? INSTALLATION.catalog.skills : fs.readdirSync(SKILLS_DIR))', relative);
+  }
+  if (relative === 'scripts/validate-reference-links.js') {
+    text = replaceOnce(text, 'fs.readdirSync(SKILLS_DIR)', '(INSTALLATION ? INSTALLATION.catalog.skills : fs.readdirSync(SKILLS_DIR))', relative);
+    return replaceOnce(text, 'references\\/[A-Za-z0-9._-]+\\.md', '(?:i3-composer-agent\\/)?references\\/(?:[A-Za-z0-9._-]+\\/)*[A-Za-z0-9._-]+\\.md', relative);
+  }
+  if (relative === 'scripts/validate-commands.js') {
+    text = replaceOnce(text, "path.join(ROOT, '.claude', 'commands')", "path.join(ROOT, INSTALLATION ? 'commands' : '.claude/commands')", relative);
+    text = replaceOnce(text, "path.join(ROOT, '.gemini', 'commands')", "path.join(INSTALLATION ? INSTALLATION.resources.adapters : ROOT, '.gemini', 'commands')", relative);
+    text = replaceOnce(text, "path.join(ROOT, 'commands')", "path.join(INSTALLATION ? INSTALLATION.resources.adapters : ROOT, 'commands')", relative);
+    text = replaceOnce(text, 'fs.readdirSync(dir)', "(INSTALLATION ? (ext === '.md' ? INSTALLATION.catalog.commands.map(name => name + '.md') : fs.readdirSync(dir).filter(file => INSTALLATION.catalog.commands.includes(NAME_MAP_REVERSE[path.basename(file, ext)] ?? path.basename(file, ext)))) : fs.readdirSync(dir))", relative);
+    return replaceOnce(text, '  let errors = 0;', "  let errors = INSTALLATION ? require('./lib/validate-agents.js').validateAgents(INSTALLATION) : 0;", 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}`);
+    text = text.replace(guarded, 'const GUARDED_FILES = INSTALLATION ? [\n' +
+      "  ...INSTALLATION.catalog.commands.map(name => 'commands/' + name + '.md'),\n" +
+      "  'skills/i3-spec-driven-development/SKILL.md', 'skills/i3-planning-and-task-breakdown/SKILL.md',\n" +
+      "  ...INSTALLATION.manifest.assets.filter(file => /^(?:i3-composer-agent\\/docs\\/(getting-started|adoption-guide|copilot-setup)\\.md|i3-composer-agent\\/adapters\\/(?:\\.gemini\\/commands|commands)\\/i3-(spec|planning|build)\\.toml)$/.test(file)),\n" +
+      '] : ' + guarded.slice('const GUARDED_FILES = '.length));
+    return text.replace(/^GUARDED_FILES\.push\(.*\);$/m, "if (!INSTALLATION) $&");
+  }
+  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 === 'toolkit-package') {
+    const pkg = JSON.parse(text);
+    return Buffer.from(JSON.stringify({ name: pkg.name, version: pkg.version, private: true,
+      type: 'commonjs', engines: pkg.engines, scripts: Object.fromEntries(
+        Object.entries(pkg.scripts).filter(([key]) => ['test', 'validate', 'eval', 'test:regression'].includes(key))) }, null, 2) + '\n');
+  }
+  if (asset.kind === 'toolkit-readme') return Buffer.from(
+    '# i3 Composer Agent 配套工具\n\n' +
+    '本目录提供评测、校验、回归测试、Hook、共享参考资料和使用指南。技能、命令和 Agent 位于上一级的对应目录，只有一份；这里的评测读取宿主实际安装的内容。\n\n' +
+    '进入本目录后运行：\n\n```bash\nnpm test\nnode scripts/run-evals.js --locale zh-CN --min-rank1 95\n```\n\n' +
+    '`npm test` 执行内容校验、中英文确定性评测及全部脚本回归测试，不需要 npm install。模型行为评测需要另行配置执行宿主；详见 [evals/README.md](evals/README.md)。\n\n' +
+    '`adapters/` 保留其他命令格式和插件清单，供原版一致性校验与回归测试使用，不自动注册或启用插件。Hook 需按宿主支持的事件单独启用；缓存与代码块保护分别详见 [hooks/SDD-CACHE.md](hooks/SDD-CACHE.md) 和 [hooks/SIMPLIFY-IGNORE.md](hooks/SIMPLIFY-IGNORE.md)。\n');
+  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\//g, '$1' + name + '/references/');
+  // 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', name + '/docs/agents.md');
+  }
+  if (relative.startsWith('hooks/')) text = text.replace(/\bhooks\//g, name + '/hooks/');
+  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', name + '/references', 'reference');
+  visit('README.md', name + '/docs/README.md', 'docs');
+  visit('README.md', name + '/README.md', 'toolkit-readme');
+  visit('package.json', name + '/package.json', 'toolkit-package');
+  for (const file of packageFiles) {
+    const category = file.split('/')[0];
+    if (!['evals', 'hooks', 'scripts', 'docs'].includes(category)) continue;
+    const relative = name + '/' + file;
+    visit(file, relative, category === 'scripts' ? 'script' : category);
+  }
+  visit('bin/native-runtime.cjs', name + '/scripts/lib/installation.js', 'runtime');
+  visit('bin/native-command-validation.cjs', name + '/scripts/lib/validate-agents.js', 'runtime');
+  for (const file of ['commands', '.gemini/commands', 'plugin.json', '.codex-plugin/plugin.json',
+    '.claude-plugin/plugin.json', '.claude-plugin/marketplace.json', '.agents/plugins/marketplace.json']) {
+    visit(file, name + '/adapters/' + file, 'adapter');
+  }
+  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', 'adapters'].map(category => [category, name + '/' + category]));
+  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,99 @@
+'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';
+const publishedFiles = new Set(inventory);
+
+function ownsAsset(previous, relative) {
+  return previous.assets.some(file => file === relative
+    || (!(previous.layoutVersion >= 2) && publishedFiles.has(relative) && relative.startsWith(file + '/')));
+}
+
+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.layoutVersion === 2) {
+    const oldEvals = path.join(base, 'evals', name);
+    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 = `${name}/evals/${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(`evals/${name}/${subpath}`);
+        }
+      }
+    }
+    if (fileAt(base, `evals/${name}`)) 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, ownsAsset };