用途:自动暂存、校验并提交代码变更,可选推送远端并监控 CI。适用于提交代码、创建 commit、push 等场景。
主要能力与流程:
- 检测版本控制系统:先判断是否为 jj 仓库,否则使用 git。使用 jj 时必须带 -m 参数以避免编辑器阻塞。
- 分支安全检查:读取 ./CLAUDE.md 获取项目权限;若在受保护分支且无权限,则建议创建特性分支,并缓存决策以备后续运行。
- 运行校验:自动检测项目类型,依次执行 format → lint → typecheck,失败即停止。
- 撰写提交信息:采用 conventional commits 格式 type(scope): description。有效类型包括 feat、fix、refactor、docs、style、perf、test、build、ci、chore。根据 diff 选择类型:新功能→feat,修复→fix,不改行为的重构→refactor,CI/CD 配置→ci,构建系统与依赖→build,文档→docs。scope 可选但多模块仓库建议填写。主题控制在 50 字符以内,使用祈使语气,重点说明「为什么」而非「做了什么」。
- 提交:jj 工作流(首选)使用 jj status && jj diff --stat,再执行 jj describe -m "feat: message here";git 工作流(回退)使用 git add <specific-files> 与 git commit -F /tmp/commit-msg.txt,提交信息文件用 Write 工具写入以避免 shell 转义问题。pre-commit 钩子失败时重新暂存并重试一次。
- 推送(当传入 --push 或明确要求时):jj 使用 jj bookmark set <branch> -r @ 与 jj git push --bookmark <branch>;git 使用 git push -u origin HEAD。
- 监控 CI(推送后):若存在 .github/workflows/ 且钩子输出中 ci=github-actions,则先解析 SHA(jj log -r '@-' --no-graph -T 'commit_id' 或 git rev-parse HEAD),再运行 uv run ~/.claude/skills/monitoring-ci/ci-monitor.py --branch <branch-name> --sha "$SHA",在后台运行并告知用户。
错误处理:未知项目权限时询问用户;受保护分支违规时停止;用检测到的格式化/检查工具自动修复代码质量问题;git 下 pre-commit 钩子失败可重新暂存一次;jj 下出错可用 jj op restore 恢复。
安全规则:未经许可不得提交到受保护分支;提交信息操作使用临时文件;遇到合并冲突即停止;修改前检查分支保护。
限制:资料未提供适用平台、具体收费或价格信息;category 依据用途归入编程与开发。