← 张轶渤 / 项目GitHub ↗
AAW 按层设计方法
PROJECT 02 · SDD / AGENT WORKFLOW

Awesome-Agent-Workflow

让 Coding Agent 在正确阶段,处理正确层次的问题。

一套面向复杂软件需求的 AI 辅助研发工作流。它把需求、代码事实、实现设计、测试设计、质量门禁和代码交付组织成可追溯、可中断、可恢复的工程管道。

10 阶段 SDD流控 CLI双 Agent ReviewModule Deep Research采纳遥测
10 阶段从需求输入到代码交付
CLI 编排状态、契约与质量校验
部门推广进入真实研发场景
持续演进流程与模块知识资产
01为什么做

AI 能很快交出代码,但“已经写完”并不等于“已经想清楚”。

复杂需求中,低质量输入、跨层讨论和信息轰炸会把发现漏洞的压力转移给研发人员。AAW 的目标不是增加文档数量,而是让问题在所属层级被充分处理,并为后续阶段提供稳定、可审查的输入。

01

代码事实容易漏

模块内部常藏有历史约束、隐含场景和技术债务,浅层阅读会让设计建立在错误假设上。

02

设计层级容易混

需求、功能、模块交互和代码实现同时讨论,人的判断负担会迅速上升。

03

Agent 容易越阶段交付

成果物未达标时仍继续编码,最终只能依靠人从大量输出中找出缺陷。

02怎么解决

把研发过程做成有状态、有契约、有门禁的执行系统。

工作流先分离问题层级,再通过 CLI 管理流转。模型负责阶段内分析与设计,输入输出契约、人工确认、成果物校验和回退规则负责约束阶段边界。

01

需求稳定

澄清目标、范围、Actor 与关键场景。

02

事实挖掘

AS-IS 用证据还原相关模块现状。

03

实现设计

TO-BE 形成可 Review 的详细设计。

04

质量设计

测试设计与多维门禁提前发现缺口。

05

受控交付

任务拆分、编码、语义 Review 与重验。

03我的工作

不只编写几个 Skill,也建设了让整条流程可运行、可观测的基础设施。

01

模块级设计链路

负责 AS-IS、TO-BE、测试设计和设计质量门禁,明确代码事实、正式规格、验证集合与对抗审查的职责边界。

02

配置驱动的流控 CLI

设计节点契约、分支、循环、人工确认、断点恢复与可控回退;优先通过 YAML 扩展流程,CLI 负责状态和交付校验。

03

task-dev 交付状态机

将编码、测试、双 Agent 语义 Review、问题修复与重验、CodeCheck 和最终完成校验纳入统一编排。

04

module-deep-research

通过长程循环持续挖掘复杂模块的隐含逻辑与历史约束,并随代码变化增量更新模块认知资产。

05

采纳率遥测与门户

建设首版遥测服务和可视化主页,观测工作流、Step、Gate、耗时与基于 Diff 的代码归因,为流程调优提供依据。

04现状与价值

流程会多花一些设计时间,但能更早发现没有意识到的细节。

项目已在部门内正式推广。实际反馈表明,按层设计和阶段门禁让生成代码更接近研发人员脑中的目标,也降低了人在跨层信息中持续应答和纠错的负担。正式使用人数、工作流执行量和生成代码量后续将以遥测统计补充。

我对它的定位

这是“AI 与软件工程结合的方法论”及其可执行实现。价值不在某一个 Skill,而在流程设计、执行控制、质量约束、知识演进和推广观测组成的完整体系。