@mison/ag-kit-cn 2.0.1 → 3.0.0

package/tests/package-tarball.test.js

@@ -0,0 +1,27 @@
+const { test, describe } = require("node:test");
+const assert = require("node:assert");
+const path = require("path");
+const { spawnSync } = require("node:child_process");
+
+const REPO_ROOT = path.resolve(__dirname, "..");
+
+describe("Package Tarball", () => {
+    test("npm pack --dry-run should include maintenance scripts and tests", () => {
+        const result = spawnSync("npm", ["pack", "--json", "--dry-run"], {
+            cwd: REPO_ROOT,
+            encoding: "utf8",
+        });
+        assert.strictEqual(result.status, 0, result.stderr || result.stdout);
+
+        const payload = JSON.parse(result.stdout);
+        assert.ok(Array.isArray(payload) && payload.length > 0, "missing npm pack json payload");
+
+        const files = new Set(payload[0].files.map((item) => item.path));
+        assert.ok(files.has("scripts/clean.js"), "tarball missing scripts/clean.js");
+        assert.ok(files.has("scripts/ci-verify.js"), "tarball missing scripts/ci-verify.js");
+        assert.ok(files.has("scripts/health-check.js"), "tarball missing scripts/health-check.js");
+        assert.ok(files.has("scripts/health-check.sh"), "tarball missing scripts/health-check.sh");
+        assert.ok(files.has("tests/cli-smoke.test.js"), "tarball missing tests/cli-smoke.test.js");
+        assert.ok(files.has("tests/global-sync.test.js"), "tarball missing tests/global-sync.test.js");
+    });
+});

package/tests/phase-c.test.js

