AI-Workflow-Kit：将AI编程助手转化为规范化工程工作流的Spec驱动执行系统

AWK是一个开源的Spec驱动开发工作流工具包，支持Claude Code与Codex协作，通过GitHub Issues/PRs作为状态机，实现从需求规格到代码实现的自动化流水线。

随着Claude Code、Codex等AI编程助手的普及，开发者面临一个新挑战：如何让AI助手在团队协作中保持一致的代码质量和工作流程？单纯依赖AI的"自动完成"能力，往往会导致代码风格不一致、缺乏代码审查、以及难以追踪的变更历史。

silver2dream开发的AI-Workflow-Kit（简称AWK）正是为解决这一问题而生。它是一个Spec驱动的执行系统，旨在将AI编码助手纳入规范化的工程工作流中，实现从需求规格到代码合并的全流程自动化治理。

AWK采用独特的双角色架构设计，充分利用不同AI模型的优势：

Principal（主管）- Claude Code：负责高层次决策，包括读取规格文件、创建GitHub Issue、审查PR、以及决定合并或驳回变更。Claude Code凭借其强大的推理能力，适合承担需要全局观和判断力的任务。

Worker（执行者）- Codex：负责具体的代码实现任务。Codex在代码生成方面表现出色，能够快速将规格转化为可运行的代码。

这种分工模式借鉴了传统软件工程中的架构师与开发者角色分离思想，让AI助手各司其职，形成高效的协作闭环。

AWK的核心创新在于其Spec驱动的设计理念。系统通过读取.ai/specs/<feature-name>/目录下的规格文件来决定下一步行动：

• requirements.md（可选）：功能需求描述
• design.md（可选）：技术设计方案
• tasks.md（必需）：具体任务清单

这种结构与Kiro规格格式兼容，使得团队可以使用统一的规格语言来描述需求。开发者只需在workflow.yaml中启用相应的规格文件夹，AWK便会自动解析并执行对应的任务流水线。

AWK巧妙地将GitHub平台本身作为工作流的状态机：

1. Issue创建：当检测到新的规格任务时，Principal自动创建GitHub Issue进行追踪
2. 任务派发：Principal将实现任务分派给Worker
3. PR审查：Worker完成代码后提交PR，Principal进行自动化审查
4. 合并决策：审查通过后自动合并，或创建修复Issue退回修改

这种设计的好处在于，整个工作流的状态对团队成员完全透明。任何人都可以通过查看GitHub Issues和PRs了解项目进展，无需登录特定的AI助手界面。

为了确保AI生成代码的质量，AWK内置了两层质量保障机制：

离线验证门（Offline Gate）：在代码合并前执行确定性的本地验证，包括构建、测试、代码风格检查等。这些验证不依赖外部网络，确保可重复性。

严格模式（Strict Mode）：通过--strict标志启用，要求审计中不能有任何P0级别的问题发现。这一模式适用于发布前的最终检查，确保代码达到生产环境标准。

此外，AWK还支持可扩展性检查，验证CI触发器是否与功能分支对齐，防止因配置错误导致的构建失败。

AWK考虑到实际开发中的多样化需求，支持三种仓库类型配置：

类型	适用场景	特点
root	单一独立项目	所有操作在仓库根目录执行
directory	单体仓库子目录	操作在工作树根目录执行，变更限定于子目录
submodule	Git子模块	子模块独立提交后更新父仓库引用

这种灵活性使得AWK既能服务于简单的独立项目，也能适配复杂的微服务架构或游戏引擎+后端的多组件项目。

AWK提供了便捷的CLI工具awkit，支持一键初始化项目：

# 基础初始化
awkit init

# 带脚手架的Go项目
awkit init --preset go --scaffold

# React + Go单体仓库
awkit init --preset react-go --scaffold

目前支持的预设包括：generic、go、python、rust、dotnet、node等单仓库模板，以及react-go、react-python、unity-go等单体仓库组合。开发者还可以通过awkit list-presets查看所有可用选项。