@mison/ag-kit-cn 2.0.1

package/.agent/workflows/deploy.md

@@ -0,0 +1,176 @@
+---
+description: 面向生产发布的部署命令。包含预检与部署执行流程。
+---
+
+# /deploy - 生产部署
+
+$ARGUMENTS
+
+---
+
+## 目的
+
+此命令用于处理生产环境部署，包含预检、部署执行及最终验证。
+
+---
+
+## 子命令
+
+```
+/deploy            - 交互式部署向导
+/deploy check      - 仅运行部署前检查
+/deploy preview    - 部署到预览/测试环境
+/deploy production - 部署到生产环境
+/deploy rollback   - 回滚到上一个版本
+```
+
+---
+
+## 部署前检查清单
+
+在任何部署开始之前：
+
+```markdown
+## 🚀 Pre-Deploy Checklist
+
+### 代码质量
+- [ ] 无 TypeScript 错误 (`npx tsc --noEmit`)
+- [ ] ESLint 检查通过 (`npx eslint .`)
+- [ ] 所有测试用例通过 (`npm test`)
+
+### 安全性
+- [ ] 无硬编码的机密信息
+- [ ] 环境变量已文档化
+- [ ] 依赖项已完成安全审计 (`npm audit`)
+
+### 性能
+- [ ] Bundle size（包体积）在可接受范围内
+- [ ] 移除所有 console.log 语句
+- [ ] 图片资源已优化
+
+### 文档
+- [ ] README 已更新
+- [ ] CHANGELOG 已更新
+- [ ] API 文档为最新状态
+
+### 是否部署？（y/n）
+```
+
+---
+
+## 部署流程
+
+```
+┌─────────────────┐
+│  开始部署        │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  预检            │
+│  (Pre-flight)   │
+└────────┬────────┘
+         │
+    通过？ ──否──► 修复问题
+         │
+        是
+         │
+         ▼
+┌─────────────────┐
+│  构建            │
+│  应用            │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  部署到          │
+│  平台            │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  健康检查        │
+│  与验证          │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  ✅ 完成         │
+└─────────────────┘
+```
+
+---
+
+## 输出格式
+
+### 部署成功
+
+```markdown
+## 🚀 Deployment Complete
+
+### 摘要
+- **版本：** v1.2.3
+- **环境：** production
+- **耗时：** 47 秒
+- **平台：** Vercel
+
+### 访问入口
+- 🌐 生产线上地址：https://app.example.com
+- 📊 控制中心：https://vercel.com/project
+
+### 变更内容
+- 新增用户个人资料功能
+- 修复登录问题
+- 更新依赖项
+
+### 健康检查
+✅ API 响应正常（200 OK）
+✅ 数据库已连接
+✅ 所有服务状态健康
+```
+
+### 部署失败
+
+```markdown
+## ❌ Deployment Failed
+
+### 错误摘要
+构建过程在以下步骤失败：TypeScript 编译
+
+### 错误详情
+```
+error TS2345: Argument of type 'string' is not assignable...
+```
+
+### 解决方案
+1. 修复 `src/services/user.ts:45` 中的 TypeScript 错误
+2. 在本地运行 `npm run build` 进行验证
+3. 再次尝试 `/deploy`
+
+### 可用回滚
+上一个版本（v1.2.2）仍处于活动状态。
+如有需要，请运行 `/deploy rollback`。
+```
+
+---
+
+## 平台支持
+
+| 平台 | 构建/部署命令 | 备注 |
+| --- | --- | --- |
+| Vercel | `vercel --prod` | Next.js 项目自动检测 |
+| Railway | `railway up` | 需要安装 Railway CLI |
+| Fly.io | `fly deploy` | 需要安装 flyctl |
+| Docker | `docker compose up -d` | 适用于自托管部署 |
+
+---
+
+## 示例
+
+```
+/deploy
+/deploy check
+/deploy preview
+/deploy production
+/deploy rollback
+```

package/.agent/workflows/enhance.md

