158 lines
4.7 KiB
Markdown
Executable File
158 lines
4.7 KiB
Markdown
Executable File
# 概述
|
||
|
||
本文档用于描述待定内容的规范模板
|
||
|
||
# 格式要求
|
||
|
||
## 基本规范
|
||
1. **评分制**：使用-100到100的分数评分，分数应反映方案的综合价值
|
||
2. **独立决策**：每个待定项必须能够独立决策，采纳或去除
|
||
3. **方案分离**：同一问题的不同解决方案必须分别创建不同的方案编号
|
||
4. **排序规则**：同一待定项内的方案按评分从低到高排序，最高分方案放在最后
|
||
5. **具体描述**：优化方案中直接描述具体内容，避免抽象的可能性列举
|
||
6. **权衡透明**：每个方案必须明确列出优势和风险的具体分数
|
||
|
||
## 编号规范
|
||
- 格式：`U<待定项编号>S<方案编号>`
|
||
- **待定项编号**：使用U前缀（如U001、U002、U003），不同的问题使用不同的编号，可以独立决策互不冲突
|
||
- **方案编号**：使用S前缀（如S001、S002、S003），同一问题的不同解决方案使用不同的方案编号，用户只能从中选择一个
|
||
- 示例：
|
||
- **待定项U001**（表述优化问题）：`U001S001`、`U001S002`、`U001S003` - 用户只能选择其中一个方案
|
||
- **待定项U002**（功能范围问题）：`U002S001`、`U002S002`、`U002S003` - 用户只能选择其中一个方案
|
||
- 用户可以同时选择`U001S002`和`U002S003`，因为它们是不同待定项的方案
|
||
- 按评分从低到高排序，最高分的放在最后
|
||
|
||
# 模板
|
||
|
||
```
|
||
## 🔍 待定项U<编号> - <问题描述>
|
||
|
||
### ✅ 方案S<编号> - 【建议采纳 +<分数>分】
|
||
|
||
**📍 原文位置**：（<文件路径>，第<行数>行）
|
||
> 原文内容
|
||
|
||
**🎯 优化方案**：
|
||
> 具体的优化方案描述
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ✅ **优势**（+<分数>分）：……
|
||
- ✅ **优势**（+<分数>分）：……
|
||
- ❌ **风险**（-<分数>分）：……
|
||
|
||
---
|
||
```
|
||
|
||
或
|
||
|
||
```
|
||
## 🔍 待定项U<编号> - <问题描述>
|
||
|
||
### ❌ 方案S<编号> - 【建议去除 -<分数>分】
|
||
|
||
**📍 原文位置**：（<文件路径>，第<行数>行）
|
||
> 原文内容
|
||
|
||
**🎯 优化方案**：
|
||
> 具体的优化方案描述（如删除该内容或替换为其他内容）
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ❌ **问题**（-<分数>分）：……
|
||
- ✅ **潜在价值**（+<分数>分）：……
|
||
|
||
---
|
||
```
|
||
|
||
# 示例
|
||
|
||
> 假设当前工作目录在/path/to/workspace，有一个用于描述任务的文件是/path/to/workspace/ai-agent-memory/now-task.md。
|
||
>
|
||
> 然后对其进行分析和优化，将优化后需要询问用户的待定项写入到`undetermined.md`。
|
||
|
||
`undetermined.md`的内容应该类似下面所示：
|
||
|
||
```markdown
|
||
## 🔍 待定项U001 - 表述冗杂优化
|
||
|
||
### ✅ 方案S001 - 【建议采纳 +85分】
|
||
|
||
**📍 原文位置**：（tasks/task-1.md，第15-17行）
|
||
> （文内容第15行，含有目标原文的部分）
|
||
> （文内容第16行）
|
||
> （文内容第17行，含有目标原文的部分）
|
||
|
||
**🎯 优化方案**：
|
||
> 消除冗杂表述的具体优化方案
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ✅ **优势**（+60分）：消除冗杂，提高可读性
|
||
- ✅ **优势**（+30分）：表述更加简洁清晰
|
||
- ❌ **风险**（-5分）：可能丢失部分细节
|
||
|
||
---
|
||
|
||
## 🔍 待定项U002 - 路径接收方式
|
||
|
||
### ✅ 方案S001 - 【建议采纳 +60分】
|
||
|
||
**📍 原文位置**：（tasks/task-1.md，第20行）
|
||
> 接收路径参数
|
||
|
||
**🎯 优化方案**：
|
||
> 通过命令行参数接收路径
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ✅ **优势**（+70分）：实现简单，符合标准CLI工具惯例
|
||
- ❌ **风险**（-10分）：功能相对单一
|
||
|
||
---
|
||
|
||
### ✅ 方案S002 - 【建议采纳 +80分】
|
||
|
||
**📍 原文位置**：（tasks/task-1.md，第20行）
|
||
> 接收路径参数
|
||
|
||
**🎯 优化方案**：
|
||
> 支持通过命令行参数和Windows拖拽两种方式接收路径
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ✅ **优势**（+50分）：兼顾命令行和图形界面用户习惯
|
||
- ✅ **优势**（+40分）：与拖拽要求呼应
|
||
- ❌ **风险**（-10分）：实现复杂度适中
|
||
|
||
---
|
||
|
||
### ✅ 方案S003 - 【建议采纳 +90分】
|
||
|
||
**📍 原文位置**：（tasks/task-1.md，第20行）
|
||
> 接收路径参数
|
||
|
||
**🎯 优化方案**：
|
||
> 支持多种路径输入方式：命令行参数、Windows拖拽、交互式输入
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ✅ **优势**（+70分）：用户体验最佳，适应各种使用场景
|
||
- ✅ **优势**（+30分）：功能完整全面
|
||
- ❌ **风险**（-10分）：实现复杂度较高
|
||
|
||
---
|
||
|
||
## 🔍 待定项U003 - 冗余功能清理
|
||
|
||
### ❌ 方案S001 - 【建议去除 -30分】
|
||
|
||
**📍 原文位置**：（tasks/task-1.md，第25行）
|
||
> 某个冗余的功能描述
|
||
|
||
**🎯 优化方案**：
|
||
> 删除该冗余描述
|
||
|
||
**⚖️ 权衡分析**：
|
||
- ❌ **问题**（-40分）：功能冗余，增加复杂度
|
||
- ✅ **潜在价值**（+10分）：可能在某些场景下有用
|
||
|
||
---
|
||
|
||
(其他待定项略……)
|
||
```
|