@mison/ag-kit-cn 2.0.1 → 3.0.0-beta.0

package/.agent/agents/frontend-specialist.md

@@ -3,7 +3,7 @@ name: frontend-specialist
 description: 资深前端架构师，构建可维护的 React/Next.js 系统，强调性能优先。适用于 UI 组件、样式、状态管理、响应式设计或前端架构。触发关键词：component, react, vue, ui, ux, css, tailwind, responsive。
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-skills: clean-code, react-best-practices, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate
+skills: clean-code, nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate
 ---
 
 # 资深前端架构师
@@ -599,7 +599,7 @@ _你必须在写代码前向用户展示这个块。_
 
 ---
 
-> **注意（Note）：** 本 Agent 会加载相关技能（clean-code、react-best-practices 等）提供细节。请根据技能规则行事，不要复制模板。
+> **注意（Note）：** 本 Agent 会加载相关技能（clean-code、nextjs-react-expert 等）提供细节。请根据技能规则行事，不要复制模板。
 
 ---
 

package/.agent/agents/orchestrator.md

@@ -120,7 +120,6 @@ skills: clean-code, parallel-agents, behavioral-modes, plan-writing, brainstormi
 | `devops-engineer` | DevOps & Infra | 部署、CI/CD、PM2、监控 |
 | `database-architect` | Database & Schema | Prisma、迁移、性能优化 |
 | `mobile-developer` | Mobile Apps | React Native、Flutter、Expo |
-| `api-designer` | API Design | REST、GraphQL、OpenAPI |
 | `debugger` | Debugging | 根因分析、系统化排障 |
 | `explorer-agent` | Discovery | 代码库探索、依赖关系 |
 | `documentation-writer` | Documentation | **仅用户明确要求文档时** |
@@ -141,13 +140,12 @@ skills: clean-code, parallel-agents, behavioral-modes, plan-writing, brainstormi
 | Agent | CAN Do | CANNOT Do |
 | --- | --- | --- |
 | `frontend-specialist` | 组件、UI、样式、hooks | ❌ 测试文件、API 路由、数据库 |
-| `backend-specialist` | API、服务逻辑、DB 查询 | ❌ UI 组件、样式 |
+| `backend-specialist` | API、服务逻辑、DB 查询、OpenAPI/GraphQL schema | ❌ UI 组件、样式 |
 | `test-engineer` | 测试文件、mock、覆盖率 | ❌ 业务生产代码 |
 | `mobile-developer` | RN/Flutter 组件、移动 UX | ❌ Web 组件 |
 | `database-architect` | schema、迁移、查询 | ❌ UI、API 逻辑 |
 | `security-auditor` | 审计、漏洞、鉴权评估 | ❌ 新功能代码、UI |
 | `devops-engineer` | CI/CD、部署、基础设施配置 | ❌ 应用业务代码 |
-| `api-designer` | API 规范、OpenAPI、GraphQL schema | ❌ UI 代码 |
 | `performance-optimizer` | 性能分析、优化、缓存策略 | ❌ 新功能开发 |
 | `seo-specialist` | Meta、SEO 配置、分析埋点 | ❌ 业务逻辑 |
 | `documentation-writer` | 文档、README、注释 | ❌ 代码逻辑、**未授权自动调用** |

package/.agent/mcp_config.json

