此技能提供一个标准化、可复现的AI辅助编程工作流,通过三个有序步骤将模糊想法转化为生产就绪的代码:需求转复杂功能描述、描述加技术栈转方法调用结构、结构转完整项目代码。当用户想要开发完整软件系统、从零构建应用程序,或遵循规范的AI-人协作编程流程时,应使用此技能。
---
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已知晓,无需用户单独发布。
### 实际执行步骤
#### 第一步:需求 → 复杂功能描述
**输入**:用户提供的功能需求描述。
**执行**:
1. 将 `references/人工智能编程之复杂功能描述样本(待办任务).md` 读入上下文。
2. 参考样本格式,将需求扩展为结构化的复杂功能描述文档(需求点 → 功能点 → 执行点)。
**输出**:复杂功能描述文档。
**可修改**:用户可对输出的描述进行修改、补充、调整。
---
#### 第二步:描述 + 技术栈 → 方法调用结构
**输入**:
- 第一步输出的复杂功能描述(或修改后版本)
- 用户填充第二份提示词中的所有变量:
- `{功能描述}` — 第一步输出的结构化需求文档
- `{架构}` — 前后端分层架构模式
- `{客户端技术}` — 客户端框架
- `{服务端技术}` — 服务端框架
- `{数据库}` — 数据库类型
- `{编程语言}` — 客户端/服务端编程语言(可统一或分开指定)
**执行**:
1. 将 `references/人工智能编程之方法调用结构样本(待办任务).md` 读入上下文。
2. 在两份内置提示词的基础上,结合确定的技术栈,为每个功能点生成跨平台方法调用结构。
**输出**:方法调用结构蓝图(涵盖客户端和服务端各层)。
**可修改**:用户可对输出的结构进行修改、调整方法签名、增删节点。
---
#### 第三步:结构 → 项目完整代码
**输入**:第二步输出的方法调用结构(或修改后版本)。
**执行**:
根据方法调用结构,生成完整项目内容,包括:
- 客户端各层代码(UI、ViewModel、UseCase、Repository等)
- 服务端各层代码(Controller、Service、Repository、Entity等)
- 数据库相关代码(表结构、迁移脚本、初始数据等)
- 配置文件(环境配置、依赖管理、构建配置等)
- 部署文件(Dockerfile、docker-compose、CI/CD配置等)
- 项目结构文件(README、.gitignore等)
**输出**:可运行的完整项目(代码 + 配置 + 部署)。
**可修改**:用户可对生成的代码进行修改、优化、调整。
---
## 工作流总览
| 步骤 | 输入 | 内置提示词 | 样本参考 | 输出 | 可修改 |
|------|------|------------|----------|------|--------|
| 1 | 功能需求 | — | 复杂功能描述样本 | 复杂功能描述 | ✅ |
| 2 | 复杂功能描述 + 技术栈 | 两份提示词 | 方法调用结构样本 | 方法调用结构 | ✅ |
| 3 | 方法调用结构 | 两份提示词 | — | 完整项目 | ✅ |
**核心理念**:每个阶段的输出都可被用户修改,下一阶段基于修改后的内容继续推进。用户始终保有控制权。
## 核心价值
1. **消除模糊性**:通过结构化样本,确保需求扩展和技术设计的深度与格式符合工程标准。
2. **确保一致性**:通过架构提示词,保证所有产出都遵循统一的最佳实践和技术栈。
3. **提升可控性**:通过元协议,将生成过程置于开发者的可控节奏之下,先蓝图后实现。
4. **实现知识传承**:将内化的架构经验沉淀为可复用的"样本"和"提示词",使最佳实践得以规模化复制。
don't have the plugin yet? install it then click "run inline in claude" again.