[aide] task-optimize: 开始任务准备: 优化 docs.md 命令实现完整深度探索

.aide/project-docs/blocks/aide-plugin-skills.md

@@ -1,70 +1,98 @@
 # aide-plugin-skills
 
 > 路径：aide-marketplace/aide-plugin/skills/
-> 最后更新：2025-12-16
+> 最后更新：2025-12-17
 
 ## 概述
 
-Aide 插件的技能定义，提供专门知识供 LLM 按需学习。
+Aide 插件的技能定义。每个技能是一个独立目录，包含 SKILL.md 文件作为技能知识库。技能通过 Skill 工具触发，为 LLM 提供专业领域的知识和指导。
+
+## 目录结构
+
+```
+aide-marketplace/aide-plugin/skills/
+├── aide/
+│   └── SKILL.md             Aide 命令使用指南
+├── env-config/
+│   └── SKILL.md             环境配置详细指南
+└── task-parser/
+    └── SKILL.md             口语化内容解析指南
+```
 
 ## 文件清单
 
-| 目录 | 说明 |
-|------|------|
-| `aide/SKILL.md` | aide 基础命令指南（始终加载） |
-| `env-config/SKILL.md` | 环境配置详细指南（按需触发） |
-| `task-parser/SKILL.md` | 口语化任务内容解析（按需触发） |
+| 文件 | 类型 | 说明 |
+|------|------|------|
+| aide/SKILL.md | 技能 | Aide CLI 工具完整使用指南 |
+| env-config/SKILL.md | 技能 | 环境配置和故障排除指南 |
+| task-parser/SKILL.md | 技能 | 口语化任务内容解析方法 |
 
-## 技能说明
+## 技能详解
 
-### aide skill
+### aide - Aide 工具使用指南
 
-- **触发方式**：始终加载
-- **内容**：
-  - aide 命令行工具的完整使用指南
-  - 所有子命令的参数说明和示例
-  - 输出格式说明（✓/⚠/✗/→）
+- **触发描述**：Aide 工作流工具集。提供环境管理、进度追踪、待定项确认等功能。
+- **内容覆盖**：
+  - `aide env` - 环境管理命令
+  - `aide flow` - 进度追踪命令
+  - `aide decide` - 待定项确认命令
+  - `aide config` - 配置管理命令
+  - `aide init` - 初始化命令
   - 数据存储结构
   - 常见用法示例
 
-### env-config skill
+### env-config - 环境配置指南
 
-- **触发方式**：当 `aide env ensure` 失败时按需触发
-- **内容**：
-  - 环境模块详细配置方法
-  - 各模块的配置项说明
-  - 多项目场景处理
-  - 故障排除指南
+- **触发描述**：环境配置详细指南。由 `/aide:setup` 命令强制触发。
+- **触发条件**：当 `aide env ensure` 检测失败时
+- **内容覆盖**：
+  - 问题诊断（常见失败原因）
+  - 模块分类（类型A/类型B）
+  - 配置命令使用
+  - 项目类型配置示例
+  - 多项目场景处理（模块实例化命名）
+  - node_deps 模块详解
+  - 故障排除
 
-### task-parser skill
+### task-parser - 口语化内容解析器
 
-- **触发方式**：当任务文档或用户对话具有明显口语化特征时触发
-- **内容**：
-  - 口语化内容识别标准
-  - 语义解析方法（表层理解、深层提取、结构重组）
-  - 批判性分析（逻辑漏洞、盲点、过度设计）
-  - 建设性优化建议
-  - 上下文关联分析
-  - 规范化输出格式
+- **触发描述**：口语化任务内容解析器。当发现用户对话或任务文档具有明显口头语气时使用。
+- **触发条件**：内容具有口语化特征（模糊表述、松散结构、思维跳跃等）
+- **解析流程**：
+  1. 语义解析（表层理解、深层提取、结构重组）
+  2. 批判性分析（逻辑漏洞、盲点识别、过度设计识别）
+  3. 建设性优化（优化建议、方案对比、风险权衡）
+  4. 上下文关联分析（项目关联、隐含需求、复杂度预判）
 
-## 设计理念
+## 接口说明
 
-**Skill 拆分原则**：
-- `aide` skill：基础知识，始终需要
-- `env-config` skill：专门知识，仅在配置环境时需要
-- `task-parser` skill：专门知识，仅在解析口语化内容时需要
+### 技能文件格式
 
-这样设计的好处：
-1. 减少 LLM 上下文占用
-2. 按需加载专门知识
-3. 职责分离，便于维护
+每个 SKILL.md 文件包含 YAML 前置元数据：
+
+```yaml
+---
+name: 技能名称
+description: 技能描述（用于触发匹配）
+---
+
+# 技能内容
+...
+```
+
+### 技能触发方式
+
+技能通过 Skill 工具自动触发：
+- LLM 根据任务场景匹配合适的技能
+- 触发后技能内容作为上下文提供给 LLM
 
 ## 依赖关系
 
-- 被依赖：commands（setup, load, docs, run）
+- 被依赖：aide-plugin commands（命令中引用技能）
 
 ## 注意事项
 
-- Skill 文件是 Markdown 格式
-- 内容应聚焦于 LLM 执行任务所需的知识
-- 避免冗余，保持简洁
+- 技能文件使用 Markdown 格式，内容作为 LLM 知识库
+- YAML 前置元数据中的 description 用于技能匹配
+- 技能应专注于单一领域，提供完整但聚焦的指导
+- 技能之间可以相互引用（如 aide skill 引用 env-config skill）