{"_id":"@changjian-k2k/use-git","name":"@changjian-k2k/use-git","dist-tags":{"latest":"2.1.0"},"versions":{"2.1.0":{"name":"@changjian-k2k/use-git","version":"2.1.0","description":"Git workflow skills for OpenCode - Git Flow, commit management, and history operations","main":"index.js","bin":{"use-git":"bin/install.js","use-git-install":"bin/install.js"},"scripts":{"install":"node bin/install.js","postinstall":"node bin/install.js","uninstall":"node bin/uninstall.js"},"keywords":["opencode","git","gitflow","workflow","skills","ai","agent","commit","rebase","version-control"],"author":{"name":"changjian-k2k"},"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/changjian-k2k/use-git.git"},"bugs":{"url":"https://github.com/changjian-k2k/use-git/issues"},"homepage":"https://github.com/changjian-k2k/use-git#readme","engines":{"node":">=12.0.0"},"preferGlobal":true,"gitHead":"feeecaa464118213f9b3bb2c3b9de9e9b413f329","_id":"@changjian-k2k/use-git@2.1.0","_nodeVersion":"24.14.0","_npmVersion":"11.12.0","dist":{"integrity":"sha512-U6Tndhpb53VBvol2+YFRQRemnfvEA9Hw7BtYp9Rac9xx2kAi/XN7hEpB0xmWX5/XzCq58OTiva55NH++6ICxQQ==","shasum":"794ba55dbfafc6aaebcffacbe18c40b2cc9bccb4","tarball":"https://registry.npmjs.org/@changjian-k2k/use-git/-/use-git-2.1.0.tgz","fileCount":8,"unpackedSize":35080,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDSZ4P70MlYyoh+71nTzSGsMzs1fTz+xMknJRvf671OCQIhAL6yps/8INjZ06OJk1r6q3e7sKq4JYuKMlD1A2tZeqLH"}]},"_npmUser":{"name":"changjian-k2k","email":"changjian2007@gmail.com"},"directories":{},"maintainers":[{"name":"changjian-k2k","email":"changjian2007@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/use-git_2.1.0_1775289905715_0.5759509683718245"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-04T08:05:05.592Z","2.1.0":"2026-04-04T08:05:05.858Z","modified":"2026-04-04T08:05:06.098Z"},"maintainers":[{"name":"changjian-k2k","email":"changjian2007@gmail.com"}],"description":"Git workflow skills for OpenCode - Git Flow, commit management, and history operations","homepage":"https://github.com/changjian-k2k/use-git#readme","keywords":["opencode","git","gitflow","workflow","skills","ai","agent","commit","rebase","version-control"],"repository":{"type":"git","url":"git+https://github.com/changjian-k2k/use-git.git"},"author":{"name":"changjian-k2k"},"bugs":{"url":"https://github.com/changjian-k2k/use-git/issues"},"license":"MIT","readme":"# Use Git - OpenCode Git Workflow Skills\n\n[![npm version](https://img.shields.io/npm/v/@changjian-k2k/use-git.svg)](https://www.npmjs.com/package/@changjian-k2k/use-git)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n一组通用的 Git 工作流技能，适用于各种软件开发场景（软件、固件、文档等）。\n\n## 🚀 快速安装\n\n### 使用 npm（推荐）\n\n```bash\n# 全局安装\nnpm install -g @changjian-k2k/use-git\n\n# 或使用 npx（无需全局安装）\nnpx @changjian-k2k/use-git\n```\n\n### 手动安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/changjian-k2k/use-git.git\n\n# 进入目录并运行安装脚本\ncd use-git\nnpm install\n```\n\n## 📋 功能特性\n\n| 技能名称 | 描述 | 适用场景 |\n|---------|------|---------|\n| **git-workflow** | Git Flow 分支管理策略 | 团队协作、特性开发、版本控制 |\n| **git-master** | 高级 Git 操作专家 | 提交整理、变基操作、历史查询 |\n\n### git-workflow 特性\n\n- ✅ **特性分支管理** - 自动创建和管理 feature 分支\n- ✅ **代码提交前检查** - LSP 诊断、构建验证\n- ✅ **显式用户确认** - 不会自动合并，必须用户批准\n- ✅ **测试验证工作流** - 支持自动化和手动测试\n- ✅ **标准化合并流程** - Git Flow / GitHub Flow 支持\n\n### git-master 特性\n\n**提交模式 (Commit Mode)**\n- 🤖 智能提交拆分 - 多文件自动拆分为原子提交\n- 🎨 自动风格检测 - 语义化/普通/简短提交风格\n- 🧪 测试文件自动配对 - 实现与测试文件同步提交\n- 📝 智能提交信息生成\n\n**变基模式 (Rebase Mode)**\n- 🔀 交互式变基与提交压缩\n- ✨ 自动 squash/fixup 应用\n- 🔄 分支更新（rebase onto）\n- 🔧 冲突解决指导\n\n**历史搜索模式 (History Search Mode)**\n- 🔍 代码追溯（git log -S/-G）\n- 👤 行级归因（git blame）\n- 🐛 Bug 引入定位（git bisect）\n- 📁 文件历史追踪\n\n## 📖 使用方法\n\n安装后，在 OpenCode 中直接使用自然语言：\n\n### Git Flow 工作流\n\n```\n用户: 帮我完成这个功能的 Git 提交\n\nOpenCode: 我将为你创建特性分支并管理整个流程...\n```\n\n```\n用户: 特性开发完成了，准备合并\n\nOpenCode: 特性已准备就绪，等待你的确认...\n[显示验证状态并提供选项]\n```\n\n### Git 大师操作\n\n```\n用户: 整理一下提交历史\n\nOpenCode: 分析提交历史中...\n[自动检测风格并提供优化建议]\n```\n\n```\n用户: 查询这个改动是什么时候引入的\n\nOpenCode: 搜索代码历史中...\n[显示相关提交和作者信息]\n```\n\n## 📦 项目结构\n\n```\nuse-git/\n├── README.md                  # 本文件\n├── package.json              # npm 包配置\n├── LICENSE                   # MIT 许可证\n├── bin/\n│   ├── install.js           # 安装脚本\n│   └── uninstall.js         # 卸载脚本\n└── skills/\n    ├── git-workflow.skill   # Git Flow 工作流技能\n    └── git-master.skill     # Git 大师技能\n```\n\n## ⚙️ 安装详情\n\n### npm 安装后的自动配置\n\n当你运行 `npm install -g @changjian-k2k/use-git` 时：\n\n1. 📥 下载技能包\n2. 🔧 自动运行安装脚本\n3. 📂 复制 `.skill` 文件到 `~/.opencodeskills/`\n4. ✅ 显示安装摘要\n\n### 手动触发安装\n\n如果自动安装失败，可以手动运行：\n\n```bash\n# 使用 npx 运行安装\nnpx @changjian-k2k/use-git\n\n# 或运行特定脚本\nnpx use-git-install\n```\n\n### 验证安装\n\n```bash\n# 检查技能是否安装成功\nls ~/.opencodeskills/*.skill\n\n# 在 OpenCode 中验证\n/skill list\n```\n\n## 🔧 卸载\n\n```bash\n# 使用 npm 卸载\nnpm uninstall -g @changjian-k2k/use-git\n\n# 这将自动运行卸载脚本，移除技能文件\n```\n\n## 🌟 支持的 Git 工作流\n\n- **Git Flow** - `feature → develop → main`\n- **GitHub Flow** - `feature → main`\n- **Trunk-based Development** - 主干开发\n- **Forking Workflow** - Fork 工作流\n- **自定义工作流** - 任何 Git 工作流程\n\n## 📝 示例场景\n\n### 场景 1：特性开发（软件项目）\n\n```\n用户: 我要添加用户认证功能\n\nOpenCode:\n1. 创建 feature/user-auth 分支\n2. 实现代码更改\n3. 运行 LSP 诊断和测试\n4. 提交多个原子提交\n5. 请求合并确认\n```\n\n### 场景 2：固件开发\n\n```\n用户: 实现温度控制算法\n\nOpenCode:\n1. 创建 feature/temp-control 分支\n2. 编写算法实现\n3. 运行编译检查\n4. 请求硬件测试\n5. 合并到 develop\n```\n\n### 场景 3：文档项目\n\n```\n用户: 更新 API 文档\n\nOpenCode:\n1. 创建 feature/api-docs 分支\n2. 更新 Markdown 文件\n3. 检查格式和链接\n4. 提交并合并\n```\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n### 开发流程\n\n1. Fork 本仓库\n2. 创建特性分支 (`git checkout -b feature/amazing-feature`)\n3. 提交更改 (`git commit -m 'feat: add amazing feature'`)\n4. 推送到分支 (`git push origin feature/amazing-feature`)\n5. 创建 Pull Request\n\n### 本地测试\n\n```bash\n# 克隆仓库\ngit clone https://github.com/changjian-k2k/use-git.git\ncd use-git\n\n# 本地安装测试\nnpm link\n\n# 验证安装\nnpx @changjian-k2k/use-git\n\n# 取消链接\nnpm unlink\n```\n\n## 📄 许可证\n\nMIT License - 详见 [LICENSE](LICENSE) 文件\n\n## 👥 作者\n\n- **原作者**: RT2401 团队\n- **维护者**: changjian-k2k\n\n## 🔗 相关链接\n\n- [OpenCode](https://github.com/opencode-ai/opencode)\n- [Git Flow 工作流](https://nvie.com/posts/a-successful-git-branching-model/)\n- [GitHub Flow](https://docs.github.com/en/get-started/quickstart/github-flow)\n\n---\n\n**注意**: 这些技能需要配合 [OpenCode](https://github.com/opencode-ai/opencode) 使用。\n","readmeFilename":"README.md","_rev":"1-d34d8c88f0dd9c0bbeface9a550177a7"}