247 lines
8.2 KiB
Markdown
247 lines
8.2 KiB
Markdown
|
||
一、确认我的理解
|
||
|
||
| 你的需求 | 我的理解 |
|
||
|-----------|--------------------------------------------------------------------------------------------|
|
||
| cmd1 | 进度追踪 + 状态记录 + git自动提交 + 流程校验 + 环节特定行为（PlantUML检查、CHANGELOG检查） |
|
||
| cmd2 | 待定项Web界面，Python后端 + 静态React，输入JSON输出JSON|
|
||
| aide:init | 项目认知 + 环境检测修复，保留|
|
||
| aide-env | 仅保留ensure（检测+修复），删check|
|
||
| 配置机制 | 自文档化配置文件，LLM通过aide读取，不直接读文件 |
|
||
| 错误恢复 | ⚠自动判断是否阻塞，✗必须解决（3次失败则停止） |
|
||
|
||
二、命名建议
|
||
|
||
cmd1（进度追踪+状态+git+流程校验）
|
||
|
||
| 候选名 | 分析 |
|
||
|------------|--------------------------------------------|
|
||
| aide track | ✓ 简短，"追踪"准确描述核心功能 |
|
||
| aide flow | ✓ "流程"也贴切，但偏向流程定义而非执行追踪 |
|
||
| aide step | △ 太聚焦步骤，忽略git和流程校验 |
|
||
| aide log | ✗ 易与日志混淆 |
|
||
|
||
推荐：aide track
|
||
|
||
cmd2（待定项Web界面）
|
||
|
||
| 候选名 | 分析 |
|
||
|--------------|--------------------------|
|
||
| aide decide | ✓ "决定"准确描述用户行为 |
|
||
| aide ask | ✓ 最短，"询问"也可以 |
|
||
| aide confirm | △ 语义准确但略长 |
|
||
| aide review | △ 偏"审阅"而非"决定" |
|
||
|
||
推荐：aide ask（最短）或 aide decide（更精确）
|
||
|
||
---
|
||
三、待定项演示
|
||
|
||
基于 now-task-example.md（Rust TUI 贪吃蛇），按原体系分析产出待定项：
|
||
|
||
原版待定项文档格式
|
||
|
||
## 🔍 待定项U001 - TUI框架选择
|
||
|
||
用户未指定使用哪个Rust TUI库。
|
||
|
||
### ✅ 方案S001 - 【建议采纳 +70分】
|
||
|
||
**🎯 优化方案**：使用 crossterm（底层库）
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ✅ **优势**（+50分）：控制细腻，符合"直接修改字符坐标"需求
|
||
- ✅ **优势**（+30分）：无刷屏，原生支持alternate screen
|
||
- ❌ **风险**（-10分）：需要更多样板代码
|
||
|
||
---
|
||
|
||
### ✅ 方案S002 - 【建议采纳 +85分】
|
||
|
||
**🎯 优化方案**：使用 ratatui + crossterm backend
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ✅ **优势**（+60分）：高层抽象，开发效率高
|
||
- ✅ **优势**（+35分）：内置布局系统，适配终端大小方便
|
||
- ❌ **风险**（-10分）：抽象层可能隐藏部分底层控制
|
||
|
||
---
|
||
|
||
## 🔍 待定项U002 - 难度递增机制
|
||
|
||
"难度递增速度"具体指什么？
|
||
|
||
### ✅ 方案S001 - 【+60分】
|
||
**🎯 优化方案**：仅蛇移动速度递增
|
||
|
||
### ✅ 方案S002 - 【+75分】
|
||
**🎯 优化方案**：速度递增 + 食物刷新间隔递减
|
||
|
||
### ✅ 方案S003 - 【建议采纳 +90分】
|
||
**🎯 优化方案**：综合机制（速度+食物间隔+可选障碍物）
|
||
|
||
---
|
||
|
||
## 🔍 待定项U003 - 存档格式
|
||
|
||
### ✅ 方案S001 - 【建议采纳 +80分】
|
||
**🎯 优化方案**：JSON格式
|
||
- ✅ 人类可读，调试友好
|
||
- ❌ 体积略大
|
||
|
||
### ✅ 方案S002 - 【+70分】
|
||
**🎯 优化方案**：TOML格式
|
||
- ✅ Rust生态常用
|
||
- ❌ 嵌套结构表达不如JSON
|
||
|
||
---
|
||
|
||
## 🔍 待定项U004 - 终端过小处理策略
|
||
|
||
当终端窗口小于游戏最小尺寸时如何处理？
|
||
|
||
### ✅ 方案S001 - 【建议采纳 +85分】
|
||
**🎯 优化方案**：显示警告提示，暂停游戏直到窗口扩大
|
||
|
||
### ✅ 方案S002 - 【+60分】
|
||
**🎯 优化方案**：自动缩放游戏区域（可能影响体验）
|
||
|
||
---
|
||
|
||
## 🔍 待定项U005 - 玩家名长度
|
||
|
||
### ✅ 方案S001 - 【+50分】
|
||
**🎯 优化方案**：不限制
|
||
|
||
### ✅ 方案S002 - 【建议采纳 +80分】
|
||
**🎯 优化方案**：限制12字符（显示友好，足够表达）
|
||
|
||
---
|
||
精简JSON格式（LLM → 程序）
|
||
|
||
```
|
||
{
|
||
"task": "Rust TUI 贪吃蛇游戏",
|
||
"items": [
|
||
{
|
||
"id": "U001",
|
||
"title": "TUI框架选择",
|
||
"context": "用户未指定Rust TUI库",
|
||
"options": [
|
||
{
|
||
"value": "crossterm",
|
||
"label": "crossterm（底层库）",
|
||
"score": 70,
|
||
"pros": ["控制细腻", "无刷屏"],
|
||
"cons": ["样板代码多"]
|
||
},
|
||
{
|
||
"value": "ratatui",
|
||
"label": "ratatui + crossterm",
|
||
"score": 85,
|
||
"pros": ["开发效率高", "内置布局"],
|
||
"cons": ["抽象层"]
|
||
}
|
||
],
|
||
"recommend": "ratatui"
|
||
},
|
||
{
|
||
"id": "U002",
|
||
"title": "难度递增机制",
|
||
"context": "\"难度递增速度\"具体指什么？",
|
||
"options": [
|
||
{"value": "speed_only", "label": "仅速度递增", "score": 60},
|
||
{"value": "speed_food", "label": "速度+食物间隔", "score": 75},
|
||
{"value": "comprehensive", "label": "综合（速度+食物+障碍物）", "score": 90}
|
||
],
|
||
"recommend": "comprehensive"
|
||
},
|
||
{
|
||
"id": "U003",
|
||
"title": "存档格式",
|
||
"options": [
|
||
{"value": "json", "label": "JSON", "score": 80, "pros": ["可读", "调试友好"]},
|
||
{"value": "toml", "label": "TOML", "score": 70, "pros": ["Rust生态常用"]}
|
||
],
|
||
"recommend": "json"
|
||
},
|
||
{
|
||
"id": "U004",
|
||
"title": "终端过小处理",
|
||
"context": "终端窗口小于最小尺寸时",
|
||
"options": [
|
||
{"value": "warn_pause", "label": "警告并暂停", "score": 85},
|
||
{"value": "auto_scale", "label": "自动缩放", "score": 60}
|
||
],
|
||
"recommend": "warn_pause"
|
||
},
|
||
{
|
||
"id": "U005",
|
||
"title": "玩家名长度限制",
|
||
"options": [
|
||
{"value": "unlimited", "label": "不限制", "score": 50},
|
||
{"value": "12", "label": "限制12字符", "score": 80}
|
||
],
|
||
"recommend": "12"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
用户决策输出格式（程序 → LLM）
|
||
|
||
```
|
||
{
|
||
"decisions": [
|
||
{"id": "U001", "chosen": "ratatui"},
|
||
{"id": "U002", "chosen": "speed_food", "note": "用户备注：暂不加障碍物"},
|
||
{"id": "U003", "chosen": "json"},
|
||
{"id": "U004", "chosen": "warn_pause"},
|
||
{"id": "U005", "chosen": "12"}
|
||
]
|
||
}
|
||
```
|
||
|
||
---
|
||
四、简化后的系统架构确认
|
||
```
|
||
aide-marketplace/ # 插件市场目录
|
||
├── .claude-plugin/
|
||
│ └── marketplace.json
|
||
└── aide-plugin/
|
||
├── .claude-plugin/
|
||
│ └── plugin.json
|
||
├── commands/
|
||
│ ├── init.md # 项目认知+环境检测
|
||
│ ├── prep.md # A流程：任务准备
|
||
│ └── exec.md # B流程：任务执行
|
||
└── skills/
|
||
└── aide/
|
||
└── SKILL.md # aide程序使用说明
|
||
|
||
aide/ # 程序目录
|
||
├── aide.sh # Linux/Mac 入口
|
||
├── aide.bat # Windows 入口
|
||
├── main.py # Python 主入口
|
||
├── core/
|
||
│ ├── config.py # 配置读写（不暴露文件内容）
|
||
│ └── output.py # 输出格式（✓/⚠/✗）
|
||
├── track/ # cmd1: aide track
|
||
│ ├── tracker.py # 进度追踪
|
||
│ ├── git.py # git自动提交
|
||
│ └── validator.py # 流程校验+环节特定检查
|
||
├── ask/ # cmd2: aide ask
|
||
│ ├── server.py # HTTP服务
|
||
│ └── web/ # 静态React前端
|
||
└── env/
|
||
└── ensure.py # 环境检测+修复
|
||
```
|
||
|
||
---
|
||
五、需要你确认
|
||
|
||
1. 命名：aide track 和 aide ask 这两个名字可以吗？
|
||
2. JSON格式：上面的输入/输出格式是否满足需求？需要调整吗？
|
||
3. 待定项数量：贪吃蛇示例我提取了5个待定项，这个粒度合适吗？
|
||
4. 下一步：你想先讨论哪个部分的实现细节？ |