- name
- AI Dev Workflow
- author
- 王教成 Wang Jiaocheng (波动几何)
- description
- 此技能提供一个标准化、可复现的AI辅助编程工作流，通过三个有序步骤将模糊想法转化为生产就绪的代码：需求转复杂功能描述、描述加技术栈转方法调用结构、结构转完整项目代码。当用户想要开发完整软件系统、从零构建应用程序，或遵循规范的AI-人协作编程流程时，应使用此技能。
AI Dev Workflow - 标准化AI辅助编程工作流
一个标准化、可复现的三步AI辅助编程工作流，通过"样本模仿"与"提示词驱动"的有机结合，实现从模糊需求到生产代码的确定性转换。
核心原则
- 样本模仿：使用经过验证的文档样本引导需求扩展和技术设计，消除随机性。
- 提示词驱动：提前建立元协议和架构提示词，确保所有生成物的一致性。
- 渐进式展示：默认先交付架构蓝图，完整代码按需提供——让开发者掌控信息深度。
参考文档
本技能在 references/ 目录下捆绑三份参考文档：
| 文件 | 角色 |
|---|---|
references/人工智能编程之复杂功能描述样本（待办任务）.md | 样本1 — 展示如何编写结构化的复杂功能描述（需求点→功能点→执行点）。 |
references/人工智能编程之方法调用结构样本（待办任务）.md | 样本2 — 展示如何编写跨平台的方法调用结构蓝图，涵盖客户端和服务端各层。 |
references/从灵感到实现：一个标准化、可复现的AI辅助编程工作流.md | 背景阅读 — 完整的方法论文档（原文为五步版本，本技能已简化为三步）。供人类或无程序能力的LLM阅读，用于理解背景原理和手动复制粘贴执行步骤。 |
使用方式：在执行对应工作流步骤时，将相关样本参考文档读入上下文。对于较大的参考文件，使用grep/搜索定位特定章节，而非加载整个文件。
工作流说明
本技能已将两份提示词内置，AI可一次性获取完整上下文。实际使用流程如下：
内置提示词
元协议（第一份提示词）：
执行协议等待指令：复杂功能分拆成原子方法，原子方法生成完整代码，默认只展示方法调用结构但用户可以要求展示完整代码。
架构与技术栈提示词（第二份提示词）：
做一个功能为{首次回复要求提供功能描述}的APP，使用{客户端（UI层→ViewModel→UseCase→Repository→数据源）→服务器（Controller→Service→Repository→Entity→Database）}的架构，采用{Android}客户端、{SpringBoot}服务器和{MySQL}数据库并统一使用{Kotlin}语言。
两份提示词定义了工作规则和技术路径，AI已知晓，无需用户单独发布。
实际执行步骤
第一步：需求 → 复杂功能描述
输入：用户提供的功能需求描述。
执行：
- 将
references/人工智能编程之复杂功能描述样本（待办任务）.md读入上下文。 - 参考样本格式，将需求扩展为结构化的复杂功能描述文档（需求点 → 功能点 → 执行点）。
输出：复杂功能描述文档。
可修改：用户可对输出的描述进行修改、补充、调整。
第二步：描述 + 技术栈 → 方法调用结构
输入：
- 第一步输出的复杂功能描述（或修改后版本）
- 用户填充第二份提示词中的所有变量：
- {功能描述} — 第一步输出的结构化需求文档 - {架构} — 前后端分层架构模式 - {客户端技术} — 客户端框架 - {服务端技术} — 服务端框架 - {数据库} — 数据库类型 - {编程语言} — 客户端/服务端编程语言（可统一或分开指定）
执行：
- 将
references/人工智能编程之方法调用结构样本（待办任务）.md读入上下文。 - 在两份内置提示词的基础上，结合确定的技术栈，为每个功能点生成跨平台方法调用结构。
输出：方法调用结构蓝图（涵盖客户端和服务端各层）。
可修改：用户可对输出的结构进行修改、调整方法签名、增删节点。
第三步：结构 → 项目完整代码
输入：第二步输出的方法调用结构（或修改后版本）。
执行： 根据方法调用结构，生成完整项目内容，包括：
- 客户端各层代码（UI、ViewModel、UseCase、Repository等）
- 服务端各层代码（Controller、Service、Repository、Entity等）
- 数据库相关代码（表结构、迁移脚本、初始数据等）
- 配置文件（环境配置、依赖管理、构建配置等）
- 部署文件（Dockerfile、docker-compose、CI/CD配置等）
- 项目结构文件（README、.gitignore等）
输出：可运行的完整项目（代码 + 配置 + 部署）。
可修改：用户可对生成的代码进行修改、优化、调整。
工作流总览
| 步骤 | 输入 | 内置提示词 | 样本参考 | 输出 | 可修改 |
|---|---|---|---|---|---|
| 1 | 功能需求 | — | 复杂功能描述样本 | 复杂功能描述 | ✅ |
| 2 | 复杂功能描述 + 技术栈 | 两份提示词 | 方法调用结构样本 | 方法调用结构 | ✅ |
| 3 | 方法调用结构 | 两份提示词 | — | 完整项目 | ✅ |
核心理念：每个阶段的输出都可被用户修改，下一阶段基于修改后的内容继续推进。用户始终保有控制权。
核心价值
- 消除模糊性：通过结构化样本，确保需求扩展和技术设计的深度与格式符合工程标准。
- 确保一致性：通过架构提示词，保证所有产出都遵循统一的最佳实践和技术栈。
- 提升可控性：通过元协议，将生成过程置于开发者的可控节奏之下，先蓝图后实现。
- 实现知识传承：将内化的架构经验沉淀为可复用的"样本"和"提示词"，使最佳实践得以规模化复制。