@@ -0,0 +1,107 @@
+const { test, describe, beforeEach, afterEach } = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const CodexAdapter = require('../bin/adapters/codex');
+const pkg = require('../package.json');
+
+describe('Phase C Integration', () => {
+    let workDir;
+    let geminiRepo;
+
+    beforeEach(() => {
+        workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'phase-c-test-'));
+        geminiRepo = path.join(workDir, 'gemini-repo');
+        
+        // Setup specialized Gemini-like structure
+        const agentDir = path.join(geminiRepo, '.agent');
+        const skillsDir = path.join(agentDir, 'skills');
+        const workflowsDir = path.join(agentDir, 'workflows');
+        
+        fs.mkdirSync(skillsDir, { recursive: true });
+        fs.mkdirSync(workflowsDir, { recursive: true });
+        
+        // Create a Skill
+        const skillPath = path.join(skillsDir, 'test-skill');
+        fs.mkdirSync(skillPath);
+        fs.writeFileSync(path.join(skillPath, 'SKILL.md'), '# Test Skill');
+        
+        // Create a Workflow
+        fs.writeFileSync(path.join(workflowsDir, 'test-flow.md'), '# Test Workflow');
+    });
+
+    afterEach(() => {
+        fs.rmSync(workDir, { recursive: true, force: true });
+    });
+
+    test('CodexAdapter should build from Gemini structure on the fly', () => {
+        const options = { quiet: true, force: true };
+        const adapter = new CodexAdapter(workDir, options);
+        
+        // Install from Gemini Repo Root
+        adapter.install(geminiRepo);
+        
+        const codexDir = path.join(workDir, '.agents');
+        // Verification 1: Structure Created
+        assert.ok(fs.existsSync(codexDir));
+        
+        // Verification 2: Transformation Happened
+        const builtSkill = path.join(codexDir, 'skills', 'test-skill', 'SKILL.md');
+        assert.ok(fs.existsSync(builtSkill));
+        
+        // Workflow: workflow-test-flow
+        const builtWorkflow = path.join(codexDir, 'skills', 'workflow-test-flow', 'SKILL.md');
+        assert.ok(fs.existsSync(builtWorkflow));
+        
+        // Verification 3: Manifest & Meta
+        assert.ok(fs.existsSync(path.join(codexDir, 'codex.json')));
+        assert.ok(fs.existsSync(path.join(codexDir, 'AGENTS.md')));
+        assert.ok(fs.existsSync(path.join(codexDir, 'antigravity.rules')));
+        
+        const agentsMd = fs.readFileSync(path.join(codexDir, 'AGENTS.md'), 'utf8');
+        assert.ok(agentsMd.includes('test-skill'));
+        assert.ok(agentsMd.includes('(Codex Managed)'));
+
+        // Verification 4: Workspace managed block injection
+        const workspaceAgents = fs.readFileSync(path.join(workDir, 'AGENTS.md'), 'utf8');
+        const workspaceRules = fs.readFileSync(path.join(workDir, 'antigravity.rules'), 'utf8');
+        assert.ok(workspaceAgents.includes('BEGIN AG-KIT MANAGED BLOCK: codex-core-rules'));
+        assert.ok(workspaceAgents.includes('test-skill'));
+        assert.ok(workspaceRules.includes('BEGIN AG-KIT MANAGED BLOCK: codex-risk-controls'));
+
+        const codexJson = JSON.parse(fs.readFileSync(path.join(codexDir, 'codex.json'), 'utf8'));
+        assert.strictEqual(codexJson.version, pkg.version);
+        assert.ok(agentsMd.includes(`Version: ${pkg.version}`));
+        assert.ok(workspaceRules.includes(`version: ${pkg.version}`));
+    });
+
+    test('CodexBuilder should avoid ID collisions between skills and workflows', () => {
+        const skillCollisionPath = path.join(geminiRepo, '.agent', 'skills', 'wf-test-flow');
+        fs.mkdirSync(skillCollisionPath, { recursive: true });
+        fs.writeFileSync(path.join(skillCollisionPath, 'SKILL.md'), '# Skill wf-test-flow');
+
+        const options = { quiet: true, force: true };
+        const adapter = new CodexAdapter(workDir, options);
+        adapter.install(geminiRepo);
+
+        const codexJson = JSON.parse(
+            fs.readFileSync(path.join(workDir, '.agents', 'codex.json'), 'utf8')
+        );
+        const collisionEntries = (codexJson.skills || []).filter(
+            (item) => item.originalName === 'wf-test-flow' || item.originalName === 'test-flow'
+        );
+
+        assert.strictEqual(collisionEntries.length, 2, 'skill/workflow should both be preserved');
+        assert.notStrictEqual(
+            collisionEntries[0].id,
+            collisionEntries[1].id,
+            'colliding IDs should be disambiguated',
+        );
+
+        for (const entry of collisionEntries) {
+            const skillFile = path.join(workDir, '.agents', entry.path);
+            assert.ok(fs.existsSync(skillFile), `missing transformed file: ${entry.path}`);
+        }
+    });
+});

package/tests/standards-compliance.test.js

