@zat-design/sisyphus-react 4.0.17 → 4.0.19-beta.2

package/.agents/skills/sync-commits/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: sync-commits
+description: "Syncs commits between sisyphus v3 and v4 repositories via cherry-pick. Use when asked to sync, cherry-pick, or transfer commits between v3 (xk-sisyphus-web) and v4 (xk-sisyphus4-web)."
+argument-hint: "<commit-hash> <direction: 3to4 | 4to3>"
+---
+
+# Sync Commits Between Sisyphus v3 and v4
+
+同步西西弗组件库 v3 和 v4 版本之间的提交。
+
+## 仓库信息
+
+| 版本 | 仓库 | 分支 | 远程名 |
+|------|------|------|--------|
+| v3 | git@git.zhonganinfo.com:zaxk/xk-sisyphus-web.git | dev_3.0.0 | source |
+| v4 | git@git.zhonganinfo.com:zaxk/xk-sisyphus4-web.git | dev_4 | origin |
+
+## 使用方法
+
+调用此 skill 时传入参数：
+- `<commit-hash>`: 要同步的提交 hash
+- `<direction>`: 同步方向
+  - `3to4`: 从 v3 同步到 v4（默认）
+  - `4to3`: 从 v4 同步到 v3
+
+## 执行流程
+
+### 1. 确保远程仓库已配置
+
+```bash
+# 检查远程配置
+git remote -v
+
+# 如果缺少 source 远程，添加 v3 仓库
+git remote add source https://xk-wanchongyang:AAAbbb111@git.zhonganinfo.com/zaxk/xk-sisyphus-web.git
+```
+
+### 2. 同步提交 (3to4 方向)
+
+```bash
+# 1. Fetch v3 分支
+git fetch source dev_3.0.0
+
+# 2. 查看提交内容
+git show <commit-hash> --stat
+
+# 3. Cherry-pick
+git cherry-pick <commit-hash>
+```
+
+### 3. 同步提交 (4to3 方向)
+
+```bash
+# 1. 切换到 v3 仓库目录或使用 worktree
+# 2. Fetch v4 分支
+git fetch origin dev_4
+
+# 3. Cherry-pick
+git cherry-pick <commit-hash>
+```
+
+## 冲突处理
+
+### moment vs dayjs
+
+v3 使用 `moment`，v4 使用 `dayjs`（antd 6 标准）。
+
+解决冲突时：
+- **3to4**: 将 `moment` 替换为 `dayjs`
+- **4to3**: 将 `dayjs` 替换为 `moment`
+
+```typescript
+// v3 (moment)
+import moment from 'moment';
+const date = moment(value);
+
+// v4 (dayjs)  
+import dayjs from 'dayjs';
+const date = dayjs(value);
+```
+
+### antd API 差异
+
+| 功能 | v3 (antd 5) | v4 (antd 6) |
+|------|-------------|-------------|
+| 日期库 | moment | dayjs |
+| CSS | Less 引入 | CSS-in-JS |
+| 类型 | Moment | Dayjs |
+
+## 完成后
+
+1. 解决所有冲突
+2. 运行 `git add .`
+3. 运行 `git cherry-pick --continue`
+4. 验证测试通过：`yarn test`
+
+## 示例
+
+```
+# 从 v3 同步提交到 v4
+sync-commits 91c2d08fb5a5ad5e15bbdee252756f16e592b610 3to4
+
+# 从 v4 同步提交到 v3
+sync-commits abc123def456 4to3
+```