概述

本文档用于描述待定内容的规范模板

格式要求

基本规范

评分制：使用-100到100的分数评分，分数应反映方案的综合价值
独立决策：每个待定项必须能够独立决策，采纳或去除
方案分离：同一问题的不同解决方案必须分别创建不同的方案编号
排序规则：同一待定项内的方案按评分从低到高排序，最高分方案放在最后
具体描述：优化方案中直接描述具体内容，避免抽象的可能性列举
权衡透明：每个方案必须明确列出优势和风险的具体分数

编号规范

格式：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的内容应该类似下面所示：

## 🔍 待定项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分）：可能在某些场景下有用

---

(其他待定项略……)

4.7 KiB Executable File Raw Blame History Unescape Escape

概述

格式要求

基本规范

编号规范

模板

示例

4.7 KiB

Executable File

Raw Blame History