@@ -0,0 +1,266 @@
+const { test, describe } = require('node:test');
+const assert = require('node:assert');
+const fs = require('fs');
+const path = require('path');
+
+const REF_ROOT = path.resolve('reference/antigravity-kit');
+const REF_AGENTS_ROOT = path.resolve('reference/antigravity-kit/.agents');
+const REF_LEGACY_AGENT_ROOT = path.resolve('reference/antigravity-kit/.agent');
+const REF_SCRIPTS_ROOT = fs.existsSync(REF_AGENTS_ROOT) ? REF_AGENTS_ROOT : REF_LEGACY_AGENT_ROOT;
+const HAS_REF_SCRIPTS_ROOT = fs.existsSync(REF_SCRIPTS_ROOT);
+
+function collectTokens(content, regex) {
+    const tokens = new Set();
+    for (const match of String(content || "").matchAll(regex)) {
+        tokens.add(match[1] || match[0]);
+    }
+    return tokens;
+}
+
+describe('Standards Compliance', () => {
+    test('all skill directories should include SKILL.md', () => {
+        const skillsRoot = path.resolve('.agents/skills');
+        assert.ok(fs.existsSync(skillsRoot), 'missing .agents/skills');
+
+        const skillDirs = fs
+            .readdirSync(skillsRoot, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => path.join(skillsRoot, entry.name));
+
+        for (const dir of skillDirs) {
+            const skillMd = path.join(dir, 'SKILL.md');
+            assert.ok(fs.existsSync(skillMd), `missing SKILL.md in ${path.relative(process.cwd(), dir)}`);
+        }
+    });
+
+    test('deprecated .codex primary-layout wording should be removed from user-facing docs and generator', () => {
+        const targets = [
+            'README.md',
+            'docs/PLAN.md',
+            'docs/TECH.md',
+            'bin/core/generator.js',
+        ];
+        const skipped = [];
+
+        for (const rel of targets) {
+            const abs = path.resolve(rel);
+            if (!fs.existsSync(abs)) {
+                skipped.push(rel);
+                continue;
+            }
+            const content = fs.readFileSync(abs, 'utf8');
+            assert.ok(!content.includes('Managed resources are synchronized under `.codex/`.'), `${rel} still contains deprecated .codex guidance`);
+            assert.ok(!content.includes('Do not edit files under `.codex/` directly.'), `${rel} still contains deprecated .codex guidance`);
+        }
+
+        if (skipped.length > 0) {
+            console.warn(`[standards-compliance] skipped missing optional files: ${skipped.join(', ')}`);
+        }
+    });
+
+    test('critical mechanism tokens should remain aligned with reference snapshot', { skip: !fs.existsSync(REF_ROOT) }, () => {
+        const refRoot = REF_ROOT;
+        const tokenRegex = /(ag-kit|python3?|checklist\.py|verify_all\.py|security_scan\.py|ux_audit\.py|accessibility_checker\.py|schema_validator\.py|lint_runner\.py|type_coverage\.py|playwright_runner\.py|lighthouse_audit\.py|api_validator\.py|mobile_audit\.py|seo_checker\.py|geo_checker\.py|i18n_checker\.py|\.agent\/|\.agents\/|\.agents-backup\/|\.codex\/|AGENTS\.md|antigravity\.rules|manifest\.json|--target|--targets|--fix|--path|--no-index|--dry-run|--quiet|--force)/g;
+        const slashCommandRegex = /(?:^|[\s`"'(\[])(\/(?:brainstorm|create|debug|deploy|enhance|orchestrate|plan|preview|status|test|ui-ux-pro-max))(?=$|[\s`"'，。,.:：)\]])/gm;
+
+        const markdownFiles = [];
+        const stack = [refRoot];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+                const abs = path.join(current, entry.name);
+                if (entry.isDirectory()) {
+                    stack.push(abs);
+                    continue;
+                }
+                if (/\.(md|mdx|txt)$/i.test(entry.name)) {
+                    markdownFiles.push(abs);
+                }
+            }
+        }
+
+        const mismatches = [];
+        for (const refFile of markdownFiles) {
+            const rel = path.relative(refRoot, refFile);
+            const localFile = path.resolve(rel);
+            if (!fs.existsSync(localFile)) continue;
+
+            const refContent = fs.readFileSync(refFile, 'utf8');
+            const refTokens = new Set([
+                ...collectTokens(refContent, tokenRegex),
+                ...collectTokens(refContent, slashCommandRegex),
+            ]);
+            if (refTokens.size === 0) continue;
+
+            const localContent = fs.readFileSync(localFile, 'utf8');
+            const localTokens = new Set([
+                ...collectTokens(localContent, tokenRegex),
+                ...collectTokens(localContent, slashCommandRegex),
+            ]);
+
+            const missing = [...refTokens].filter((token) => !localTokens.has(token));
+            if (missing.length > 0) {
+                mismatches.push({ rel, missing });
+            }
+        }
+
+        assert.strictEqual(
+            mismatches.length,
+            0,
+            `critical mechanism tokens drifted:\n${mismatches
+                .slice(0, 10)
+                .map((item) => `${item.rel} -> ${item.missing.join(', ')}`)
+                .join('\n')}`,
+        );
+    });
+
+    test('user-facing docs should track current repo and global skill locations', () => {
+        const file = path.resolve('docs/TECH.md');
+        const content = fs.readFileSync(file, 'utf8');
+
+        assert.ok(content.includes('$HOME/.codex/skills/'), 'missing global skill path: $HOME/.codex/skills/');
+        assert.ok(content.includes('$HOME/.gemini/skills/'), 'missing global skill path: $HOME/.gemini/skills/');
+        assert.ok(content.includes('$HOME/.gemini/antigravity/skills/'), 'missing global skill path: $HOME/.gemini/antigravity/skills/');
+        assert.ok(content.includes('.agents/skills'), 'missing repo skill path: .agents/skills');
+        assert.ok(!content.includes('$HOME/.agents/skills/'), 'should not contain deprecated global path: $HOME/.agents/skills/');
+    });
+
+    test('.agents script files should stay identical to reference snapshot', { skip: !HAS_REF_SCRIPTS_ROOT }, () => {
+        const refScriptsRoot = REF_SCRIPTS_ROOT;
+        const mismatches = [];
+
+        const stack = [refScriptsRoot];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+                const abs = path.join(current, entry.name);
+                if (entry.isDirectory()) {
+                    stack.push(abs);
+                    continue;
+                }
+                if (!abs.includes(`${path.sep}scripts${path.sep}`)) continue;
+                if (abs.includes(`${path.sep}__pycache__${path.sep}`) || abs.endsWith('.pyc')) continue;
+
+                const rel = path.relative(refScriptsRoot, abs);
+                const localFile = path.resolve('.agents', rel);
+                if (!fs.existsSync(localFile)) {
+                    mismatches.push(`${rel} (missing local file)`);
+                    continue;
+                }
+
+                const refContent = fs.readFileSync(abs, 'utf8');
+                const localContent = fs.readFileSync(localFile, 'utf8');
+                if (refContent !== localContent) {
+                    mismatches.push(rel);
+                }
+            }
+        }
+
+        assert.strictEqual(
+            mismatches.length,
+            0,
+            `script content drifted:\n${mismatches.slice(0, 20).join('\n')}`,
+        );
+    });
+
+    test('critical path handling should avoid hardcoded platform separators in managed paths', () => {
+        const adapterFile = path.resolve('bin/adapters/codex.js');
+        const content = fs.readFileSync(adapterFile, 'utf8');
+
+        // Keep this focused on managed path constants that must remain path.join-driven.
+        assert.ok(content.includes('path.join'), 'codex adapter should use path.join for managed paths');
+        assert.ok(content.includes('os.tmpdir()'), 'codex adapter should use os.tmpdir() for temp paths');
+    });
+
+    test('official antigravity docs baselines should be present in localized pages', () => {
+        const checks = [
+            {
+                file: 'web/src/app/docs/skills/page.tsx',
+                required: [
+                    'SKILL.md',
+                    'workspace-root',
+                    '~/.gemini/antigravity/skills',
+                    'description',
+                    'scripts/',
+                    'examples/',
+                    'resources/',
+                    'Discovery',
+                    'Activation',
+                    'Execution',
+                    '--help',
+                ],
+            },
+            {
+                file: 'web/src/app/docs/rules-workflows/page.tsx',
+                required: [
+                    '12,000',
+                    '~/.gemini/GEMINI.md',
+                    '.agent/rules',
+                    'Manual',
+                    'Always On',
+                    'Model Decision',
+                    'Glob',
+                    '@filename',
+                    '/workflow-name',
+                ],
+            },
+            {
+                file: 'web/src/app/docs/task-groups/page.tsx',
+                required: ['规划模式', '总体目标', '已编辑文件', '待处理区'],
+            },
+            {
+                file: 'web/src/app/docs/strict-mode/page.tsx',
+                required: ['Allowlist/Denylist', 'Request Review', '.gitignore', '工作区隔离'],
+            },
+            {
+                file: 'web/src/app/docs/sandbox-mode/page.tsx',
+                required: [
+                    'sandbox-exec',
+                    'Enable Terminal Sandboxing',
+                    'Sandbox Allow Network',
+                    'Bypass Sandbox',
+                    'Strict Mode',
+                ],
+            },
+            {
+                file: 'web/src/app/docs/mcp/page.tsx',
+                required: [
+                    'Model Context Protocol',
+                    'MCP Store',
+                    'Manage MCP Servers',
+                    'View raw config',
+                    'mcp_config.json',
+                ],
+            },
+            {
+                file: 'web/src/app/docs/command/page.tsx',
+                required: ['Command + I', 'Ctrl + I'],
+            },
+            {
+                file: 'web/src/app/docs/allowlist-denylist/page.tsx',
+                required: ['BadUrlsChecker', 'always allow', 'localhost'],
+            },
+            {
+                file: 'web/src/app/docs/browser-subagent/page.tsx',
+                required: ['DOM 捕获', '截图', '蓝色边框'],
+            },
+        ];
+
+        const missing = [];
+        for (const { file, required } of checks) {
+            const abs = path.resolve(file);
+            const content = fs.readFileSync(abs, 'utf8');
+            for (const token of required) {
+                if (!content.includes(token)) {
+                    missing.push(`${file} -> ${token}`);
+                }
+            }
+        }
+
+        assert.strictEqual(
+            missing.length,
+            0,
+            `localized docs missing official baseline tokens:\n${missing.join('\n')}`,
+        );
+    });
+});