@@ -0,0 +1,63 @@
+---
+description: 在现有应用中新增或更新功能，用于迭代开发。
+---
+
+# /enhance - 更新应用
+
+$ARGUMENTS
+
+---
+
+## 任务
+
+此命令用于在现有应用中新增功能或进行迭代更新。
+
+### 步骤：
+
+1. **了解当前状态**
+   - 使用 `python .agent/scripts/session_manager.py info` 加载项目状态
+   - 理解现有功能与技术栈
+
+2. **规划变更**
+   - 确定需要新增/变更的内容
+   - 检测受影响的文件
+   - 检查依赖关系
+
+3. **向用户展示计划**（针对重大变更）
+   ```
+   "为了添加管理后台：
+   - 我将创建 15 个新文件
+   - 更新 8 个文件
+   - 预计耗时约 10 分钟
+
+   我可以开始了吗？"
+   ```
+
+4. **执行变更**
+   - 调用相关 Agent（智能体）
+   - 执行代码变更
+   - 进行测试
+
+5. **更新预览**
+   - Hot reload（热重载）或重启预览服务
+
+---
+
+## 使用示例
+
+```
+/enhance 添加深色模式
+/enhance 构建管理后台
+/enhance 集成支付系统
+/enhance 添加搜索功能
+/enhance 编辑个人资料页面
+/enhance 进行响应式适配
+```
+
+---
+
+## 注意事项
+
+- 对于重大变更，**必须**获得审批
+- 对冲突的需求进行预警（例如：在项目使用 PostgreSQL 时要求“使用 Firebase”）
+- 每一项变更都应使用 Git 进行提交

package/.agent/workflows/orchestrate.md

