✨ feat: 对decide的功能进行调整

aide-marketplace/aide-plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "aide-plugin",
   "description": "Aide 工作流体系插件，提供任务准备和执行的标准化流程",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "author": {
     "name": "Aide Team"
   },

aide-marketplace/aide-plugin/commands/exec.md

@@ -14,6 +14,14 @@ argument-hint: [任务细则文档路径]
 
 ---
 
+## 前置准备
+
+**首先触发 `aide` skill 学习 aide 命令的使用方法。**
+
+这是必要步骤，确保你了解 `aide flow` 等命令的正确用法。
+
+---
+
 ## 开始
 
 ### 确定任务细则

aide-marketplace/aide-plugin/commands/init.md

@@ -7,6 +7,22 @@ argument-hint: [无参数]
 
 你正在使用 Aide 工作流体系。本命令帮助你快速认知项目并确保环境就绪。
 
+---
+
+## 核心约束（必须遵守）
+
+**禁止直接读取或编辑 `.aide/` 目录下的任何文件！**
+
+- ❌ 禁止使用 Read 工具读取 `.aide/config.toml`
+- ❌ 禁止使用 Edit/Write 工具修改 `.aide/` 下的文件
+- ✅ 必须通过 `aide config get/set` 读写配置
+- ✅ 必须通过 `aide env set` 修改环境配置
+- ✅ 配置有误时，触发 `env-config` skill 学习正确的设置方法
+
+**原因**：`.aide/` 是 aide 程序的内部数据目录，直接操作可能导致格式错误或状态不一致。
+
+---
+
 ## 执行步骤
 
 ### 1. Aide 运行时环境检测
@@ -31,7 +47,7 @@ aide init
 
 此命令会：
 - 创建 `.aide/` 目录（如不存在）
-- 生成默认配置文件 `.aide/config.toml`
+- 生成默认配置文件
 - 检查并更新 `.gitignore`
 
 ### 3. 项目认知
@@ -51,40 +67,40 @@ aide init
 aide env ensure
 ```
 
-此命令会：
-- 读取 `.aide/config.toml` 中的环境配置
-- 检测并修复项目开发环境
-- 输出环境状态和配置信息
-
 根据输出处理：
-- `✓`：环境就绪，继续到步骤 5
-- `⚠`：有警告但可继续，记录并继续
-- `✗`：**触发 `env-config` skill**，按指导完成配置后重试
+- `✓`：环境就绪，**直接进入步骤 5**（不要再查看配置文件）
+- `⚠`：有警告但可继续，记录警告信息并继续
+- `✗`：**触发 `env-config` skill**，学习如何使用 `aide env set` 命令修复配置，然后重试
 
-**注意**：
-- 此时不带 `--runtime` 参数，会读取项目配置文件检查项目环境
-- aide env 会输出项目配置信息，包括默认的任务文档路径，记住这些信息供后续使用
+**环境检测失败时的正确做法**：
+1. 触发 `env-config` skill 获取配置指导
+2. 使用 `aide env set <模块>.<配置项> <值>` 修改配置
+3. 重新执行 `aide env ensure` 验证
+
+**错误做法**（禁止）：
+- 直接编辑 `.aide/config.toml` 文件
 
 ### 5. 汇报就绪状态
 
-向用户汇报：
+环境检测通过后，直接向用户汇报（不要再读取配置文件）：
 
 ```
 项目概况：[来自步骤3的概要]
 