package/tests/transformer.test.js

@@ -0,0 +1,74 @@
+const { test, describe, beforeEach, afterEach } = require("node:test");
+const assert = require("node:assert");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const ResourceTransformer = require("../bin/core/transformer");
+
+describe("ResourceTransformer", () => {
+    let tempDir;
+
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "ag-kit-transformer-test-"));
+    });
+
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+
+    function transformWorkflow(markdown) {
+        const workflowPath = path.join(tempDir, "workflow.md");
+        fs.writeFileSync(workflowPath, markdown, "utf8");
+
+        const result = ResourceTransformer.transform({
+            skills: [],
+            workflows: [{ name: "demo", path: workflowPath, type: "workflow" }],
+        });
+
+        return result.mappedFiles.find((item) => item.destPath.endsWith("/SKILL.md"));
+    }
+
+    test("workflow frontmatter should parse CRLF and keep colon in description", () => {
+        const mapped = transformWorkflow([
+            "---\r",
+            "description: \"Run /debug: inspect failures\"\r",
+            "---\r",
+            "",
+            "# Workflow body",
+        ].join("\n"));
+
+        assert.ok(mapped);
+        assert.ok(mapped.content.includes("description: \"Run /debug: inspect failures\""));
+        assert.ok(mapped.content.includes("# Workflow body"));
+    });
+
+    test("workflow frontmatter should parse folded multiline description", () => {
+        const mapped = transformWorkflow([
+            "---",
+            "description: >",
+            "  先执行 /plan",
+            "  再执行 /debug",
+            "---",
+            "",
+            "# Workflow body",
+        ].join("\n"));
+
+        assert.ok(mapped);
+        assert.ok(mapped.content.includes("description: \"先执行 /plan 再执行 /debug\""));
+    });
+
+    test("workflow frontmatter should parse indented multiline description", () => {
+        const mapped = transformWorkflow([
+            "---",
+            "description:",
+            "  统一排查流程: 先收集日志",
+            "  再定位根因",
+            "---",
+            "",
+            "# Workflow body",
+        ].join("\n"));
+
+        assert.ok(mapped);
+        assert.ok(mapped.content.includes("description: \"统一排查流程: 先收集日志 再定位根因\""));
+    });
+});