@@ -2,7 +2,17 @@
   "mcpServers": {
     "context7": {
       "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
+      "args": ["-y", "@upstash/context7-mcp"],
+      "env": {
+        "CONTEXT7_API_KEY": "YOUR_API_KEY"
+      }
+    },
+    "context7_backup": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@iflow-mcp/context7-mcp@1.0.0"
+      ]
     },
     "shadcn": {
       "command": "npx",

package/.agent/rules/GEMINI.md

@@ -242,8 +242,8 @@ trigger: always_on
 
 | 任务 | 读取 |
 | ------------ | ------------------------------- |
-| Web UI/UX | `.agent/frontend-specialist.md` |
-| Mobile UI/UX | `.agent/mobile-developer.md` |
+| Web UI/UX | `.agent/agents/frontend-specialist.md` |
+| Mobile UI/UX | `.agent/agents/mobile-developer.md` |
 
 **上述智能体文件包含：**
 

package/.agent/skills/api-patterns/SKILL.md

@@ -36,9 +36,9 @@ allowed-tools: Read, Write, Edit, Glob, Grep
 
 | Need（需求） | Skill（技能） |
 | ---- | ------------ |
-| API implementation（API 落地实现） | `@[skills/backend-development]` |
+| API implementation（API 落地实现） | `@[skills/nodejs-best-practices]` |
 | Data structure（数据库结构设计） | `@[skills/database-design]` |
-| Security details（安全加固细节） | `@[skills/security-hardening]` |
+| Security details（安全加固细节） | `@[skills/vulnerability-scanner]` |
 
 ---
 

package/.agent/skills/app-builder/project-detection.md

@@ -29,6 +29,6 @@
 1. Tokenize user request（对用户请求分词）
 2. 提取关键词
 3. 确定项目类型
-4. 检测缺失信息 → 转发给 conversation-manager（对话管理器）
+4. 检测缺失信息 → 转发给 brainstorming（结构化澄清）
 5. 建议技术栈
 ```

package/.agent/skills/nextjs-react-expert/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: react-best-practices
+name: nextjs-react-expert
 description: 来自 Vercel Engineering 的 React 与 Next.js 性能优化规则。适用于构建组件、优化性能、消除瀑布式请求（waterfalls）、缩减 bundle、性能代码审查与服务端/客户端优化实现。
 allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 ---
@@ -106,7 +106,7 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 | 数据库优化              | `@[skills/database-design]`       |
 | 测试策略                | `@[skills/testing-patterns]`      |
 | UI/UX 设计原则          | `@[skills/frontend-design]`       |
-| TypeScript 模式         | `@[skills/typescript-expert]`     |
+| TypeScript/Node 实践    | `@[skills/nodejs-best-practices]` |
 | 部署与 DevOps           | `@[skills/deployment-procedures]` |
 
 ---

package/.agent/skills/parallel-agents/SKILL.md

@@ -115,7 +115,6 @@ allowed-tools: Read, Glob, Grep
 | `devops-engineer` | 运维开发 | "部署", "CI/CD（持续集成/交付）", "基础设施" |
 | `database-architect` | 数据库架构 | "模式（Schema）", "Prisma", "迁移" |
 | `mobile-developer` | 移动端开发 | "React Native", "Flutter", "移动端" |
-| `api-designer` | API 设计 | "REST（表述性状态转移）", "GraphQL（图查询语言）", "OpenAPI（开放 API 规范）" |
 | `debugger` | 调试专家 | "Bug（缺陷）", "错误", "不工作" |
 | `explorer-agent` | 探索发现 | "探索", "映射", "结构" |
 | `documentation-writer` | 文档编写 | "写文档", "创建 README（说明文档）", "生成 API 文档" |

package/.agent/skills/refactoring-patterns/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: refactoring-patterns
+description: 遗留系统的安全重构模式。适用于代码异味治理、模块拆分、接口迁移与低风险迭代重构。
+allowed-tools: Read, Write, Edit, Grep, Glob
+---
+
+# 重构模式（Refactoring Patterns）
+
+## 目标
+
+在不破坏现有行为的前提下，逐步提升可读性、可测试性与可维护性。
+
+## 适用场景
+
+- 巨型函数、深层嵌套、重复逻辑。
+- 历史模块耦合严重，改一处影响多处。
+- 需要在持续交付中逐步替换旧实现，而非一次性重写。
+
+## 执行顺序（强制）
+
+1. 先锁定行为：补齐回归测试或特征测试（characterization tests）。
+2. 小步提交：每次只做一种重构动作（如提取函数、重命名、移动模块）。
+3. 每步验证：确保测试通过后再进入下一步。
+4. 接口稳定优先：对外 API 先兼容，内部再逐层替换。
+
+## 常用模式
+
+- 提取函数（Extract Function）：把多职责逻辑拆成具名步骤。
+- 引入门面（Facade）：先封装旧接口，再在门面后逐步替换实现。
+- 依赖倒置（Dependency Inversion）：把硬编码依赖替换为可注入接口。
+- 删除死代码（Dead Code Removal）：仅在有覆盖和调用链确认后执行。
+
+## 禁止事项
+
+- 无测试直接大规模重写。
+- 同一提交混入功能变更与重构变更。
+- 修改外部契约却不提供迁移路径或兼容层。
+
+## 完成标准
+
+- 行为保持一致（回归测试通过）。
+- 复杂度下降（函数长度、嵌套层级、重复率可观测改善）。
+- 变更说明清晰（记录重构动机、范围与风险点）。

package/.agent/workflows/create.md

@@ -16,7 +16,7 @@ $ARGUMENTS
 
 1. **需求分析**
    - 理解用户的具体需求
-   - 如果信息缺失，使用 `conversation-manager` 技能进行提问
+   - 如果信息缺失，使用 `brainstorming` 技能进行结构化提问
 
 2. **项目规划**
    - 使用 `project-planner` Agent（智能体）进行任务拆解

package/CHANGELOG.md

@@ -7,6 +7,25 @@
 
 ## [Unreleased]
 
+## [3.0.0-beta.0] - 2026-03-04
+
+### 新增
+
+- 统一 full 目录体系：`ag-kit init/update` 默认安装 `.agents`（Canonical），并自动生成 `.agent` / `.gemini` 兼容投影。
+- Context7 MCP 双通道：默认同步 `context7`（官方）与 `context7_backup`（备用）配置。
+- 冲突交互：检测到已有 `.agent` 或 `.gemini/agents` 时，支持交互式处理策略选择。
+
+### 变更
+
+- `--target gemini|codex` 保持兼容，但内部归一为 full 安装流程。
+- `doctor/status/update-all` 统一按 full 模式工作，索引目标收敛为 `full`。
+- `.codex` 迁移策略更新：仅清理可识别为本工具托管的 legacy 目录；非托管目录保留。
+
+### 修复
+
+- 修复升级场景对非托管 `.codex` 目录的误删除风险。
+- 修复 `.gemini/settings.json` 合并行为，保留用户非托管字段。
+
 
 ## [2.0.2] - 2026-02-04
 

package/README.md

@@ -1,6 +1,10 @@
 # Antigravity Kit CN
 
-> 包含 Skills（技能）、Agents（智能体）与 Workflows（工作流）的 AI Agent 模板
+[![npm version](https://img.shields.io/npm/v/%40mison%2Fag-kit-cn?logo=npm)](https://www.npmjs.com/package/@mison/ag-kit-cn)
+[![npm downloads](https://img.shields.io/npm/dm/%40mison%2Fag-kit-cn?logo=npm)](https://www.npmjs.com/package/@mison/ag-kit-cn)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+> 面向 Antigravity 与 Codex 的中文 AI Agent 模板工具包，提供 Skills、Agents、Workflows 与 ag-kit CLI 的一键安装、更新和治理。
 >
 > [!NOTE]
 > 本仓库基于上游 vudovn/antigravity-kit 同步更新并进行中文化，同时提供 Codex（代码智能体环境）适配。
@@ -15,16 +19,17 @@ npm install -g @mison/ag-kit-cn
 
 ```bash
 cd /path/to/your-project
-ag-kit init --target gemini   # 安装 Gemini 结构（.agent）
-ag-kit init --target codex    # 安装 Codex 结构（.agents + 托管规则注入）
-# 或者直接 ag-kit init，在交互中选择目标
+ag-kit init                   # 统一 full 安装（.agents 为主目录）
+# 兼容参数仍可用，但会归一为 full
+ag-kit init --target codex
+ag-kit init --target gemini
 ```
 
 可选：不做全局安装，直接在仓库目录执行：
 
 ```bash
 cd /path/to/antigravity-kit-cn
-node bin/ag-kit.js init --target codex --path /path/to/your-project
+node bin/ag-kit.js init --path /path/to/your-project
 ```
 
 如需源码开发安装：
@@ -35,7 +40,7 @@ cd antigravity-kit-cn
 npm install -g .
 ```
 
-这会把所选目标结构安装到你的项目中（`gemini -> .agent`，`codex -> .agents`），并把 Codex 托管内容注入工作区 `AGENTS.md` 与 `antigravity.rules`（说明性托管区块，不是 Codex 官方 `.rules` 审批策略文件）。
+安装会统一写入 `.agents`，并自动生成兼容投影（`.agent`、`.gemini`），同时把托管内容注入工作区 `AGENTS.md` 与 `antigravity.rules`（说明性托管区块，不是 Codex 官方 `.rules` 审批策略文件）。
 
 ### Codex 规则边界说明
 
@@ -46,10 +51,10 @@ npm install -g .
 
 ### ⚠️ 关于 `.gitignore` 的重要说明
 
-如果你正在使用 **Cursor** 或 **Windsurf** 等 AI 编辑器，将 `.agent/`、`.agents/` 添加到 `.gitignore` 可能会阻止 IDE 索引工作流，导致斜杠命令（如 `/plan`、`/debug`）无法出现在对话建议中。
+如果你正在使用 **Cursor** 或 **Windsurf** 等 AI 编辑器，将 `.agent/`、`.agents/`、`.gemini/` 添加到 `.gitignore` 可能会阻止 IDE 索引工作流，导致斜杠命令（如 `/plan`、`/debug`）无法出现在对话建议中。
 
 **推荐方案：**
-1. 确保 `.agent/`、`.agents/` **不要** 出现在项目的 `.gitignore` 中。
+1. 确保 `.agent/`、`.agents/`、`.gemini/` **不要** 出现在项目的 `.gitignore` 中。
 2. 作为替代方案，将其加入本地排除文件：`.git/info/exclude`。
 
 ## 包含内容
@@ -129,8 +134,8 @@ CLI（命令行界面）工具：
 
 | 命令 | 描述 |
 | --- | --- |
-| `ag-kit init` | 安装指定目标：gemini/codex |
-| `ag-kit update` | 更新当前项目已安装目标 |
+| `ag-kit init` | 安装统一 full 结构（`.agents` + 兼容投影） |
+| `ag-kit update` | 更新当前项目（自动收敛 legacy 目录） |
 | `ag-kit update-all` | 批量更新所有已登记工作区 |
 | `ag-kit doctor` | 诊断安装完整性（可 `--fix` 自愈） |
 | `ag-kit exclude` | 管理全局索引排除清单 |
@@ -139,17 +144,18 @@ CLI（命令行界面）工具：
 ### 常用选项
 
 ```bash
-ag-kit init --target gemini --path ./myapp        # 安装 Gemini 到指定目录
-ag-kit init --target codex --path ./myapp         # 安装 Codex 到指定目录
-ag-kit init --targets gemini,codex --path ./myapp # 一次安装多个目标
-ag-kit init --non-interactive --target codex      # 非交互模式必须显式指定目标
-ag-kit init --target codex --no-index --path ./tmp-workspace # 安装但不写入全局索引
+ag-kit init --path ./myapp                        # full 安装（.agents 主目录）
+ag-kit init --target codex --path ./myapp         # 兼容写法，仍归一为 full
+ag-kit init --target gemini --path ./myapp        # 兼容写法，仍归一为 full
+ag-kit init --non-interactive --path ./myapp      # 非交互默认 full
+ag-kit init --no-index --path ./tmp-workspace     # 安装但不写入全局索引
 ag-kit init --branch dev --force                  # 覆盖安装并指定分支
 ag-kit init --quiet --dry-run                     # 预览操作而不执行
-ag-kit update --target codex --path ./myapp       # 更新指定目标（默认会刷新索引）
-ag-kit update --target codex --no-index --path ./myapp # 更新但不刷新索引
-ag-kit doctor --target codex --fix --path ./myapp # 检查并自动修复
-ag-kit update-all --targets codex                 # 批量更新所有登记工作区里的 codex 目标
+ag-kit update --path ./myapp                      # 更新并收敛 legacy
+ag-kit update --target codex --path ./myapp       # 兼容写法，仍归一为 full
+ag-kit update --no-index --path ./myapp           # 更新但不刷新索引
+ag-kit doctor --fix --path ./myapp                # 检查并自动修复
+ag-kit update-all --targets full                  # 批量更新登记工作区
 ag-kit update-all --prune-missing                 # 清理索引中已失效的路径
 ag-kit exclude list                               # 查看排除清单
 ag-kit exclude add --path /path/to/dir            # 新增排除路径
@@ -206,14 +212,17 @@ macOS / Linux / WSL:
 
 ```bash
 cd /path/to/your-project
-rm -rf .agent .agents .agents-backup .codex
+rm -rf .agent .agents .agents-backup .gemini antigravity.rules
+# 若确认 .codex 是本工具托管 legacy（含 manifest.json 且 target=codex/full），可再删除：
+# rm -rf .codex
 ```
 
 Windows PowerShell:
 
 ```powershell
 Set-Location C:\path\to\your-project
-Remove-Item .agent,.agents,.agents-backup,.codex -Recurse -Force -ErrorAction SilentlyContinue
+Remove-Item .agent,.agents,.agents-backup,.gemini,antigravity.rules -Recurse -Force -ErrorAction SilentlyContinue
+# 若确认 .codex 为本工具托管 legacy，再手动删除 .codex
 ```
 
 Windows CMD:
@@ -223,7 +232,9 @@ cd /d C:\path\to\your-project
 rmdir /s /q .agent
 rmdir /s /q .agents
 rmdir /s /q .agents-backup
-rmdir /s /q .codex
+rmdir /s /q .gemini
+del /f /q antigravity.rules
+REM 若确认 .codex 为本工具托管 legacy，再手动删除 .codex
 ```
 
 ### 清理批量更新索引（可选）