@@ -0,0 +1,242 @@
+---
+description: 协调多 Agent 处理复杂任务。适用于多视角分析、综合评审或需要跨领域协作的任务。
+---
+
+# 多 Agent（智能体）编排
+
+你现在处于 **ORCHESTRATION MODE（编排模式）**。你的任务：协调专业 Agent（智能体）解决这个复杂问题。
+
+## 待编排任务
+$ARGUMENTS
+
+---
+
+## 🔴 关键：最少 Agent 数量要求
+
+> ⚠️ **ORCHESTRATION（编排）= 至少 3 个不同 Agent（智能体）**
+>
+> 如果使用少于 3 个 Agent，你就不是在编排，而是在委派。
+>
+> **完成前校验：**
+> - 统计已调用 Agent 数
+> - 若 `agent_count < 3` → 停止并继续调用 Agent
+> - 单 Agent = 编排失败
+
+### Agent 选择矩阵
+
+| 任务类型 | 必需 Agent（最少） |
+| --- | --- |
+| **Web App（Web 应用）** | frontend-specialist, backend-specialist, test-engineer |
+| **API** | backend-specialist, security-auditor, test-engineer |
+| **UI/Design（界面/设计）** | frontend-specialist, seo-specialist, performance-optimizer |
+| **Database（数据库）** | database-architect, backend-specialist, security-auditor |
+| **Full Stack（全栈）** | project-planner, frontend-specialist, backend-specialist, devops-engineer |
+| **Debug（调试）** | debugger, explorer-agent, test-engineer |
+| **Security（安全）** | security-auditor, penetration-tester, devops-engineer |
+
+---
+
+## 起飞前：模式确认
+
+| 当前模式 | 任务类型 | 动作 |
+| --- | --- | --- |
+| **plan** | 任意 | ✅ 继续遵循“先规划”流程 |
+| **edit** | 简单执行 | ✅ 直接执行 |
+| **edit** | 复杂/多文件 | ⚠️ 询问：“该任务需要先规划，是否切换到 plan mode（计划模式）？” |
+| **ask** | 任意 | ⚠️ 询问：“已准备编排，是否切换到 edit 或 plan mode（计划模式）？” |
+
+---
+
+## 🔴 严格两阶段编排
+
+### PHASE 1：PLANNING（规划）（串行，禁止并行 Agent）
+
+| 步骤 | Agent | 动作 |
+| --- | --- | --- |
+| 1 | `project-planner` | 创建 docs/PLAN.md |
+| 2 | （可选）`explorer-agent` | 如有需要先做代码库探查 |
+
+> 🔴 **规划阶段禁止其他 Agent！** 仅允许 project-planner 与 explorer-agent。
+
+### ⏸️ 检查点：用户批准
+
+```
+PLAN.md 完成后，必须询问：
+
+"✅ 已生成计划：docs/PLAN.md
+
+是否批准？(Y/N)
+- Y: 开始实现
+- N: 我会先修订计划"
+```
+
+> 🔴 **未获得用户明确批准，不得进入 Phase 2（第二阶段）。**
+
+### PHASE 2：IMPLEMENTATION（实现）（批准后可并行）
+
+| 并行分组 | Agents |
+| --- | --- |
+| Foundation（基础） | `database-architect`, `security-auditor` |
+| Core（核心） | `backend-specialist`, `frontend-specialist` |
+| Polish（收尾） | `test-engineer`, `devops-engineer` |
+
+> ✅ 用户批准后，可并行调用多个 Agent。
+
+## 可用 Agent（共 17 个）
+
+| Agent | 领域 | 使用场景 |
+| --- | --- | --- |
+| `project-planner` | 规划 | 任务拆解、生成 PLAN.md |
+| `explorer-agent` | 发现 | 代码库映射与发现 |
+| `frontend-specialist` | UI/UX | React、Vue、CSS、HTML |
+| `backend-specialist` | 后端 | API、Node.js、Python |
+| `database-architect` | 数据 | SQL、NoSQL、Schema |
+| `security-auditor` | 安全 | 漏洞、鉴权 |
+| `penetration-tester` | 安全 | 主动测试 |
+| `test-engineer` | 测试 | Unit、E2E、Coverage |
+| `devops-engineer` | 运维 | CI/CD、Docker、Deploy |
+| `mobile-developer` | 移动端 | React Native、Flutter |
+| `performance-optimizer` | 性能 | Lighthouse、Profiling |
+| `seo-specialist` | SEO | Meta、Schema、Rankings |
+| `documentation-writer` | 文档 | README、API 文档 |
+| `debugger` | 调试 | 错误分析 |
+| `game-developer` | 游戏 | Unity、Godot |
+| `orchestrator` | 协调 | 跨 Agent 协调 |
+
+---
+
+## 编排协议
+
+### Step 1：分析任务领域
+
+识别该任务涉及的全部领域：
+
+```
+□ Security（安全）     → security-auditor, penetration-tester
+□ Backend/API（后端/API）  → backend-specialist
+□ Frontend/UI（前端/UI）  → frontend-specialist
+□ Database（数据库）     → database-architect
+□ Testing（测试）        → test-engineer
+□ DevOps（运维）         → devops-engineer
+□ Mobile（移动端）       → mobile-developer
+□ Performance（性能）    → performance-optimizer
+□ SEO                   → seo-specialist
+□ Planning（规划）       → project-planner
+```
+
+### Step 2：识别阶段
+
+| 计划是否存在 | 动作 |
+| --- | --- |
+| 否 `docs/PLAN.md` | → 进入 PHASE 1（仅规划） |
+| 是 `docs/PLAN.md` + 已获用户批准 | → 进入 PHASE 2（实现） |
+
+### Step 3：按阶段执行
+
+**PHASE 1（规划）：**
+```
+使用 project-planner Agent 创建 PLAN.md
+→ 计划完成后立即停止
+→ 请求用户批准
+```
+
+**PHASE 2（实现，批准后）：**
+```
+并行调用 Agent：
+使用 frontend-specialist Agent 处理 [task]
+使用 backend-specialist Agent 处理 [task]
+使用 test-engineer Agent 处理 [task]
+```
+
+**🔴 关键：上下文传递（强制）**
+
+调用任何子 Agent 时，必须携带：
+
+1. **Original User Request（用户原始需求）：** 用户需求全文
+2. **Decisions Made（已确定决策）：** 用户对苏格拉底式问题的所有回答
+3. **Previous Agent Work（前序 Agent 工作）：** 之前 Agent 的工作摘要
+4. **Current Plan State（当前计划状态）：** 若工作区存在计划文件，必须附带
+
+**完整上下文示例：**
+
+```
+使用 project-planner Agent 创建 PLAN.md：
+
+**上下文：**
+- 用户需求："面向学生的社交平台，使用 mock 数据"
+- 已确定决策：Tech=Vue 3, Layout=Grid Widgets（网格组件）, Auth=Mock（模拟）, Design=青春且动感
+- 前序工作：Orchestrator 提了 6 个问题，用户选择了所有选项
+- 当前计划：playful-roaming-dream.md 已存在于工作区并包含初始结构
+
+**任务：** 基于以上决策生成详细 PLAN.md。不要根据文件夹名称推断。
+```
+
+> ⚠️ **违规：** 调用子 Agent 不带完整上下文，将导致错误假设。
+
+### Step 4：验证（强制）
+
+最后一个 Agent 必须执行合适的验证脚本：
+
+```bash
+python .agent/skills/vulnerability-scanner/scripts/security_scan.py .
+python .agent/skills/lint-and-validate/scripts/lint_runner.py .
+```
+
+### Step 5：结果综合
+
+将所有 Agent 输出汇总为统一报告。
+
+---
+
+## 输出格式
+
+```markdown
+## 🎼 Orchestration Report（编排报告）
+
+### 任务
+[原始任务摘要]
+
+### 模式
+[当前 Antigravity Agent 模式：plan/edit/ask]
+
+### 已调用 Agent（最少 3 个）
+| # | Agent | 关注领域 | 状态 |
+|---|-------|----------|------|
+| 1 | project-planner | 任务拆解 | ✅ |
+| 2 | frontend-specialist | UI 实现 | ✅ |
+| 3 | test-engineer | 验证脚本 | ✅ |
+
+### 已执行的验证脚本
+- [x] security_scan.py → 通过/失败
+- [x] lint_runner.py → 通过/失败
+
+### 关键发现
+1. **[Agent 1]**: 发现
+2. **[Agent 2]**: 发现
+3. **[Agent 3]**: 发现
+
+### 交付物
+- [ ] 已创建 PLAN.md
+- [ ] 已实现代码
+- [ ] 测试通过
+- [ ] 脚本已验证
+
+### 总结
+[对所有 Agent 工作的单段综合摘要]
+```
+
+---
+
+## 🔴 退出门槛
+
+在完成编排之前，确认：
+
+1. ✅ **Agent 数量：** `invoked_agents >= 3`
+2. ✅ **脚本已执行：** 至少运行 `security_scan.py`
+3. ✅ **报告已生成：** Orchestration Report（编排报告）中列出全部 Agent
+
+> **如果任一检查失败 → 不得标记编排完成。继续调用 Agent 或运行脚本。**
+
+---
+
+**立即开始编排。选择 3 个以上 Agent，顺序执行，运行验证脚本，并综合结果。**

