automated-development-workflow

自动化开发工作流

Overview

自动化日常开发中的 Git 操作，包括代码检查、提交、推送和合并。这是 using-git-worktrees 的替代方案，适 用于单一分支顺序开发的场景。

核心原则： 检查代码 → 生成提交 → 执行推送 → 选择下一步

开始时声明： "我正在使用自动化开发工作流技能..." (I'm using the automated-development-workflow skill...)

适用场景： 个人开发者模式（development_mode: personal）下的普通分支工作流

★ Insight ───────────────────────────────────── 这个技能的核心设计理念：

1. 与 using-git-worktrees 的关系：两者互补 - worktree 用于并行多分支开发，此技能用于单分支快速迭代
2. 配置感知：通过检测 session context 中的 <config-detected> 标记来获取当前配置（如 completion_strategy、develop_branch 等）
3. 智能冲突解决：根据文件类型自动应用不同的合并策略（package.json 合并、代码文件基础设施优先等） ─────────────────────────────────────────────────

The Process

步骤 1：显示当前状态

首先收集并显示当前仓库状态：

# 获取当前分支
git branch --show-current

# 获取未提交更改
git status --short

# 获取最近提交历史（最近 3 条）
git log --oneline -3

输出格式：

📊 当前工作区状态

分支：feat/user-auth
未提交更改：3 个文件
  M  src/auth.ts (修改)
  ?? src/utils/token.ts (新增)
  M  README.md (修改)

最近提交：
  c48ef3b fix: 批量修复拼写错误
  393a3be fix: 修复命名和配置文件相关的遗漏问题
  ddf5fe5 chore: 配置文件命名从 superpowers 改为 horspowers

按回车继续...

如果没有未提交更改：

当前工作区是干净的（无未提交更改）

选项：
1. 执行分支操作（同步、合并、创建分支等）
2. 结束工作流

请选择：

步骤 2：执行代码质量检查（可选）

读取配置检查是否启用：

从 session context 中查找 <config-detected> 标记，获取配置：

• checks.typeCheck.enabled - 类型检查是否启用
• checks.typeCheck.command - 类型检查命令（默认：npm run type-check）
• checks.lint.enabled - Lint 检查是否启用
• checks.lint.command - Lint 检查命令（默认：npm run lint）
• checks.test.enabled - 测试是否启用

如果未找到配置或检查未启用，跳过此步骤，直接进入步骤 3。

如果检查启用，执行：

🔍 步骤 2：代码质量检查

正在运行类型检查...
<type-check-command 输出>

正在运行 Lint 检查...
<lint-command 输出>

✓ 所有检查通过

按回车继续...

如果检查失败：

❌ 类型检查失败（3 个错误）

src/auth.ts:10:5
  error TS2322: Type 'unknown' is not assignable to type 'string'

💡 建议操作：
1. 查看完整错误详情
2. 尝试继续提交（不推荐）
3. 取消工作流

请选择（输入数字）：

步骤 3：分析更改并生成 Commit Message

分析更改内容：

# 获取文件列表和 diff
git diff --cached --name-status 2>/dev/null || git diff --name-status
git diff --cached 2>/dev/null || git diff

确定提交类型：

基于以下规则自动判断：

更改内容	类型	说明
新增导出/函数/类	feat	新功能
包含 "fix" 或 "bug"	fix	Bug 修复
修改 .md 文件	docs	文档更新
包含 "refactor" 或 "优化"	refactor	重构
测试文件修改	test	测试相关
性能改进	perf	性能优化
代码格式调整	style	代码风格
其他	chore	杂项

确定范围（scope）：

根据文件路径自动推断：

• types/ → types
• config/ → config
• logger/ 或 log → logger
• test/ 或 spec → test
• auth/ 或 login → auth

生成主题：

从 diff 中提取关键变更，生成简洁的主题行。

输出格式：

📝 步骤 3：分析更改并生成 Commit Message

分析更改内容...
  - 新增 token 管理工具
  - 修改认证逻辑
  - 更新文档

自动生成的 commit message：

feat(auth): 添加 JWT token 管理

- 新增 TokenManager 类
- 实现用户登录功能
- 更新 README 文档

────────────────────────────────────────────

选项：
1. 使用此 commit message
2. 编辑 commit message
3. 重新生成
4. 查看详细 diff

请选择：

步骤 4：用户确认并提交

如果用户选择使用：

# 添加所有更改
git add -A

# 执行提交（使用 HEREDOC 确保格式正确）
git commit -m "$(cat <<'EOF'
feat(auth): 添加 JWT token 管理

- 新增 TokenManager 类
- 实现用户登录功能
- 更新 README 文档

Co-Authored-By: Claude <[email protected]>
EOF
)"

