204 lines
6.6 KiB
JSON
204 lines
6.6 KiB
JSON
{
|
||
"task": "Aide 工具 Git 分支管理和任务细则强制确认功能",
|
||
"source": "task-now.md",
|
||
"items": [
|
||
{
|
||
"id": 1,
|
||
"title": "分支命名规则",
|
||
"location": {
|
||
"file": "task-now.md",
|
||
"start": 15,
|
||
"end": 16
|
||
},
|
||
"context": "用户希望在任务开始时创建新分支，需要确定分支命名规则。分支名将用于区分不同任务的工作内容。",
|
||
"options": [
|
||
{
|
||
"value": "aide_taskid",
|
||
"label": "aide/<task_id>",
|
||
"score": 90,
|
||
"pros": ["与 task_id 直接关联，易于追溯", "格式规范，避免冲突", "示例：aide/2025-12-17T10-30-00"],
|
||
"cons": ["分支名较长"]
|
||
},
|
||
{
|
||
"value": "task_taskid",
|
||
"label": "task/<task_id>",
|
||
"score": 75,
|
||
"pros": ["简洁明了", "与任务概念直接对应"],
|
||
"cons": ["可能与其他工具的分支命名冲突"]
|
||
},
|
||
{
|
||
"value": "custom_prefix",
|
||
"label": "可配置前缀",
|
||
"score": 70,
|
||
"pros": ["灵活性高，用户可自定义"],
|
||
"cons": ["增加配置复杂度"]
|
||
}
|
||
],
|
||
"recommend": "aide_taskid"
|
||
},
|
||
{
|
||
"id": 2,
|
||
"title": "分支概况文档格式",
|
||
"location": {
|
||
"file": "task-now.md",
|
||
"start": 11,
|
||
"end": 12
|
||
},
|
||
"context": "需要维护一份记录 git 分支概况的文档，存储分支名、起始提交、源分支、结束提交等信息。需确定文档格式。",
|
||
"options": [
|
||
{
|
||
"value": "json",
|
||
"label": "JSON 格式 (.aide/branches.json)",
|
||
"score": 85,
|
||
"pros": ["结构化数据，易于程序处理", "可精确存储多条记录", "与现有 flow-status.json 风格一致"],
|
||
"cons": ["人工阅读不够直观"]
|
||
},
|
||
{
|
||
"value": "markdown",
|
||
"label": "Markdown 格式 (.aide/branches.md)",
|
||
"score": 70,
|
||
"pros": ["人工阅读友好", "可直接在编辑器中查看"],
|
||
"cons": ["解析复杂，数据提取不便"]
|
||
}
|
||
],
|
||
"recommend": "json"
|
||
},
|
||
{
|
||
"id": 3,
|
||
"title": "合并冲突处理策略",
|
||
"location": {
|
||
"file": "task-now.md",
|
||
"start": 18,
|
||
"end": 21
|
||
},
|
||
"context": "任务结束时需要将任务分支合并回原分支。如果原分支在任务期间有其他提交，可能产生合并冲突。需确定处理策略。",
|
||
"options": [
|
||
{
|
||
"value": "abort_warning",
|
||
"label": "检测冲突时中止并警告",
|
||
"score": 85,
|
||
"pros": ["安全，不会意外覆盖代码", "用户有完全控制权"],
|
||
"cons": ["需要用户手动解决"]
|
||
},
|
||
{
|
||
"value": "squash_merge",
|
||
"label": "使用 squash 合并（避免大部分冲突）",
|
||
"score": 75,
|
||
"pros": ["减少冲突可能性", "生成单一提交"],
|
||
"cons": ["某些场景仍可能冲突"]
|
||
},
|
||
{
|
||
"value": "force_override",
|
||
"label": "强制覆盖（任务分支优先）",
|
||
"score": 40,
|
||
"pros": ["总能完成合并"],
|
||
"cons": ["可能丢失原分支的其他更改", "风险较高"]
|
||
}
|
||
],
|
||
"recommend": "abort_warning"
|
||
},
|
||
{
|
||
"id": 4,
|
||
"title": "任务中断恢复策略",
|
||
"location": {
|
||
"file": "task-now.md",
|
||
"start": 21,
|
||
"end": 21
|
||
},
|
||
"context": "如果任务在执行过程中被中断（非正常 finish），需要确定如何处理遗留的任务分支和状态。",
|
||
"options": [
|
||
{
|
||
"value": "manual_cleanup",
|
||
"label": "保留分支，用户手动处理",
|
||
"score": 80,
|
||
"pros": ["保留所有工作成果", "用户完全控制"],
|
||
"cons": ["可能积累废弃分支"]
|
||
},
|
||
{
|
||
"value": "abort_command",
|
||
"label": "提供 aide flow abort 命令",
|
||
"score": 90,
|
||
"pros": ["提供标准化的清理方式", "可选择保留或删除分支"],
|
||
"cons": ["需要额外开发"]
|
||
},
|
||
{
|
||
"value": "auto_cleanup",
|
||
"label": "下次 start 时自动清理",
|
||
"score": 60,
|
||
"pros": ["无需用户干预"],
|
||
"cons": ["可能意外删除有价值的工作"]
|
||
}
|
||
],
|
||
"recommend": "abort_command"
|
||
},
|
||
{
|
||
"id": 5,
|
||
"title": "任务细则确认机制",
|
||
"location": {
|
||
"file": "task-now.md",
|
||
"start": 30,
|
||
"end": 34
|
||
},
|
||
"context": "用户要求待定项处理和细则文档保存都必须经用户确认才能继续。需确定确认机制的实现方式。",
|
||
"options": [
|
||
{
|
||
"value": "ask_user_question",
|
||
"label": "使用 AskUserQuestion 工具",
|
||
"score": 85,
|
||
"pros": ["利用现有工具，无需改 aide 代码", "交互式确认，体验好"],
|
||
"cons": ["依赖 LLM 遵守流程"]
|
||
},
|
||
{
|
||
"value": "aide_decide",
|
||
"label": "使用 aide decide 提交确认",
|
||
"score": 75,
|
||
"pros": ["复用现有工具", "有 Web 界面"],
|
||
"cons": ["流程较重，适合复杂决策"]
|
||
},
|
||
{
|
||
"value": "aide_confirm",
|
||
"label": "新增 aide confirm 命令",
|
||
"score": 70,
|
||
"pros": ["专用命令，语义清晰", "可程序化强制"],
|
||
"cons": ["需要额外开发 aide 代码"]
|
||
}
|
||
],
|
||
"recommend": "ask_user_question"
|
||
},
|
||
{
|
||
"id": 6,
|
||
"title": "任务细则文档存储位置",
|
||
"location": {
|
||
"file": "task-now.md",
|
||
"start": 32,
|
||
"end": 32
|
||
},
|
||
"context": "任务分析优化后需要生成并保存任务细则文档。需确定文档存储位置。",
|
||
"options": [
|
||
{
|
||
"value": "aide_task_spec",
|
||
"label": ".aide/task-spec.md",
|
||
"score": 85,
|
||
"pros": ["与 .aide 目录结构一致", "每次任务覆盖，保持简洁"],
|
||
"cons": ["历史细则不保留"]
|
||
},
|
||
{
|
||
"value": "aide_specs_dir",
|
||
"label": ".aide/specs/<task_id>.md",
|
||
"score": 80,
|
||
"pros": ["保留历史细则", "可追溯"],
|
||
"cons": ["可能积累大量文件"]
|
||
},
|
||
{
|
||
"value": "configurable",
|
||
"label": "可配置路径（默认 task.spec）",
|
||
"score": 90,
|
||
"pros": ["灵活性高", "用户可自定义"],
|
||
"cons": ["增加配置项"]
|
||
}
|
||
],
|
||
"recommend": "configurable"
|
||
}
|
||
]
|
||
}
|