Skip to content

Commit 63a316b

Browse files
authored
chore: update config files and clean up old files 🧹 (#139)
1 parent 4859c83 commit 63a316b

16 files changed

Lines changed: 392 additions & 311 deletions

File tree

config/.augment-guidelines

Lines changed: 28 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ alwaysApply: true
3535
3. "请确认我的理解是否正确"
3636

3737
## 核心行为规则
38-
1. **工具优先**:关于腾讯云开发的操作,优先使用 cloudbase 的 MCP 工具
38+
1. **工具优先**:关于腾讯云开发的操作,必须优先使用 cloudbase 的 MCP 工具
3939
2. **项目理解**:首先阅读当前项目的 README.md,遵照项目说明开发
40-
3. **目录规范**:在当前目录下产出项目代码,先检查当前目录文件
40+
3. **目录规范**:在当前目录下产出项目代码之前,先检查当前目录文件
4141
4. **部署顺序**:有后端依赖时,优先部署后端再预览前端
4242
5. **交互确认**:需求不明确时使用 interactiveDialog 澄清,执行高风险操作前必须确认
4343
6. **实时通信**:使用云开发的实时数据库 watch 能力
@@ -61,23 +61,28 @@ alwaysApply: true
6161

6262
## 工作流
6363

64+
你会根据用户的需求智能判断使用哪种模式来开发,默认情况下采用 spec 来开发
65+
66+
**智能判断标准:**
67+
- **使用 spec**:新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计
68+
- **跳过 spec**:简单修复、文档更新、配置修改、代码重构
69+
6470
### Workflow 命令控制
6571

72+
用户也可以通过指令来要求
73+
6674
**可用命令:**
67-
- **默认** - AI 根据任务复杂度智能判断
6875
- **/spec** - 强制使用完整 spec 流程
6976
- **/no_spec** - 跳过 spec 流程,直接执行
7077
- **/help** - 显示命令帮助
7178

72-
**智能判断标准:**
73-
- **使用 spec**:新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计
74-
- **跳过 spec**:简单修复、文档更新、配置修改、代码重构
7579

80+
以下是 spec 工作流:
7681
<spec_workflow>
7782
0. 请注意!必须遵守以下的规则,每个环节完成后都需要由我进行确认后才可进行下一个环节;
7883
1. 如果你判断我的输入提出的是一个新需求,可以按照下面的标准软件工程的方式独立开展工作,需要时才向我询问,可以采用 interactiveDialog 工具来收集
79-
2. 每当我输入新的需求的时候,为了规范需求质量和验收标准,你首先会搞清楚问题和需求,然后再进入下一阶段
80-
3. 需求文档和验收标准设计:首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,也可在需求中提前确定好设计风格和配色等,跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 `specs/spec_name/requirements.md` 中,参考格式如下
84+
2. 每当我输入新的需求的时候,为了规范需求质量和验收标准,必须首先会搞清楚问题和需求,然后再进入下一阶段
85+
3. 需求文档和验收标准设计:首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,需要在需求中提前确定好设计风格和配色,必须跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 `specs/spec_name/requirements.md` 中,参考格式如下
8186

8287
```markdown
8388
# 需求文档
@@ -98,8 +103,8 @@ alwaysApply: true
98103
2. ...
99104
...
100105
```
101-
4. 技术方案设计: 在完成需求的设计之后,你会根据当前的技术架构和前面确认好的需求,进行需求的技术方案设计,精简但是能够准确的描述技术的架构(例如架构、技术栈、技术选型、数据库/接口设计、测试策略、安全性),必要时可以用 mermaid 来绘图,跟我确认清楚后,保存在 `specs/spec_name/design.md` 中,然后再进入下一阶段
102-
5. 任务拆分:在完成技术方案设计后,你会根据需求文档和技术方案,细化具体要做的事情,跟我确认清楚后,,保存在`specs/spec_name/tasks.md` 中, 然后再进入下一阶段,开始正式执行任务,同时需要及时更新任务的状态,执行的时候尽可能独立自主运行,保证效率和质量
106+
4. 技术方案设计: 在完成需求的设计之后,你会根据当前的技术架构和前面确认好的需求,进行需求的技术方案设计,精简但是能够准确的描述技术的架构(例如架构、技术栈、技术选型、数据库/接口设计、测试策略、安全性),必要时可以用 mermaid 来绘图,必须跟我确认清楚后,保存在 `specs/spec_name/design.md` 中,然后再进入下一阶段
107+
5. 任务拆分:在完成技术方案设计后,你会根据需求文档和技术方案,细化具体要做的事情,必须跟我确认清楚后,,保存在`specs/spec_name/tasks.md` 中, 然后再进入下一阶段,开始正式执行任务,同时需要及时更新任务的状态,执行的时候尽可能独立自主运行,保证效率和质量
103108

104109
任务参考格式如下
105110

@@ -116,22 +121,30 @@ alwaysApply: true
116121

117122
## 🔄 开发工作流程
118123

124+
## 开发
125+
126+
1. **下载云开发 AI 规则或者其他模板**:推荐从模板开始新的项目,可以使用downloadTemplate 来下载,如果无法下载到当前目录,可以使用脚本来进行复制,注意隐藏文件也需要复制
127+
128+
2. **小程序 TabBar等素材下载下载远程素材链接**:小程序的 Tabbar 等素材图片,必须使用 **png** 格式,必须使用 downloadRemoteFile 工具下载文件到本地
129+
130+
如果应用中需要远程链接,可以继续调用 uploadFile 上传后获得临时访问链接和云存储的 cloudId
131+
132+
3. **从知识库查询专业知识**: 如果对于云开发某块知识不确定,可以使用 searchKnowledgeBase 工具智能检索云开发知识库(支持云开发与云函数、小程序前端知识等),通过向量搜索快速获取专业文档与答案
133+
134+
119135
### 部署流程
120136
1. **部署云函数流程**:可以通过 getFunctionList MCP 工具来查询是否有云函数,然后直接调用 createFunction 或者 updateFunctionCode 更新云函数代码,只需要将functionRootPath 指向云函数目录的父目录(例如 cloudfuncitons 这个目录的绝对路径),不需要压缩代码等操作,上述工具会自动读取云函数父目录下的云函数同名目录的文件,并自动进行部署
121137

122138
2. **部署静态托管流程**:通过使用 uploadFiles 工具部署,部署完毕后提醒用户 CDN 有几分钟缓存,可以生成一个带有随机 queryString 的markdown 格式 访问链接
123139

124-
3. **下载远程素材链接**:使用 downloadRemoteFile 工具下载文件到本地,如果需要远程链接,可以继续调用 uploadFile 上传后获得临时访问链接和云存储的 cloudId
125-
126-
4. **从知识库查询专业知识**:可以使用 searchKnowledgeBase 工具智能检索云开发知识库(支持云开发与云函数、小程序前端知识等),通过向量搜索快速获取专业文档与答案
127-
128-
5. **下载云开发 AI 规则或者其他模板**:可以使用downloadTemplate 来下载,如果无法下载到当前目录,可以使用脚本来进行复制,注意隐藏文件也需要复制
129140

130141
### 文档生成规则
142+
131143
1. 你会在生成项目后生成一个 README.md 文件,里面包含项目的基本信息,例如项目名称、项目描述, 最关键的是要把项目的架构和涉及到的云开发资源说清楚,让维护者可以参考来进行修改和维护
132144
2. 部署完毕后,如果是 web 可以把正式部署的访问地址也写到文档中
133145

134146
### 配置文件规则
147+
135148
1. 为了方便其他不使用 AI 的人了解有哪些资源,可以在生成之后,同时生成一个 cloudbaserc.json
136149

137150
### MCP 接口调用规则

config/.clinerules/cloudbase-rules.mdc

Lines changed: 28 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ alwaysApply: true
3535
3. "请确认我的理解是否正确"
3636

3737
## 核心行为规则
38-
1. **工具优先**:关于腾讯云开发的操作,优先使用 cloudbase 的 MCP 工具
38+
1. **工具优先**:关于腾讯云开发的操作,必须优先使用 cloudbase 的 MCP 工具
3939
2. **项目理解**:首先阅读当前项目的 README.md,遵照项目说明开发
40-
3. **目录规范**:在当前目录下产出项目代码,先检查当前目录文件
40+
3. **目录规范**:在当前目录下产出项目代码之前,先检查当前目录文件
4141
4. **部署顺序**:有后端依赖时,优先部署后端再预览前端
4242
5. **交互确认**:需求不明确时使用 interactiveDialog 澄清,执行高风险操作前必须确认
4343
6. **实时通信**:使用云开发的实时数据库 watch 能力
@@ -61,23 +61,28 @@ alwaysApply: true
6161

6262
## 工作流
6363

64+
你会根据用户的需求智能判断使用哪种模式来开发,默认情况下采用 spec 来开发
65+
66+
**智能判断标准:**
67+
- **使用 spec**:新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计
68+
- **跳过 spec**:简单修复、文档更新、配置修改、代码重构
69+
6470
### Workflow 命令控制
6571

72+
用户也可以通过指令来要求
73+
6674
**可用命令:**
67-
- **默认** - AI 根据任务复杂度智能判断
6875
- **/spec** - 强制使用完整 spec 流程
6976
- **/no_spec** - 跳过 spec 流程,直接执行
7077
- **/help** - 显示命令帮助
7178

72-
**智能判断标准:**
73-
- **使用 spec**:新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计
74-
- **跳过 spec**:简单修复、文档更新、配置修改、代码重构
7579

80+
以下是 spec 工作流:
7681
<spec_workflow>
7782
0. 请注意!必须遵守以下的规则,每个环节完成后都需要由我进行确认后才可进行下一个环节;
7883
1. 如果你判断我的输入提出的是一个新需求,可以按照下面的标准软件工程的方式独立开展工作,需要时才向我询问,可以采用 interactiveDialog 工具来收集
79-
2. 每当我输入新的需求的时候,为了规范需求质量和验收标准,你首先会搞清楚问题和需求,然后再进入下一阶段
80-
3. 需求文档和验收标准设计:首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,也可在需求中提前确定好设计风格和配色等,跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 `specs/spec_name/requirements.md` 中,参考格式如下
84+
2. 每当我输入新的需求的时候,为了规范需求质量和验收标准,必须首先会搞清楚问题和需求,然后再进入下一阶段
85+
3. 需求文档和验收标准设计:首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,需要在需求中提前确定好设计风格和配色,必须跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 `specs/spec_name/requirements.md` 中,参考格式如下
8186

8287
```markdown
8388
# 需求文档
@@ -98,8 +103,8 @@ alwaysApply: true
98103
2. ...
99104
...
100105
```
101-
4. 技术方案设计: 在完成需求的设计之后,你会根据当前的技术架构和前面确认好的需求,进行需求的技术方案设计,精简但是能够准确的描述技术的架构(例如架构、技术栈、技术选型、数据库/接口设计、测试策略、安全性),必要时可以用 mermaid 来绘图,跟我确认清楚后,保存在 `specs/spec_name/design.md` 中,然后再进入下一阶段
102-
5. 任务拆分:在完成技术方案设计后,你会根据需求文档和技术方案,细化具体要做的事情,跟我确认清楚后,,保存在`specs/spec_name/tasks.md` 中, 然后再进入下一阶段,开始正式执行任务,同时需要及时更新任务的状态,执行的时候尽可能独立自主运行,保证效率和质量
106+
4. 技术方案设计: 在完成需求的设计之后,你会根据当前的技术架构和前面确认好的需求,进行需求的技术方案设计,精简但是能够准确的描述技术的架构(例如架构、技术栈、技术选型、数据库/接口设计、测试策略、安全性),必要时可以用 mermaid 来绘图,必须跟我确认清楚后,保存在 `specs/spec_name/design.md` 中,然后再进入下一阶段
107+
5. 任务拆分:在完成技术方案设计后,你会根据需求文档和技术方案,细化具体要做的事情,必须跟我确认清楚后,,保存在`specs/spec_name/tasks.md` 中, 然后再进入下一阶段,开始正式执行任务,同时需要及时更新任务的状态,执行的时候尽可能独立自主运行,保证效率和质量
103108

104109
任务参考格式如下
105110

@@ -116,22 +121,30 @@ alwaysApply: true
116121

117122
## 🔄 开发工作流程
118123

124+
## 开发
125+
126+
1. **下载云开发 AI 规则或者其他模板**:推荐从模板开始新的项目,可以使用downloadTemplate 来下载,如果无法下载到当前目录,可以使用脚本来进行复制,注意隐藏文件也需要复制
127+
128+
2. **小程序 TabBar等素材下载下载远程素材链接**:小程序的 Tabbar 等素材图片,必须使用 **png** 格式,必须使用 downloadRemoteFile 工具下载文件到本地
129+
130+
如果应用中需要远程链接,可以继续调用 uploadFile 上传后获得临时访问链接和云存储的 cloudId
131+
132+
3. **从知识库查询专业知识**: 如果对于云开发某块知识不确定,可以使用 searchKnowledgeBase 工具智能检索云开发知识库(支持云开发与云函数、小程序前端知识等),通过向量搜索快速获取专业文档与答案
133+
134+
119135
### 部署流程
120136
1. **部署云函数流程**:可以通过 getFunctionList MCP 工具来查询是否有云函数,然后直接调用 createFunction 或者 updateFunctionCode 更新云函数代码,只需要将functionRootPath 指向云函数目录的父目录(例如 cloudfuncitons 这个目录的绝对路径),不需要压缩代码等操作,上述工具会自动读取云函数父目录下的云函数同名目录的文件,并自动进行部署
121137

122138
2. **部署静态托管流程**:通过使用 uploadFiles 工具部署,部署完毕后提醒用户 CDN 有几分钟缓存,可以生成一个带有随机 queryString 的markdown 格式 访问链接
123139

124-
3. **下载远程素材链接**:使用 downloadRemoteFile 工具下载文件到本地,如果需要远程链接,可以继续调用 uploadFile 上传后获得临时访问链接和云存储的 cloudId
125-
126-
4. **从知识库查询专业知识**:可以使用 searchKnowledgeBase 工具智能检索云开发知识库(支持云开发与云函数、小程序前端知识等),通过向量搜索快速获取专业文档与答案
127-
128-
5. **下载云开发 AI 规则或者其他模板**:可以使用downloadTemplate 来下载,如果无法下载到当前目录,可以使用脚本来进行复制,注意隐藏文件也需要复制
129140

130141
### 文档生成规则
142+
131143
1. 你会在生成项目后生成一个 README.md 文件,里面包含项目的基本信息,例如项目名称、项目描述, 最关键的是要把项目的架构和涉及到的云开发资源说清楚,让维护者可以参考来进行修改和维护
132144
2. 部署完毕后,如果是 web 可以把正式部署的访问地址也写到文档中
133145

134146
### 配置文件规则
147+
135148
1. 为了方便其他不使用 AI 的人了解有哪些资源,可以在生成之后,同时生成一个 cloudbaserc.json
136149

137150
### MCP 接口调用规则

0 commit comments

Comments
 (0)