code-workflow

一个遵循四阶段(研究、计划、评审、实现)的代码变更工作流,默认采用TDD。

安装使用

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

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

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

使用示例

‘我需要为我们的用户模块添加一个邮箱验证功能,这是相关的Issue链接。’ 它会首先引导你分析需求和研究现有代码,然后生成一份详细的实现计划(plan.md)供团队评审。评审通过后,它会基于计划创建功能分支,用TDD方式编写测试和实现代码,最后自动提交更改并生成一个包含功能演示GIF的Pull Request。

介绍

这个Skill旨在解决开发者面对代码变更任务时,流程混乱、缺乏规划、评审缺失以及实现质量参差不齐的问题。它提供了一个结构化的四阶段工作流:研究(Research)、计划(Plan)、用户评审(User Review)和实现(Implement),其中实现阶段默认遵循测试驱动开发(TDD)模式。

使用时,你可以直接向AI描述你的编码任务或GitHub Issue,它会引导你依次完成四个阶段。在研究阶段,它会帮助你搜集和分析相关信息;在计划阶段,它会生成详细的实现计划文档(如plan.md);在评审阶段,它会模拟用户视角对计划提出反馈;最后在实现阶段,它会基于计划编写测试和代码,并最终生成包含截图/GIF的Pull Request。

它非常适合需要严谨开发流程的开发者,特别是那些在团队协作、处理复杂功能或需要高质量代码保证的项目中工作的全栈、前端或后端开发人员。对于希望规范个人编码习惯、提升代码可维护性的独立开发者同样有益。

建议在开始任何非琐碎的代码修改或新功能开发时使用此Skill。你可以通过--no-tdd参数选择退出TDD。注意,它深度集成GitHub流程,最适合在GitHub仓库环境中使用,对于非Git或非代码类的任务(如纯文档撰写)可能不是最佳选择。

核心特点

与一般代码生成工具不同,它强制推行一个包含“用户评审”环节的完整、可追溯的开发流程,并将生成可视化PR(含图片/GIF)作为工作流的最终产出,而不仅仅是写代码。

注意事项

不适合进行快速原型验证或一次性脚本编写等轻量级、无需评审和文档的编码任务。

常见问题

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

在使用指令时添加 `--no-tdd` 参数即可。

这个Skill能用于非GitHub项目吗?

核心工作流可用,但自动创建PR等GitHub集成功能可能无法完全发挥作用。

给 AI 助手的安装指引

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

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