package/.agent/mcp_config.json

@@ -1,12 +0,0 @@
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
-    },
-    "shadcn": {
-      "command": "npx",
-      "args": ["shadcn@latest", "mcp"]
-    }
-  }
-}

package/docs/codex-rules-template.md

@@ -1,36 +0,0 @@
-# Codex `.rules` 模板（手动配置）
-
-> 用途：给 Codex 官方规则引擎提供命令审批策略。  
-> 注意：这不是 `antigravity.rules` 的替代品，二者职责不同。
-
-## 路径约定
-
-- 全局默认路径：`~/.codex/rules/default.rules`
-- 本项目不会自动写入该文件，请按需手动创建。
-
-## 最小模板（Starlark）
-
-```python
-# default.rules
-# 允许常见只读命令直接执行，其余命令走人工审批
-
-load("builtin://rules/rules.star", "prefix_rule")
-
-rules = [
-    prefix_rule(["ls"], action="allow"),
-    prefix_rule(["cat"], action="allow"),
-    prefix_rule(["rg"], action="allow"),
-    prefix_rule(["git", "status"], action="allow"),
-]
-```
-
-## 建议策略
-
-1. 先放行只读命令（`ls`/`cat`/`rg`/`git status`）。
-2. 对写操作、网络请求、脚本执行保持 `review` 或 `deny`。
-3. 团队场景下，将策略文件纳入内部安全评审流程。
-
-## 与 `antigravity.rules` 的关系
-
-- `antigravity.rules`：本仓库在工作区注入的托管说明内容，用于记录受管资源与运维约束。
-- `.rules`：Codex 官方可执行审批规则（Starlark），影响命令放行策略。

