Skip to content

Commit b0498ce

Browse files
committed
feat(commands): add prototype command and sync spec/no_spec commands 🚀
1 parent 519a5b1 commit b0498ce

7 files changed

Lines changed: 164 additions & 3 deletions

File tree

config/.claude/commands/no_spec.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# /no_spec - 跳过 spec 流程,直接执行
2+
3+
## 命令说明
4+
跳过 spec 流程,直接执行开发任务,适用于简单修复、文档更新、配置修改、代码重构等场景。
5+
6+
## 适用场景
7+
- 简单修复
8+
- 文档更新
9+
- 配置修改
10+
- 代码重构
11+
- 快速迭代
12+
- 不需要详细规划和文档的简单任务
13+
14+
## 工作模式
15+
当使用 `/no_spec` 命令时,AI 将:
16+
1. 跳过需求文档设计阶段
17+
2. 跳过技术方案设计阶段
18+
3. 跳过任务拆分阶段
19+
4. 直接开始执行具体的开发任务
20+
5. 根据用户需求快速响应和实现
21+
22+
## 注意事项
23+
- 适用于相对简单和明确的任务
24+
- 对于复杂项目建议使用 `/spec` 命令
25+
- 仍然需要遵循基本的开发规范和最佳实践
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# /prototype - 快速原型开发模式
2+
3+
## 命令说明
4+
快速原型开发模式,专注于快速验证想法和概念,适用于MVP开发、概念验证、技术探索等场景。
5+
6+
## 工作模式
7+
当使用 `/prototype` 命令时,AI 将:
8+
1. 快速理解核心需求
9+
2. 采用最小可行产品(MVP)策略
10+
3. 优先实现核心功能
11+
4. 使用快速原型技术栈
12+
5. 专注于功能验证而非完美实现
13+
14+
## 开发原则
15+
- **快速迭代**:优先实现核心功能,快速验证想法
16+
- **最小可行**:只实现必要的功能,避免过度设计
17+
- **技术简化**:使用成熟稳定的技术栈,避免复杂配置
18+
- **快速部署**:优先考虑快速部署和演示
19+
- **用户反馈**:设计便于收集用户反馈的机制
20+
21+
## 适用场景
22+
- MVP(最小可行产品)开发
23+
- 概念验证(PoC)
24+
- 技术探索和实验
25+
- 快速演示原型
26+
- 用户需求验证
27+
- 技术选型验证
28+
- 快速功能原型
29+
30+
## 开发流程
31+
32+
你是专业的前端开发工程师,专长于创建高保真原型设计。你的主要工作是将用户需求转化为可直接用于开发的界面原型。请通过以下方式完所有界面的原型设计,并确保这些原型界面可以直接用于开发.
33+
34+
1、用户体验分析:先分析这个 App 的主要功能和用户需求,确定核心交互逻辑。
35+
2、产品界面规划:作为产品经理,定义关键界面,确保信息架构合理。
36+
3、高保真 UI 设计:作为 UI 设计师,设计贴近真实 iOS/Android/Web App 设计规范的界面,使用现代化的 UI 元素,使其具有良好的视觉体验。
37+
4、HTML 原型实现:使用  HTML + Tailwind CSS 生成所有原型界面,可以使用 FontAwesome 让界面更加精美、接近真实的 App 设计。拆分代码文件,保持结构清晰。
38+
5、每个界面应作为独立的  HTML  文件存放,例如 home.html、profile.html、settings.html,每个界面需要包含自己的 style script 等。
39+
- 页面应当包含基础的交互动作 & 数据逻辑,而非仅是静态的内容,可以用于实际开发。
40+
- 真实感增强:界面尺寸应当考虑响应式,移动端模拟 iPhone 15 Pro,PC 端适配 1440px 宽度。
41+
- 使用真实的 UI 图片,而非占位符图片(可从 Unsplash、wikimedia【一般选用 500 大小即可、Pexels、Apple 官方 UI 等资源中选择,选择最合适的资源,保证图片内容匹配)。
42+
43+
如无特别要求,给出至多4个页面即可。无需考虑生成长度与复杂度,保证应用的丰富实际可用。请按照以上要求生成完整的 HTML 代码,并确保其可用于实际开发。
44+
45+
ULIMPORTANT: **只生成 HTML 原型**,其他技术栈由后续开发实现。即使用户要求生成 React/小程序 项目代码,也仅将其当做生成一个应用,仅使用 HTML 实现,而非实现 React/小程序。
46+
47+
我将为您设计一个完整的高保真移动应用原型,包含用户体验分析、界面规划和HTML实现。请先告诉我您想要开发的App类型或具体需求,例如:
48+
49+
1. 这是一个什么类型的App?(社交、电商、工具、内容等)
50+
3. 主要功能需求有哪些?
51+
4. 是否有特定的设计风格偏好?
52+
5. 需要支持哪些核心业务流程?
53+
54+
有了这些信息后,我可以为您提供:
55+
- 完整的用户体验分析报告
56+
- 详细的产品界面规划
57+
- 符合iOS/Android设计规范的高保真UI设计
58+
- 可直接用于开发的HTML+Tailwind CSS原型代码
59+
60+
请提供更多关于您想要开发的App的具体信息,我将为您生成完整的原型设计方案。

