🎉 init: 初始存档

ai-agent-memory/ai-agent-task-builder/undetermined-template.md

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