package/docs/mapping-spec.md

@@ -1,68 +0,0 @@
-# Codex（代码智能体环境）资源映射规范
-
-Codex（代码智能体环境）适配器包含一个内置的资源转换层（`bin/core/`），负责将通用的 Agent（智能体）能力描述、Skill（技能）与 Workflow（工作流）转换为 Codex 兼容的标准化格式。
-
-## 转换规则
-
-### 1. Skill（技能）
-
-- **源路径**: `.agent/skills/<name>/SKILL.md`
-- **Codex ID（标识）**: `<name>`（保持与上游技能名一致）
-- **目标路径**: `.agents/skills/<name>/SKILL.md`
-
-### 2. Workflow（工作流）
-
-- **源路径**: `.agent/workflows/<name>.md`
-- **Codex ID（标识）**: `workflow-<name>`
-- **目标路径**: `.agents/skills/workflow-<name>/SKILL.md`
-- **说明**: 工作流会转换为符合 Codex 规范的 `SKILL.md`（自动补齐 `name` / `description` Frontmatter（文档头元数据））。
-- **冲突处理**: 若生成 ID 与现有 Skill/Workflow 冲突，构建器会自动追加 `-2`、`-3`... 后缀，确保 ID 和目录唯一。
-
-## 托管文件生成
-
-### `codex.json` 元数据
-
-包含版本信息和所有资源的清单映射。
-
-### `AGENTS.md` 规则接入点
-
-自动生成的 Markdown 文件，列出所有 Capabilities（能力）并声明版本。
-安装/更新时，CLI（命令行界面）会把该内容注入工作区根目录 `AGENTS.md` 的托管区块中（不会覆盖用户自定义内容）。
-
-### `antigravity.rules` 风险控制
-
-自动生成风险控制规则，安装/更新时同样会注入工作区根目录 `antigravity.rules` 的托管区块。
-
-> 注意：这里的 `antigravity.rules` 是本项目的托管说明文件，不是 Codex 官方 `.rules` 审批策略文件。  
-> 如需配置 Codex 官方审批规则，请单独维护 `~/.codex/rules/default.rules`（参考 `docs/codex-rules-template.md`）。
-
-### `manifest.json` 托管清单
-
-用于完整性与漂移检测，核心结构如下：
-
-```json
-{
-  "version": 2,
-  "target": "codex",
-  "kitVersion": "2.0.1",
-  "files": {
-    "skills/example-skill/SKILL.md": {
-      "hash": "sha256...",
-      "source": "bundled/skills/example-skill/SKILL.md"
-    }
-  }
-}
-```
-
-覆盖策略：仅当当前文件 hash（哈希）同时满足 `当前文件 hash != manifest hash` 且 `当前文件 hash != 新版本 hash` 时，才会备份并覆盖。
-
-## 动态构建
-
-当使用 `ag-kit init --target codex` 安装旧版 Gemini 结构的仓库时，CLI 会自动触发 Just-in-Time Build（即时构建）流程：
-
-1. 克隆/读取源仓库。
-2. 识别为 Legacy（旧版）结构（`.agent/skills` 存在但无 `manifest.json`）。
-3. 在临时目录启动构建流水线。
-4. 将构建产物安装到项目的 `.agents` 目录（若检测到旧版 `.codex` 会自动迁移/清理）。
-
-此过程对用户透明。