config/.claude/commands/spec.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
# /spec - 强制使用完整 spec 流程
2+
3+
## 命令说明
4+
强制使用完整 spec 流程进行开发,适用于新功能开发、复杂架构设计、多模块集成、涉及数据库/UI设计等场景。
5+
6+
## 工作流程
7+
8+
### 0. 重要提醒
9+
请注意!必须遵守以下的规则,每个环节完成后都需要由我进行确认后才可进行下一个环节;
10+
11+
### 1. 需求澄清
12+
如果你判断我的输入提出的是一个新需求,可以按照下面的标准软件工程的方式独立开展工作,需要时才向我询问,可以采用 interactiveDialog 工具来收集
13+
14+
### 2. 需求分析
15+
每当我输入新的需求的时候,为了规范需求质量和验收标准,必须首先会搞清楚问题和需求,然后再进入下一阶段
16+
17+
### 3. 需求文档和验收标准设计
18+
首先完成需求的设计,按照 EARS 简易需求语法方法来描述,如果你判断需求涉及到前端页面,需要在需求中提前确定好设计风格和配色,必须跟我进行确认需求细节,最终确认清楚后,需求定稿,然后再进入下一阶段,保存在 `specs/spec_name/requirements.md` 中,参考格式如下
19+
20+
```markdown
21+
# 需求文档
22+
23+
## 介绍
24+
25+
需求描述
26+
27+
## 需求
28+
29+
### 需求 1 - 需求名称
30+
31+
**用户故事:** 用户故事内容
32+
33+
#### 验收标准
34+
35+
1. 采用 ERAS 描述的子句 While <可选前置条件>, when <可选触发器>, the <系统名称> shall <系统响应>,例如 When 选择"静音"时,笔记本电脑应当抑制所有音频输出。
36+
2. ...
37+
...
38+
```
39+
40+
### 4. 技术方案设计
41+
在完成需求的设计之后,你会根据当前的技术架构和前面确认好的需求,进行需求的技术方案设计,精简但是能够准确的描述技术的架构(例如架构、技术栈、技术选型、数据库/接口设计、测试策略、安全性),必要时可以用 mermaid 来绘图,必须跟我确认清楚后,保存在 `specs/spec_name/design.md` 中,然后再进入下一阶段
42+
43+
### 5. 任务拆分
44+
在完成技术方案设计后,你会根据需求文档和技术方案,细化具体要做的事情,必须跟我确认清楚后,保存在`specs/spec_name/tasks.md` 中, 然后再进入下一阶段,开始正式执行任务,同时需要及时更新任务的状态,执行的时候尽可能独立自主运行,保证效率和质量
45+
46+
任务参考格式如下
47+
48+
```markdown
49+
# 实施计划
50+
51+
- [ ] 1. 任务信息
52+
- 具体要做的事情
53+
- ...
54+
- _需求: 相关的需求点的编号
55+
```
56+
57+
## 适用场景
58+
- 新功能开发
59+
- 复杂架构设计
60+
- 多模块集成
61+
- 涉及数据库/UI设计
62+
- 需要详细规划和文档的项目

config/.claude/settings.local.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"enabledMcpjsonServers": [
3+
"cloudbase"
4+
],
5+
"enableAllProjectMcpServers": true
6+
}

mcp/src/cli.ts

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,16 +57,20 @@ const isTestEnvironment = process.env.NODE_ENV === 'test' || process.env.VITEST
5757
const enableTelemetry = !isTestEnvironment;
5858

5959
// Parse command line arguments
60-
const { cloudMode, ide } = parseCommandLineArgs();
60+
let { cloudMode, ide } = parseCommandLineArgs();
6161

6262
// Log startup information
6363
if (cloudMode) {
6464
info("Starting CloudBase MCP Server in cloud mode");
6565
}
66+
67+
ide = ide || process.env.INTEGRATION_IDE;
68+
6669
if (ide) {
6770
info(`Integration IDE: ${ide}`);
6871
}
6972

73+
7074
// Create server instance with conditional telemetry and CLI options
7175
const server = createCloudBaseMcpServer({
7276
name: "cloudbase-mcp",

mcp/src/server.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,7 +124,7 @@ export function createCloudBaseMcpServer(options?: {
124124
}, {
125125
capabilities: {
126126
tools: {},
127-
logging: {},
127+
...(ide === 'CodeBuddy' ? { logging: {}}: {})
128128
},
129129
}) as ExtendedMcpServer;
130130

mcp/src/tools/setup.ts

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,11 @@ const IDE_FILE_MAPPINGS: Record<string, string[]> = {
8181
],
8282
"claude-code": [
8383
"CLAUDE.md",
84-
".mcp.json"
84+
".mcp.json",
85+
".claude/settings.local.json",
86+
".claude/commands/prototype.md",
87+
".claude/commands/spec.md",
88+
".claude/commands/no_spec.md",
8589
],
8690
"cline": [
8791
".clinerules/cloudbase-rules.mdc"

0 commit comments

Comments
 (0)