package/.agent/workflows/plan.md

@@ -0,0 +1,89 @@
+---
+description: 使用 project-planner Agent 创建项目计划。不写代码，仅生成计划文件。
+---
+
+# /plan - 项目规划模式
+
+$ARGUMENTS
+
+---
+
+## 🔴 关键规则
+
+1. **绝对禁止编写代码** —— 此命令仅用于创建计划文件
+2. **使用 project-planner Agent** —— 不使用 Antigravity Agent 的原生 Plan 模式
+3. **Socratic Gate（苏格拉底之门）** —— 在规划前必须先通过提问澄清需求
+4. **Dynamic Naming（动态命名）** —— 计划文件根据任务自动命名
+
+---
+
+## 任务
+
+请在以下上下文中调用 `project-planner` Agent：
+
+```
+CONTEXT（上下文）：
+- 用户需求：$ARGUMENTS
+- 模式：仅限规划（不写代码）
+- 输出：docs/PLAN-{task-slug}.md（动态命名）
+
+NAMING RULES（命名规则）：
+1. 从请求中提取 2-3 个关键词
+2. 全小写，使用连字符（-）分隔
+3. 长度上限 30 个字符
+4. 示例：“e-commerce cart” → PLAN-ecommerce-cart.md
+
+RULES（执行准则）：
+1. 遵循 project-planner.md 的 Phase -1（Context Check）
+2. 遵循 project-planner.md 的 Phase 0（Socratic Gate）
+3. 创建包含任务拆解的 PLAN-{slug}.md 文件
+4. 绝对严禁编写任何业务代码文件
+5. 汇报所创建的准确文件名
+```
+
+---
+
+## 预期产出
+
+| 交付物 | 存储位置 |
+| --- | --- |
+| 项目计划书 | `docs/PLAN-{task-slug}.md` |
+| 任务拆解 | 计划文件内部 |
+| Agent 分配方案 | 计划文件内部 |
+| 验证检查清单 | 计划文件内部的 Phase X 章节 |
+
+---
+
+## 规划完成后
+
+告知用户：
+```
+[OK] 计划已创建：docs/PLAN-{slug}.md
+
+后续步骤：
+- 请审阅该计划
+- 运行 `/create` 命令开始落地实施
+- 或者手动对该计划进行微调
+```
+
+---
+
+## 命名示例
+
+| 用户请求 | 生成的计划文件 |
+| --- | --- |
+| `/plan 带购物车的电商网站` | `docs/PLAN-ecommerce-cart.md` |
+| `/plan 健身类移动端应用` | `docs/PLAN-fitness-app.md` |
+| `/plan 添加深色模式功能` | `docs/PLAN-dark-mode.md` |
+| `/plan 修复身份验证问题` | `docs/PLAN-auth-fix.md` |
+| `/plan SaaS 仪表盘` | `docs/PLAN-saas-dashboard.md` |
+
+---
+
+## 使用场景
+
+```
+/plan 带购物车的电商网站
+/plan 带健身追踪功能的移动端应用
+/plan 带数据分析功能的 SaaS 仪表盘
+```

