[aide] finish: 任务完成

新增环境安装 Commands:
- /aide:install-win - Windows 环境安装命令
- /aide:install-linux - Linux 环境安装命令

新增离线安装程序:
- aide-program/offline-installer/windows/
- aide-program/offline-installer/linux/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2025-12-17 05:22:38 +08:00
parent bd723629c5
commit ba70fafa15
23 changed files with 3610 additions and 376 deletions

View File

@@ -1,203 +1,94 @@
{
"task": "Aide 工具 Git 分支管理和任务细则强制确认功能",
"task": "创建环境安装 Command",
"source": "task-now.md",
"items": [
{
"id": 1,
"title": "分支命名规则",
"title": "离线安装程序是否需要实现?",
"location": {
"file": "task-now.md",
"start": 15,
"end": 16
"start": 17,
"end": 21
},
"context": "用户希望在任务开始时创建新分支,需要确定分支命名规则。分支名将用于区分不同任务的工作内容。",
"context": "任务文档中询问是否可以实现离线安装方案:先提供资源清单,用户下载资源后通过程序完成安装。这是一个独立的功能模块,与 Command 是两种不同的实现方式。",
"options": [
{
"value": "aide_taskid",
"label": "aide/<task_id>",
"score": 90,
"pros": ["与 task_id 直接关联,易于追溯", "格式规范,避免冲突", "示例aide/2025-12-17T10-30-00"],
"cons": ["分支名较长"]
"value": "defer",
"label": "暂不实现,作为后续迭代",
"score": 85,
"pros": ["聚焦核心需求", "减少本次工作量", "可以先验证 Command 方案的有效性"],
"cons": ["无法处理完全无网络的环境"]
},
{
"value": "task_taskid",
"label": "task/<task_id>",
"score": 75,
"pros": ["简洁明了", "与任务概念直接对应"],
"cons": ["可能与其他工具的分支命名冲突"]
"value": "implement",
"label": "本次一并实现离线安装程序",
"score": 60,
"pros": ["一次性完整覆盖所有场景", "支持企业内网环境"],
"cons": ["工作量大", "维护成本高", "需要处理多平台二进制分发"]
},
{
"value": "custom_prefix",
"label": "可配置前缀",
"value": "resource_list_only",
"label": "仅提供资源清单和手动指南",
"score": 70,
"pros": ["灵活性高,用户可自定义"],
"cons": ["增加配置复杂度"]
"pros": ["折中方案", "用户可自行下载"],
"cons": ["离线体验不完整", "用户需手动操作较多"]
}
],
"recommend": "aide_taskid"
"recommend": "defer"
},
{
"id": 2,
"title": "分支概况文档格式",
"title": "是否需要支持 macOS",
"location": {
"file": "task-now.md",
"start": 11,
"end": 12
"start": 5,
"end": 5
},
"context": "需要维护一份记录 git 分支概况的文档,存储分支名、起始提交、源分支、结束提交等信息。需确定文档格式。",
"context": "任务文档明确提到需要为 Windows 和 Linux 创建专用 command但未提及 macOS。macOS 在开发者群体中使用广泛,需要确认是否纳入本次实现范围。",
"options": [
{
"value": "json",
"label": "JSON 格式 (.aide/branches.json)",
"score": 85,
"pros": ["结构化数据,易于程序处理", "可精确存储多条记录", "与现有 flow-status.json 风格一致"],
"cons": ["人工阅读不够直观"]
"value": "no_macos",
"label": "仅支持 Windows 和 Linux",
"score": 75,
"pros": ["严格按任务要求", "减少工作量"],
"cons": ["macOS 用户无法使用"]
},
{
"value": "markdown",
"label": "Markdown 格式 (.aide/branches.md)",
"score": 70,
"pros": ["人工阅读友好", "可直接在编辑器中查看"],
"cons": ["解析复杂,数据提取不便"]
"value": "include_macos",
"label": "增加 macOS 支持",
"score": 80,
"pros": ["覆盖主流开发平台", "macOS 与 Linux 安装方式相似"],
"cons": ["增加一定工作量", "需要测试验证"]
}
],
"recommend": "json"
"recommend": "include_macos"
},
{
"id": 3,
"title": "合并冲突处理策略",
"title": "Command 命名和组织方式",
"location": {
"file": "task-now.md",
"start": 18,
"end": 21
"start": 5,
"end": 5
},
"context": "任务结束时需要将任务分支合并回原分支。如果原分支在任务期间有其他提交,可能产生合并冲突。需确定处理策略。",
"context": "任务提到「为 Windows 和 Linux 单独创建专用的完整 command」这可以理解为两种组织方式统一命令自动检测系统或分离命令让用户选择。",
"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 命令",
"value": "unified",
"label": "/aide:install统一命令自动检测系统",
"score": 90,
"pros": ["提供标准化的清理方式", "可选择保留或删除分支"],
"cons": ["需要额外开发"]
"pros": ["用户体验统一", "自动适配系统", "一个命令解决问题"],
"cons": ["Command 文件会较长"]
},
{
"value": "auto_cleanup",
"label": "下次 start 时自动清理",
"score": 60,
"pros": ["无需用户干预"],
"cons": ["可能意外删除有价值的工作"]
"value": "separated",
"label": "/aide:install-win 和 /aide:install-linux分离命令",
"score": 65,
"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"
"recommend": "unified"
}
]
}