code-workflow

一个遵循四阶段(研究、计划、评审、实现)的代码变更工作流智能体技能。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:code-workflow。
它的用途是:一个遵循四阶段(研究、计划、评审、实现)的代码变更工作流智能体技能。
完整的 Skill 内容见:https://321skill.com/skills/code-workflow-x-7/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我需要为这个用户登录功能添加双因素认证(2FA)。” 它会首先引导你研究现有认证逻辑和可行的2FA方案,并输出一份 `plan.md` 计划文档。经团队评审确认后,它会创建功能分支,并指导你以TDD方式编写测试和实现代码。完成后,它会自动截取2FA设置和登录流程的屏幕录像,并生成一个包含所有上下文和演示的Pull Request。

介绍

该技能旨在解决软件开发中代码变更流程混乱、缺乏结构化协作和文档记录的问题。它将一次代码变更拆解为研究、计划、用户评审和实现(默认TDD)四个清晰阶段,确保变更经过充分思考和团队共识,减少返工和沟通成本。

使用时,你可以向搭载此技能的AI助手描述一个待实现的Issue、功能或Bug修复。它会引导你依次完成:Step 0-3(复现问题、研究背景、编写计划文档、发起用户评审并创建分支),Step 4(遵循TDD进行实现、构建和提交),最后自动捕获变更(截图/GIF/视频)并生成包含丰富上下文的Pull Request。

该技能非常适合需要规范开发流程、强调代码质量和团队协作的开发者、技术负责人或项目团队。尤其适用于处理复杂功能、重构或需要跨团队评审的变更。

建议在GitHub仓库环境中使用,以充分利用其与github-flow的自动集成能力。对于小型、快速的修复,可以考虑使用 --no-tdd 选项跳过测试驱动开发步骤以提升效率。注意,其价值在于流程的完整性,对于追求极致速度的“黑客松”式开发可能显得繁琐。

核心特点

与普通代码助手不同,它强制推行一个包含“用户评审”环节的完整四阶段工作流,并将计划文档化(plan.md),确保变更意图清晰且经过确认;同时,它能自动为PR生成包含图像/GIF/视频的变更演示,极大提升了代码审查的直观性和效率。

注意事项

不适合需要快速验证原型或进行简单、紧急的热修复(hotfix)的场景,因其完整的流程可能影响交付速度。

常见问题

如何跳过测试驱动开发(TDD)?

在启动实现阶段时,使用 `--no-tdd` 参数即可跳过TDD步骤。

这个技能必须配合GitHub使用吗?

不是必须,但其“自动捕获并生成PR”等高级功能深度集成GitHub工作流,在GitHub仓库中使用体验最佳。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/code-workflow-x-7/raw/index.md 读取 code-workflow 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。