# 概述 本文档用于描述待定内容的规范模板 # 格式要求 ## 基本规范 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分):可能在某些场景下有用 --- (其他待定项略……) ```