# 推送到远程
git push

输出：

✅ 提交成功

分支：feat/user-auth
提交：feat(auth): 添加 JWT token 管理
远程：已推送到 origin

按回车继续...

如果用户选择编辑：

• 允许用户输入自定义的 commit message
• 确认后执行提交和推送

步骤 5：询问下一步操作

读取配置确定推荐选项：

从 session context 中获取：

• completion_strategy - merge | pr | keep
• autoMerge.enabled - 是否自动合并
• autoMerge.targetBranch - 目标分支（默认：develop）
• develop_branch - 开发分支名称（始终为 develop）

显示选项：

✨ 代码已提交！接下来做什么？

根据当前配置，推荐：<<基于配置>>

1. 🔄 合并到 <<develop_branch>> （推荐）
2. 🔗 创建 Pull Request
3. 🌿 保留当前分支
4. 🏁 结束工作流
5. ➕ 其他操作（同步分支、解决冲突等）

请选择：

配置与推荐选项映射：

completion_strategy	个人模式推荐
merge	选项 1（合并） ✨
keep	选项 3（保留） ✨
pr	选项 2（创建 PR） ✨
未设置	选项 1（合并） ✨

子流程：合并到 Develop/Main

触发条件：

• 用户在步骤 5 选择选项 1
• 用户说"合并到 develop"、"合并代码"等

步骤 1：检查当前分支状态

# 确保当前分支已推送
git status

# 检查是否有未推送的提交
git log origin/$(git branch --show-current)..HEAD

步骤 2：切换到目标分支

安全原则： 所有功能分支合并到 develop，而不是直接合并到 main。

# 切换到 develop 分支（安全目标）
git checkout develop

# 拉取最新代码
git pull

步骤 3：合并功能分支

# 获取原分支名
FEATURE_BRANCH=$(git rev-parse --abbrev-ref HEAD@{1})

# 执行合并
git merge $FEATURE_BRANCH

步骤 4：处理冲突（如果有）

检测冲突：

# 检查是否有冲突
git diff --name-only --diff-filter=U

如果有冲突，按文件类型智能解决：

⚠️  检测到冲突！

冲突文件（2）：
1. package.json
2. src/utils/logger.ts

🔍 智能冲突解决策略：
✓ package.json - 已自动合并（合并双方 scripts）
✓ logger.ts - 已采用当前分支版本

是否继续合并？(y/n/手动解决)

冲突解决规则：