package/docs/multi-target-adapter.md

@@ -1,80 +0,0 @@
-# 多目标适配器
-
-当前版本引入多目标适配器架构，支持在同一项目中共存并管理不同类型的 Agent（智能体）模板源。
-
-## 架构概览
-
-```mermaid
-graph TD
-    CLI[ag-kit CLI] --> Router[Target Router]
-    Router --> |target=gemini| Gemini[GeminiAdapter (.agent)]
-    Router --> |target=codex| Codex[CodexAdapter (.agents)]
-```
-
-## 支持的目标
-
-### 1. Gemini（旧版）
-
-- **标识**: `gemini`
-- **存储**: `.agent/`（直连模式）
-- **特点**: 轻量级，直接克隆自 Git 仓库或本地模板。
-- **适用**: 个人开发者、快速原型、不强制版本控制的场景。
-
-### 2. Codex（代码智能体环境）
-
-- **标识**: `codex`
-- **存储**:
-    - `.agents/`（托管上游，用户不可修改）
-    - `.agents-backup/`（发生覆盖冲突时自动备份）
-    - `AGENTS.md` / `antigravity.rules`（工作区托管区块注入）
-- **特点**:
-    - **Drift Detection（漂移检测）**: 自动识别用户对托管文件的修改。
-    - **Atomic Update（原子更新）**: 防止更新中断导致损坏。
-    - **资源映射**: 自动将标准 Skill（技能）/Workflow（工作流）转换为 Codex 规范。
-    - **遗留迁移**: 自动识别旧版 `.codex/` 并迁移到 `.agents/`。
-- **适用**: 团队协作、生产环境、需要严格版本管理和升级保障的场景。
-
-> 说明：`antigravity.rules` 是 Ag-Kit 注入的托管说明内容，不等同于 Codex 官方 `.rules`（命令审批执行规则）。
-
-## 命令行用法
-
-CLI（命令行界面）命令如下。
-
-### 安装/初始化
-
-```bash
-# 安装 Gemini
-ag-kit init --target gemini
-
-# 安装 Codex
-ag-kit init --target codex
-
-# 交互选择目标，TTY（终端）下无默认值
-ag-kit init
-
-# 临时目录验证（跳过全局索引登记）
-ag-kit init --target codex --no-index
-```
-
-### 更新
-
-```bash
-# 更新当前项目（自动检测已安装目标）
-ag-kit update
-
-# 强制更新指定目标
-ag-kit update --target codex
-
-# 更新但不刷新全局索引
-ag-kit update --target codex --no-index
-```
-
-### 诊断与修复
-
-```bash
-# 检查所有目标健康状态
-ag-kit doctor
-
-# 尝试自动修复
-ag-kit doctor --fix
-```