8.2 KiB
8.2 KiB
一、确认我的理解
| 你的需求 | 我的理解 |
|---|---|
| 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 # 环境检测+修复
五、需要你确认
- 命名：aide track 和 aide ask 这两个名字可以吗？
- JSON格式：上面的输入/输出格式是否满足需求？需要调整吗？
- 待定项数量：贪吃蛇示例我提取了5个待定项，这个粒度合适吗？
- 下一步：你想先讨论哪个部分的实现细节？