docs: 添加Dragonfly双仓库推送Skill实施计划

Author: 茉莉蜜猹

.codefuse/plans/Dragonfly双仓库推送Skill实施计划_20260311164417.md

@@ -0,0 +1,219 @@
+# Dragonfly双仓库推送Skill实施计划
+
+## 一、概述
+
+创建一个全局skill (`dragonfly-dual-push`)，实现智能的双仓库推送功能，支持代码变更分析、自动检查测试、提交信息生成和双仓库推送。
+
+## 二、Skill基本信息
+
+- **Skill名称**: dragonfly-dual-push
+- **存放位置**: `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/`
+- **触发方式**: 
+  - 关键词自动触发: "推送"、"推送代码"、"双仓库推送"、"push"、"提交并推送"
+  - 手动调用: 通过Skill工具直接调用
+
+## 三、目录结构
+
+```
+/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/
+├── SKILL.md                    # Skill定义文档（必需）
+├── package.json                # npm包配置（必需）
+├── index.js                    # 主入口文件（必需）
+├── README.md                   # 使用说明文档
+├── utils/                      # 工具模块目录
+│   ├── git.js                  # Git操作封装
+│   ├── analyzer.js             # 代码变更分析
+│   ├── checker.js             # 代码检查和测试
+│   └── pusher.js               # 双仓库推送逻辑
+└── .gitignore                  # Git忽略配置
+```
+
+## 四、核心功能实现
+
+### 4.1 代码变更分析 (utils/analyzer.js)
+- 使用`git diff`和`git status`获取改动文件列表
+- 分析变更类型：新增/修改/删除
+- 智能识别文件类型并建议提交类型：
+  - 源代码文件 → feat/fix/refactor
+  - 测试文件 → test
+  - 文档文件 → docs
+  - 配置文件 → chore
+- 生成变更摘要统计
+
+### 4.2 代码检查和测试 (utils/checker.js)
+- **Lint检查**: 执行`yarn lint`，解析输出结果
+- **测试执行**: 执行`yarn test`，收集测试结果
+- **Husky集成**: 可选择跳过或手动触发pre-commit钩子
+- **用户交互**: 检查失败时询问用户是否继续执行
+- **结果展示**: 清晰展示检查结果和建议
+
+### 4.3 提交信息生成 (在index.js中实现)
+- 基于代码变更分析生成建议的提交信息
+- 遵循Conventional Commits规范
+- 格式: `<type>: <subject>`
+- 提供中文和英文两个版本
+- 用户可以查看、编辑或完全自定义
+- 使用commitlint验证最终格式
+
+### 4.4 双仓库推送 (utils/pusher.js)
+- **目标仓库**:
+  - origin: https://github.com/dragonflyoss/console.git
+  - alipay: git@code.alipay.com:yjl516914/Dragonfly-console.git
+- **推送策略**: 智能选择（根据网络情况和推送结果）
+  - 默认串行推送（origin → alipay）
+  - 失败时暂停，提示用户选择重试或跳过
+  - 支持部分成功场景（一个成功、一个失败）
+- **分支处理**: 推送当前分支，自动创建远程分支
+- **状态验证**: 推送前验证仓库连接和认证状态
+
+## 五、执行流程
+
+```
+1. 前置检查
+   ├─ 验证Git仓库状态
+   ├─ 检查Node.js和yarn版本
+   └─ 验证远程仓库配置
+
+2. 代码变更分析
+   ├─ 获取改动文件列表
+   ├─ 分析变更类型和影响范围
+   └─ 生成变更摘要
+
+3. 代码检查和测试
+   ├─ 执行yarn lint
+   ├─ 执行yarn test
+   └─ 失败时询问用户是否继续
+
+4. 提交信息生成
+   ├─ 基于变更分析生成建议信息
+   ├─ 展示给用户确认/修改
+   └─ commitlint格式验证
+
+5. Git提交操作
+   ├─ 添加改动文件到暂存区
+   ├─ 执行git commit
+   └─ 验证提交结果
+
+6. 双仓库推送
+   ├─ 推送到origin (GitHub)
+   ├─ 推送到alipay (内部仓库)
+   ├─ 智能处理推送失败
+   └─ 汇总推送结果
+```
+
+## 六、关键技术点
+
+### 6.1 用户交互设计
+- 使用彩色输出（chalk）提升可读性
+- 使用进度动画（ora）展示执行进度
+- 交互式问答（inquirer）收集用户输入
+- 清晰的步骤指引和结果反馈
+
+### 6.2 错误处理机制
+- 前置检查失败：立即停止并给出具体提示
+- 检查失败：询问用户是否继续（强制模式）
+- Git操作失败：回滚已执行的操作
+- 推送失败：记录失败原因，提供重试选项
+- 详细的错误日志和修复建议
+
+### 6.3 配置灵活性
+- 支持项目级配置文件（可选）
+- 支持命令行参数覆盖默认配置
+- 提供合理的默认行为
+- 可配置检查项和推送策略
+
+## 七、SKILL.md Frontmatter配置
+
+```yaml
+---
+name: dragonfly-dual-push
+version: "1.0.0"
+description: Dragonfly项目双仓库推送助手 - 智能分析代码变更、执行检查测试、生成提交信息并推送到GitHub和内部代码仓库
+author: CodeFuse Team
+categories:
+  - Git
+  - CI/CD
+  - Development
+keywords:
+  - 推送
+  - 双仓库推送
+  - 推送代码
+  - push
+  - 提交并推送
+  - dual push
+  - git push
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+  - AskUserQuestion
+  - TodoWrite
+  - Grep
+  - Glob
+---
+```
+
+## 八、实施步骤
+
+### 阶段一：基础框架搭建
+1. 创建skill目录结构
+2. 编写SKILL.md文档（包含frontmatter和详细说明）
+3. 创建package.json配置（声明依赖和脚本）
+4. 实现index.js主入口框架
+
+### 阶段二：核心功能模块
+1. 实现utils/git.js（Git基础操作封装）
+2. 实现utils/analyzer.js（代码变更分析）
+3. 实现utils/checker.js（代码检查和测试）
+4. 实现utils/pusher.js（双仓库推送逻辑）
+
+### 阶段三：流程整合
+1. 整合各个功能模块到index.js
+2. 实现完整的执行流程
+3. 添加用户交互和进度反馈
+4. 实现错误处理和日志记录
+
+### 阶段四：测试和优化
+1. 在实际console项目中测试skill
+2. 验证所有功能模块正常工作
+3. 测试各种错误场景的处理
+4. 优化用户交互体验
+5. 完善README.md文档
+
+## 九、关键文件清单
+
+需要创建/修改的文件：
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/SKILL.md`
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/package.json`
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/index.js`
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/README.md`
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/utils/git.js`
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/utils/analyzer.js`
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/utils/checker.js`
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/utils/pusher.js`
+- `/Users/yangjiale/.codefuse/fuse/skills/dragonfly-dual-push/.gitignore`
+
+## 十、依赖说明
+
+**必需依赖**:
+- `simple-git`: Git操作封装
+- `chalk`: 终端输出美化
+- `ora`: 加载动画效果
+- `inquirer`: 交互式命令行界面
+- `commander`: 命令行参数解析
+
+**devDependencies**:
+- 无特殊要求，使用Node.js >=14即可
+
+## 十一、预期效果
+
+使用该skill后，用户可以通过以下方式轻松推送代码：
+
+1. **关键词触发**: 发送"推送代码"或"push"即可触发
+2. **自动化流程**: 自动分析、检查、生成提交信息、推送
+3. **用户确认**: 关键步骤提供用户确认和修改机会
+4. **双仓库支持**: 一次操作推送到GitHub和内部仓库
+5. **错误恢复**: 智能处理错误，提供恢复选项
+
+整个过程将大幅简化推送操作，同时保持代码质量和规范性。