-环境状态：✓ 环境就绪 (python:3.12, ...)
-
-项目配置：
-- 任务原文档：task-now.md
-- 任务细则：task-spec.md
+环境状态：[aide env ensure 的输出结果]
 
 Aide 已就绪，可用命令：
 - /aide:prep [文档路径] - 任务准备
 - /aide:exec [文档路径] - 任务执行
 ```
 
+> 注：任务文档路径等配置信息已在 aide env ensure 输出中显示，无需额外查看配置文件。
+
+---
+
 ## 注意事项
 
-1. 如果在初始化过程中发现严重环境问题无法解决，建议用户修复后重开对话
-2. 本命令只做认知和环境准备，不修改任何业务代码
-3. 所有输出使用简体中文
+1. **不要读取 `.aide/` 目录下的文件**——所有配置操作通过 aide 命令完成
+2. 如果在初始化过程中发现严重环境问题无法解决，建议用户修复后重开对话
+3. 本命令只做认知和环境准备，不修改任何业务代码
+4. 所有输出使用简体中文

aide-marketplace/aide-plugin/commands/prep.md

@@ -14,6 +14,14 @@ argument-hint: [任务原文档路径]
 
 ---
 
+## 前置准备
+
+**首先触发 `aide` skill 学习 aide 命令的使用方法。**
+
+这是必要步骤，确保你了解 `aide flow` 等命令的正确用法。
+
+---
+
 ## 开始
 
 ### 启动流程追踪
@@ -95,15 +103,15 @@ aide flow next-step "任务优化完成，生成待定项"
 
 ### 有待定项时
 
-提交待定项数据：
+1. 将待定项数据写入 JSON 文件（如 `.aide/pending-items.json`）
+2. 提交待定项数据：
 
 ```bash
-aide decide submit '<json数据>'
+aide decide submit .aide/pending-items.json
 ```
 
-告知用户访问链接进行确认。
-
-用户完成后获取结果：
+3. 告知用户访问输出的链接进行确认
+4. 用户完成后获取结果：
 
 ```bash
 aide decide result

aide-marketplace/aide-plugin/skills/aide/SKILL.md

@@ -208,25 +208,31 @@ aide flow 会自动校验环节跳转是否合理：
 
 ## aide decide - 待定项确认
 
-通过 Web 界面处理待定项确认。
+通过 Web 界面处理待定项确认。服务在后台运行，用户完成决策后自动关闭。
 
 ```
 aide decide {submit,result} ...
 
 子命令:
-  submit <json>  提交待定项数据并启动 Web 服务
+  submit <file>  从文件读取待定项数据，启动后台 Web 服务
   result         获取用户决策结果
 ```
 
 ### aide decide submit
 
-提交待定项数据并启动 Web 服务。
+从 JSON 文件读取待定项数据，启动后台 Web 服务，立即返回。
 
 ```bash
-aide decide submit '<json数据>'
+aide decide submit <json文件路径>
 ```
 
-**JSON 格式**：
+**使用流程**：
+1. 将待定项数据写入 JSON 文件
+2. 执行 `aide decide submit <文件路径>` 启动服务
+3. 告知用户访问 Web 界面进行决策
+4. 用户完成后执行 `aide decide result` 获取结果
+
+**JSON 文件格式**：
 ```json
 {
   "task": "任务简述",
@@ -267,7 +273,7 @@ aide decide submit '<json数据>'
 
 | 配置项 | 默认值 | 说明 |
 |--------|--------|------|
-| `port` | 3721 | 起始端口 |
+| `port` | 3721 | 起始端口（自动探测可用端口） |
 | `bind` | `"127.0.0.1"` | 监听地址，设为 `"0.0.0.0"` 可允许外部访问 |
 | `url` | `""` | 自定义访问地址，为空时自动生成 |
 | `timeout` | 0 | 超时时间（秒），0 表示不超时 |
@@ -276,10 +282,11 @@ aide decide submit '<json数据>'
 ```
 → Web 服务已启动
 → 请访问: http://localhost:3721
-→ 等待用户完成决策...
-✓ 决策已完成
+→ 用户完成决策后执行 aide decide result 获取结果
 ```
 
+> 注：服务在后台运行，命令立即返回。用户提交决策后服务自动关闭。
+
 ### aide decide result
 
 获取用户决策结果。
@@ -298,6 +305,10 @@ aide decide result
 }
 ```
 
+**错误情况**：
+- 尚无决策结果（服务运行中）：提示等待用户完成操作
+- 尚无决策结果（服务已关闭）：提示重新执行 submit
+
 > 注：`note` 字段仅在用户添加备注时出现
 > 注：如果数据中有 `recommend` 字段，对应选项会默认选中