AI 协同指令与输出规范

定义用户与 AI 之间的交互指令分类,以及 AI 针对不同指令的输出格式

一、用户指令分类(9 类)

# 类型 关键词 AI 输出重点
1 讨论需求 讨论、聊聊、怎么看、有什么方案 分析、建议、方案对比,不输出代码
2 完整输出版本包 输出 V1.x 完整包、打包所有文件 当前版本全部文件的完整代码
3 新增功能 增加、添加、实现 代码修改片段 + 测试案例 + 影响检查
4 修改现有 修改、修复、改一下、调整 修改前后对比 + 测试案例 + 影响检查
5 问题诊断 出错了、报错、不显示、控制台有红字 原因分析 + 排查步骤 + 修复方案
6 状态同步 进度、总结、到哪了、当前状态 已完成功能、待办事项、已知问题、版本号
7 生成测试案例 测试路线、测一下XX分支、验证 操作步骤 + 预期结果 + 验证点(不输出代码)
8 解释代码 解释、什么意思、这段代码干啥 通俗说明 + 关键逻辑
9 版本回滚 回滚、恢复到 回滚步骤或旧版本文件内容

二、AI 输出规范

2.1 讨论需求
## 需求理解
(复述用户问题)

## 分析与建议
- 方案一:……
- 方案二:……
- 推荐方案:……

## 待确认的问题
- ……
2.2 完整输出版本包
## 版本信息
- 版本号:V1.x
- 包含文件:index.html, style.css, game.js, config.json, story.json...

## 文件内容
### index.html
```html
...完整代码...
```

### story.json
```json
...完整代码...
```
2.3 新增功能 / 修改现有(统一格式)
## 功能理解
(…)

## 代码修改
**文件:xxx**
**节点/函数:xxx**
```json/js
// 修改后的代码片段
```

## 跨文本影响检查
- 影响节点:无 / 有(列出)
- 影响 flag:无 / 有(列出)
- 影响物品:无 / 有(列出)

## 测试案例
1. 步骤一 → 预期结果
2. 步骤二 → 预期结果
3. **验证点**:装备栏应显示 xxx,身份应为 xxx。

## 校验与回滚
- 测试前清除 localStorage。
- 若出现问题,请恢复备份文件:……
2.4 问题诊断
## 问题复述
(用户描述的现象)

## 可能原因
1. ……
2. ……
3. ……

## 排查步骤
1. 打开控制台,输入……
2. ……

## 修复方案
(输出具体的代码修改)
2.5 状态同步
## 当前项目状态
- **版本号**:V1.x
- **已完成功能**:……(列表)
- **待办事项**:……(列表)
- **已知问题**:……(列表)
2.6 生成测试案例
## 测试路线名称
(如:月亮路线)

## 操作步骤
1. 开局 → 选择「跟他走」
2. 选择「同意被打死」→「同意按 F9」
3. 选择「找朋友吐槽」

## 预期结果
- 装备栏:被骗时木剑 → 后变凝霜
- 结交:月亮
- 身份:月亮学徒

## 验证点
- 节点 `1a` 中 `[身份]` 被替换为"月亮学徒"
- 控制台无报错
2.7 / 2.8 / 2.9

解释代码:通俗说明 + 输入/输出 + 示例

版本回滚:目标版本 + 5步回滚流程(或提供旧版文件)

三、通用要求(涉及代码输出的指令)

四、指令速查表

用户说 AI 应进入模式
"讨论一下第二幕怎么设计"讨论需求
"输出 V1.9 完整包"完整输出版本包
"增加一个回城卷轴道具"新增功能
"修复装备栏不显示凝霜的 bug"修改现有
"出错了,控制台报错 xxx"问题诊断
"总结一下当前进度"状态同步
"给一个月亮路线的测试案例"生成测试案例
"解释一下 applyEffects 函数"解释代码
"回滚到上个稳定版本"版本回滚
本规范可与《开发规范》《修改规范》《跨 AI 接力规范》共同使用。