文件类型	策略	说明
package.json	merge	合并双方的 scripts 和依赖
TypeScript/JavaScript	infra-priority	保留基础设施版本（当前分支）
*.md	ours	保留当前分支（文档通常来自功能分支）
test/*	theirs	保留传入版本（测试应跟随主分支）
其他	询问用户	让用户决定

package.json 合并脚本（使用 git merge-file）：

# 检测到 package.json 冲突时
git show --theirs:package.json > /tmp/theirs.json
git show --ours:package.json > /tmp/ours.json
git show --ancestor:package.json >tmp/ancestor.json

git merge-file /tmp/ours.json /tmp/ancestor.json /tmp/theirs.json
cp /tmp/ours.json package.json
git add package.json

代码文件基础设施优先：

# 保留当前分支版本
git checkout --ours path/to/file.ts
git add path/to/file.ts

步骤 5：推送目标分支

# 推送合并后的分支
git push

# 可选：删除功能分支
git branch -d $FEATURE_BRANCH
git push origin --delete $FEATURE_BRANCH

询问是否删除功能分支：

✅ 合并完成！

已将 <<feature-branch>> 合并到 <<target-branch>>

是否删除功能分支 <<feature-branch>>？(y/n)

子流程：快速提交

触发条件：

• 用户说"快速提交"、"跳过检查直接提交"、/quick-commit

流程

🚀 快速提交模式

跳过所有质量检查...

当前更改：
<显示未提交文件>

请输入 commit message（或留空自动生成）：

如果用户输入消息：

• 直接使用用户输入的消息

如果用户留空：

• 运行步骤 3 的自动生成逻辑

git add -A
git commit -m "<message>"
git push

✅ 快速提交完成！

提交：<<commit-message>>
远程：已推送

子流程：分支同步

触发条件：

• 用户说"同步分支"、"更新分支代码"、/sync-branch

步骤 1：保存当前更改

# 检查是否有未提交更改
if [ -n "$(git status --porcelain)" ]; then
  git stash push -m "临时保存 - $(date +%H:%M)"
fi

步骤 2：更新主分支

# 获取当前分支
CURRENT=$(git branch --show-current)

# 切换到 develop 分支（安全的主分支）
git checkout develop

# 拉取最新代码
git pull

步骤 3：执行 rebase

# 返回原分支
git checkout $CURRENT

# 执行 rebase onto develop
git rebase develop

步骤 4：处理冲突

如果有冲突：

1. 显示冲突文件列表
2. 应用智能冲突解决规则
3. git rebase --continue

步骤 5：恢复保存的更改

# 恢复 stash
git stash pop

✅ 分支同步完成！

当前分支：<<branch-name>>
已同步最新的 develop 分支更改

子流程：分支管理

创建新分支

触发条件：

• 用户说"创建分支"、"新建 feature 分支"

步骤 1：验证分支命名

读取配置获取分支命名规范：

从 session context 中查找 <config-detected> 标记，获取 featureBranchPrefix（默认：feat/）。

验证逻辑：

# 定义合法的前缀列表
VALID_PREFIXES=(
    "feat/"      # 新功能
    "fix/"       # Bug 修复
    "refactor/"  # 代码重构
    "docs/"      # 文档更新
    "test/"      # 测试相关
    "perf/"      # 性能优化
    "style/"     # 代码格式
    "infra/"     # 基础设施/工具链
    "chore/"     # 杂项
    "build/"     # 构建系统
    "ci/"        # CI/CD 配置
)

# 验证函数
validate_branch_name() {
    local branch_name="$1"
    local has_valid_prefix=false

    for prefix in "${VALID_PREFIXES[@]}"; do
        if [[ "$branch_name" == "$prefix"* ]]; then
            has_valid_prefix=true
            break
        fi
    done

    if [ "$has_valid_prefix" = false ]; then
        return 1
    fi

    # 检查分支名长度（建议不超过 50 字符）
    if [ ${#branch_name} -gt 50 ]; then
        return 1
    fi

    # 检查分支名格式（只允许小写字母、数字、连字符、斜杠）
    if [[ ! "$branch_name" =~ ^[a-z0-9/-]+$ ]]; then
        return 1
    fi

    return 0
}

如果分支名不符合规范：

❌ 分支名不符合规范

分支名：my-feature-branch

✅ 建议使用以下前缀：
- feat/     新功能开发（例：feat/user-auth）
- fix/      Bug 修复（例：fix/login-error）
- refactor  代码重构（例：refactor/config-system）
- docs/     文档更新（例：docs/api-guide）
- test/     测试相关（例：test/auth-tests）
- perf/     性能优化（例：perf/database-query）
- style/    代码格式（例：style/button-component）
- infra/    基础设施/工具链（例：infra/setup-docker）
- chore/    杂项任务（例：chore/update-deps）
- build/    构建系统（例：build/webpack-config）
- ci/       CI/CD 配置（例：ci/github-actions）

选项：
1. 重新输入分支名
2. 强制创建（不推荐）
3. 取消

请选择：

如果用户选择重新输入：

• 询问新的分支名
• 重新验证

如果用户选择强制创建：

• 使用用户输入的分支名继续
• 记录警告

步骤 2：创建分支

验证通过后执行：

# 确保在 develop 分支上（安全的基础分支）
git checkout develop

# 拉取最新
git pull

# 创建并切换到新分支
git checkout -b $BRANCH_NAME

# 推送并设置上游
git push -u origin $BRANCH_NAME

输出：

✅ 分支创建成功！

分支名：feat/user-auth
远程：已推送到 origin

分支命名规范：

类型	前缀	使用场景	示例
新功能	feat/	新增功能、特性开发	feat/user-auth
Bug 修复	fix/	修复线上或测试发现的 Bug	fix/login-error
重构	refactor/	代码重构、不改变功能	refactor/config-system
文档	docs/	文档更新、README 变更	docs/api-guide
测试	test/	测试代码添加或修改	test/auth-tests
性能	perf/	性能优化、响应速度提升	perf/database-query
样式	style/	代码格式调整、不影响逻辑	style/button-component
基础设施	infra/	基础设施、工具链、环境配置	infra/setup-docker
杂项	chore/	依赖更新、配置文件调整	chore/update-deps
构建	build/	构建系统、打包工具配置	build/webpack-config
CI/CD	ci/	CI/CD 流程、自动化部署	ci/github-actions

清理已合并分支

触发条件：

• 用户说"清理分支"、"清理已合并的分支"

流程：

# 列出本地已合并分支
git branch --merged | grep -v "main\|develop\|master" | while read branch; do
  git branch -d "$branch"
done

# 清理远程已删除的分支引用
git remote prune origin

✅ 分支清理完成！

已删除以下本地分支：
- feat/old-feature
- fix/bug-123

配置系统

默认配置

{
  "developBranch": "develop",
  "featureBranchPrefix": "feat/",
  "checks": {
    "typeCheck": {
      "enabled": false,
      "command": "npm run type-check",
      "autoFix": true
    },
    "lint": {
      "enabled": false,
      "command": "npm run lint",
      "autoFix": true
    },
    "test": {
      "enabled": false,
      "command": "npm test"
    }
  },
  "autoMerge": {
    "enabled": false,
    "targetBranch": "develop"
  },
  "completionStrategy": "merge",
  "conflictResolution": {
    "packageJson": "merge",
    "codeFiles": "infra-priority",
    "docs": "ours",
    "testFiles": "theirs"
  }
}

配置读取

优先级：

1. 项目根目录 .workflow-config.json
2. 用户全局配置 ~/.config/horspowers/workflow-config.json
3. 默认配置

从 session context 读取配置：

在 session start 时，hook 应该检测配置并注入 <config-detected> 标记：

<config-detected>
development_mode: personal
completion_strategy: merge
develop_branch: develop
checks.typeCheck.enabled: false
checks.lint.enabled: false
</config-detected>

Quick Reference

触发短语	功能
"下班了"、"提交代码"	每日工作流（完整流程）
"快速提交"	跳过检查，直接提交
"合并到 develop"	合并当前分支到目标分支
"同步分支"	从主分支 rebase 当前分支
"创建分支"	创建新的功能分支
"清理分支"	删除已合并的本地分支

Common Mistakes

跳过 git status 检查

• 问题： 在有未提交更改时执行合并导致混乱
• 修复： 始终先显示并确认当前状态

不使用 HEREDOC 提交

• 问题： 多行 commit message 格式错误
• 修复： 使用 git commit -m "$(cat <<'EOF'...EOF)"

自动解决所有冲突

• 问题： 某些冲突需要人工判断
• 修复： 应用智能规则但允许用户干预

Red Flags

Never:

• 在检查失败时强制提交（除非用户明确要求）
• 自动删除分支而不询问
• 在有未推送更改时执行 rebase

Always:

• 显示当前状态并等待确认
• 使用 HEREDOC 格式化多行 commit message
• 智能解决冲突但允许用户干预
• 使用 develop 作为安全的目标分支（而不是 main）

Integration

替代方案：

• using-git-worktrees - 适用于并行多分支开发的场景

配合使用：

• brainstorming - 在开始新功能前进行设计
• finishing-a-development-branch - 类似的分支完成流程（但 worktree 感知）

调用此技能：

• 用户日常开发结束时
• 需要快速提交代码时
• 需要合并或同步分支时