Claude Code + GitHub 自动化工作流整理

Claude Code + GitHub 自动化工作流整理

一、基础配置

1. 安装 GitHub CLI（gh）。
2. 执行 gh auth login，完成 GitHub 身份认证。
3. 在 CLAUDE.md 中定义 Git 规范：分支命名、提交格式、测试要求、PR 模板和禁止事项。
4. 在 .claude/settings.json 中配置命令权限，限制危险操作。
5. 将 .claude/worktrees/ 添加到 .gitignore。

二、分支与开发

6. 使用 claude --worktree feat-42-invite 创建独立工作区和分支。
7. 使用 Plan Mode 分析需求、制定实施计划。
8. 按计划实现功能，并通过 TDD 编写和运行测试。
9. 完成代码检查，确保测试和 lint 通过。

三、提交与 PR 自动化

10. 创建 /branch Skill，自动执行分支创建流程。
11. 创建 /implement Skill，封装 TDD 开发流程。
12. 创建 /pr Skill，自动执行状态检查、测试、同步 main、推送分支和创建 PR。
13. 统一 PR 正文格式：修改内容、修改原因、测试方法、关联 Issue。
14. 创建 PR 后输出链接，并确保关联 Issue（例如 Closes #42）。

四、GitHub 侧自动化

15. 执行 /install-github-app，配置 Claude Code GitHub Actions。
16. 在 PR 或 Issue 中使用 @claude，让 Claude 执行代码分析、功能实现或 Bug 修复。
17. 使用 claude --from-pr <编号> 恢复关联会话，处理 PR 审查意见。

五、安全与维护

18. 禁止直接向 main 推送及执行未经授权的强制推送。
19. 为 GitHub Actions 配置最小必要权限，保护 API 密钥和认证 Secret。
20. 监控 Actions 运行时间及 API Token 消耗。
21. 使用 claude --help 确认当前版本支持的命令行参数。

推荐顺序： 基础配置 → 分支与开发 → /pr 自动化 → GitHub Actions → 安全与维护。

先实现本地从需求开发到 PR 创建的闭环，再扩展到 GitHub 上的自动化。