aidoc-flow-framework

为AI Agent提供防漂移、可验证的规范驱动开发框架

安装使用

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

帮我安装这个 AI Skill:aidoc-flow-framework。
它的用途是:为AI Agent提供防漂移、可验证的规范驱动开发框架
完整的 Skill 内容见:https://321skill.com/skills/aidoc-flow-framework/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“基于这份产品愿景文档,使用aidoc-flow-framework生成完整的PRD和EARS规范,并确保所有外部依赖都被明确标识。” 框架会引导AI将你的愿景转化为结构化的产品需求文档和可执行、可验证的场景规范,并生成对应的追踪链接。你可以要求AI在EARS层停下来,供你评审“完成的正确定义”是否准确,然后再继续生成架构决策和实现计划。

介绍

该框架旨在解决AI Agent在快速生成代码时,因缺乏严格规范和可追溯性而导致的代码难以维护、需求无声漂移的问题。它通过将人类提出的项目构想(种子)转化为一个结构化的、可追踪的、机器可验证的规范链(从BRD到实现计划),为AI Agent提供明确的构建和维护依据。

使用方式上,开发者或架构师首先提供项目的愿景、策略等初始文档作为“种子”。框架会引导AI Agent将其逐步转化为八个层层递进、相互关联的规范层(如业务需求、产品需求、行为驱动开发规范等),并在关键节点(如EARS/BDD层)进行验证,确保需求定义正确后再进入架构设计。

它非常适合那些希望利用AI Agent进行复杂软件开发,但又担心代码质量失控、技术债务累积的团队或个人开发者,尤其是项目负责人和架构师。

与同类AI代码生成工具或开发框架相比,aidoc-flow-framework的核心区别在于其强烈的“防漂移”和“可验证”特性。它不是简单地生成代码,而是构建一个从业务意图到代码实现的、活的、可审计的规范契约,确保AI Agent在整个软件生命周期中的行为始终与原始意图对齐。

核心特点

核心区别在于构建了一个从业务需求到代码实现的、机器可读且可验证的“规范链”,强制AI Agent在明确的契约下工作,从根本上防止需求在多次AI迭代中无声漂移。它强调在编写架构和代码之前,先通过EARS/BDD层定义并验证“完成的正确定义”。

注意事项

不适合追求快速原型、一次性脚本或对结构化开发流程有抵触的极简项目。

常见问题

aidoc-flow-framework 和普通的开发框架(如Spring, Django)有什么区别?

它不是用来直接编写业务代码的运行时框架,而是一个为AI Agent设计的“元开发框架”,专注于生成和管理规范文档,确保AI生成的代码符合原始业务意图。

这个框架需要人类全程参与吗?

人类主要在初始阶段提供“种子”意图,并在关键决策点(如EARS/BDD评审)进行验证。后续的规范链生成、维护和代码实现主要由AI Agent在框架约束下完成。

给 AI 助手的安装指引

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

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