package/.agent/workflows/preview.md

@@ -0,0 +1,80 @@
+---
+description: 预览服务器启动、停止与状态检查。本地开发服务管理。
+---
+
+# /preview - 预览管理
+
+$ARGUMENTS
+
+---
+
+## 任务
+
+管理预览服务器：启动、停止、状态检查。
+
+### 指令
+
+```
+/preview           - 显示当前状态
+/preview start     - 启动服务器
+/preview stop      - 停止服务器
+/preview restart   - 重启服务器
+/preview check     - 健康检查
+```
+
+---
+
+## 使用示例
+
+### 启动服务器
+```
+/preview start
+
+响应：
+🚀 正在启动预览……
+   端口：3000
+   类型：Next.js
+
+✅ 预览已就绪！
+   URL：http://localhost:3000
+```
+
+### 状态检查
+```
+/preview
+
+响应：
+=== 预览状态 ===
+
+🌐 URL：http://localhost:3000
+📁 项目：C:/projects/my-app
+🏷️ 类型：nextjs
+💚 健康状态：OK
+```
+
+### 端口冲突
+```
+/preview start
+
+响应：
+⚠️ 端口 3000 已被占用。
+
+可选项：
+1. 在端口 3001 启动
+2. 关闭占用 3000 端口的应用
+3. 指定一个不同的端口
+
+您想执行哪项操作？（默认：1）
+```
+
+---
+
+## 技术细节
+
+自动预览使用的是 `auto_preview.py` 脚本：
+
+```bash
+python .agent/scripts/auto_preview.py start [port]
+python .agent/scripts/auto_preview.py stop
+python .agent/scripts/auto_preview.py status
+```