stigmergy 1.0.84 → 1.0.86

package/docs/PROJECT_REQUIREMENTS.md

@@ -0,0 +1,329 @@
+# AI CLI Universal Integration System
+## Requirements Specification (Unified and Clarified Version)
+
+**Project ID:** AI-CLI-UNIFIED-001
+**Version:** 2.0
+**Date:** 2025-01-22
+**Status:** Final
+
+---
+
+## 📋 Executive Summary
+
+### Project Vision
+实现一个综合性的AI CLI工具生态系统，支持**跨CLI直接调用**和**间接协作**双重功能，让用户能够在任意一个AI CLI环境中无缝调用其他AI CLI工具，同时支持基于项目背景的智能工具协作。
+
+### Problem Statement
+AI CLI工具用户面临两个核心问题：
+1. **工具孤岛** - 用户被限制在单一CLI工具的能力范围内，无法调用其他工具的独特功能
+2. **协作缺失** - 多个AI工具缺乏有效的协作机制，无法基于项目背景实现智能协同工作
+
+### Solution Overview
+开发一个双重功能的统一集成系统：
+1. **跨CLI直接调用系统** - 用户在任何CLI中自然语言调用其他CLI工具
+2. **间接协作系统** - 基于PROJECT_SPEC.json的AI工具自主协作机制
+所有集成严格使用各CLI的原生机制，不使用包装器方案。
+
+---
+
+## 🎯 Core Requirements
+
+### 1. Functional Requirements
+
+## 🎯 Core Requirements
+
+### 1. 跨CLI直接调用系统 (Cross-CLI Direct Calling System)
+
+#### FR-001: 跨CLI调用能力
+- **优先级:** 最高
+- **描述:** 用户必须在任何支持的AI CLI工具中能够自然语言调用其他AI CLI工具
+- **验收标准:**
+  - 用户可以在Claude CLI中输入"请用gemini帮我分析这个文件"
+  - 用户可以在QwenCodeCLI中输入"调用claude审查这段代码"
+  - 系统自动检测目标CLI并执行请求
+  - 结果在源CLI中正确显示并标注来源
+
+#### FR-002: 自然语言协作协议
+- **优先级:** 最高
+- **描述:** 支持直观的自然语言调用协议，无需学习特定语法
+- **支持协议:**
+  - "请用{CLI名} + 任务描述"
+  - "调用{CLI名} + 任务描述"
+  - "用{CLI名}来 + 任务描述"
+  - "让{CLI名}帮我 + 任务描述"
+  - "use {CLI名} + 任务描述"
+
+#### FR-003: 透明集成
+- **优先级:** 最高
+- **描述:** 集成不能改变现有CLI工具的启动和使用方式
+- **约束条件:**
+  - 用户仍使用原有命令启动CLI工具
+  - 正常CLI功能保持不变
+  - 跨CLI功能是增强功能，不替换原有功能
+
+#### FR-004: 目标CLI工具清单
+- **优先级:** 高
+- **描述:** 系统必须支持集成指定的7个AI CLI工具
+- **目标CLI工具 (按优先级排序):**
+  1. **Claude CLI** (最高优先级) - Hook系统集成
+  2. **QwenCodeCLI** - Python类继承集成
+  3. **iFlowCLI** - 工作流脚本集成
+  4. **QoderCLI** - 环境变量钩子集成
+  5. **GeminiCLI** - Python模块配置集成
+  6. **CodeBuddyCLI** - 插件系统集成
+  7. **Codex CLI** - 配置注入集成
+
+#### FR-005: 原生机制集成
+- **优先级:** 最高
+- **描述:** 每个CLI工具必须使用其最适合的原生集成机制
+- **集成方案映射:**
+  - **Claude CLI**: Hook System (UserPromptSubmit hook) - 完全原生
+  - **QwenCodeCLI**: Python Class Inheritance - 继承原生类
+  - **GeminiCLI**: Python Module + Configuration - 模块集成
+  - **iFlowCLI**: Workflow Scripts - 工作流脚本钩子
+  - **QoderCLI**: Environment Variable Hooks - 环境变量响应
+  - **CodeBuddyCLI**: Plugin System - 原生插件接口
+  - **Codex CLI**: Configuration Injection - 配置预处理
+
+### 2. 间接协作系统 (Indirect Collaboration System)
+
+#### FR-006: 基于文档的协作机制
+- **优先级:** 高
+- **描述:** 基于PROJECT_SPEC.json实现AI工具间的间接协作
+- **验收标准:**
+  - 多个AI工具能够读取和更新PROJECT_SPEC.json
+  - 工具能够基于项目状态自主认领任务
+  - 支持协作历史记录和状态追踪
+
+#### FR-007: 智能体协作协议
+- **优先级:** 高
+- **描述:** 支持AI工具间的自然语言协作协议
+- **协作协议:**
+  - "让<工具名>帮我<任务描述>"
+  - "用<工具名>来<任务描述>"
+  - "请<工具名><任务描述>"
+  - "调用<工具名>来<任务描述>"
+
+#### FR-008: 原子状态管理
+- **优先级:** 最高
+- **描述:** 确保并发访问PROJECT_SPEC.json的原子性和一致性
+- **技术要求:**
+  - 跨平台文件锁机制
+  - 原子读写操作
+  - 冲突检测和解决
+  - 状态变更追踪
+
+### 3. 通用功能要求 (General Functional Requirements)
+
+#### FR-009: 智能CLI选择
+- **优先级:** 中
+- **描述:** 当未明确指定目标CLI时，系统应自动选择最适合的CLI工具
+- **选择标准:**
+  - 任务类型与CLI优势匹配
+  - 工具可用性检查
+  - 历史性能表现
+  - 用户偏好设置
+
+#### FR-010: 错误处理和降级
+- **优先级:** 高
+- **描述:** 系统必须优雅处理失败并提供降级机制
+- **要求:**
+  - 目标CLI不可用时提供替代建议
+  - 跨CLI调用失败时降级到源CLI处理
+  - 清晰的错误信息和恢复建议
+
+#### FR-011: 结果格式化
+- **优先级:** 中
+- **描述:** 跨CLI调用结果必须适合源CLI上下文的格式化显示
+- **要求:**
+  - 所有CLI集成的一致格式化
+  - 结果来源的清晰标注
+  - 执行时间信息
+  - 上下文感知的响应格式
+
+#### FR-012: 任务状态生命周期
+- **优先级:** 高
+- **描述:** 必须实现完整的任务状态生命周期管理
+- **任务状态:**
+  - `pending` - 待认领
+  - `in_progress` - 进行中
+  - `completed` - 已完成
+  - `failed` - 失败
+  - `blocked` - 被阻塞
+
+### 4. 非功能性要求 (Non-Functional Requirements)
+
+#### NFR-001: 性能要求
+- **响应时间:** 跨CLI调用应在30秒内完成
+- **系统开销:** 集成应对正常CLI操作增加最小开销(<100ms)
+- **并发支持:** 支持多个同时进行的跨CLI调用
+- **协作响应:** 协作状态变更响应时间<1秒
+
+#### NFR-002: 兼容性要求
+- **Python版本:** 支持Python 3.8+
+- **操作系统:** 支持Linux, macOS, Windows
+- **CLI版本:** 支持所有目标CLI工具的当前稳定版本
+
+#### NFR-003: 可靠性要求
+- **可用性:** 跨CLI功能99%正常运行时间
+- **错误率:** 因系统问题导致的跨CLI调用失败率<1%
+- **恢复能力:** 从瞬时故障中自动恢复
+- **数据一致性:** 协作状态数据完整性>99.99%
+
+#### NFR-004: 安全性要求
+- **API密钥管理:** 安全处理API密钥和凭证
+- **命令验证:** 验证和清理跨CLI命令
+- **访问控制:** 尊重现有CLI权限系统
+- **数据保护:** 本地存储，不传输项目数据
+
+#### NFR-005: 可维护性要求
+- **代码质量:** 遵循PEP 8标准
+- **文档完整性:** 完整的API和集成文档
+- **测试覆盖率:** 关键组件90%+代码覆盖率
+- **模块化设计:** 每个CLI适配器独立实现
+
+#### NFR-006: 可扩展性要求
+- **新CLI支持:** 易于添加新CLI工具的框架
+- **插件架构:** 支持第三方扩展
+- **配置系统:** 灵活的配置管理
+- **版本兼容:** 向后兼容多个CLI版本
+
+---
+
+---
+
+## 🚫 明确约束条件和负面要求 (绝对不可妥协)
+
+### NC-001: 绝对不依赖VS Code
+- **约束条件:** 解决方案绝对不能依赖VS Code或任何特定IDE
+- **理由:** 用户要求纯命令行解决方案
+- **影响:** 所有功能必须在终端环境中工作
+
+### NC-002: 绝对不使用包装器作为主要方案
+- **约束条件:** 绝对不能依赖shell包装器脚本作为主要集成方法
+- **理由:** 用户偏好内部插件/钩子集成，而非外部包装器
+- **影响:** 必须使用各CLI的原生扩展机制
+
+### NC-003: 绝对不改变CLI启动方式
+- **约束条件:** 绝对不能改变用户启动和配置CLI工具的方式
+- **理由:** 用户希望透明集成，不中断工作流程
+- **影响:** 集成必须是增量的、非侵入性的
+
+### NC-004: 绝对不引入新的主要命令
+- **约束条件:** 绝对不能为CLI工具引入新的主要命令名称
+- **理由:** 用户希望使用现有CLI命令的增强功能
+- **影响:** 跨CLI功能必须集成到现有命令流中
+
+### NC-005: 绝对不依赖外部服务
+- **约束条件:** 核心功能绝对不能依赖外部服务(除目标CLI工具外)
+- **理由:** 确保离线能力和减少外部依赖
+- **影响:** 所有跨CLI协调必须在本地发生
+
+---
+
+## 📊 Acceptance Criteria
+
+### AC-001: Installation Success
+- [ ] User can install system with single command
+- [ ] Installation detects available CLI tools automatically
+- [ ] Integration works immediately after installation without additional configuration
+
+### AC-002: Basic Cross-CLI Functionality
+- [ ] User can call Claude from Gemini CLI
+- [ ] User can call Gemini from Claude CLI
+- [ ] Results are correctly formatted and attributed
+
+### AC-003: Advanced Cross-CLI Features
+- [ ] System handles multiple cross-CLI calls in single request
+- [ ] Intelligent CLI selection works when target not specified
+- [ ] Error handling and fallback mechanisms function correctly
+
+### AC-004: Performance and Reliability
+- [ ] Cross-CLI calls complete within performance requirements
+- [ ] System gracefully handles CLI tool unavailability
+- [ ] Normal CLI operations not impacted by integration
+
+### AC-005: User Experience
+- [ ] Learning curve is minimal for existing CLI users
+- [ ] Error messages are clear and actionable
+- [ ] Documentation is comprehensive and accessible
+
+---
+
+## 🔄 Success Metrics
+
+### Technical Metrics
+- **Integration Success Rate:** >95% of cross-CLI calls complete successfully
+- **Performance Overhead:** <100ms additional latency for cross-CLI detection
+- **Compatibility:** Support for current stable versions of all 8 CLI tools
+- **Test Coverage:** >90% code coverage for critical integration components
+
+### User Experience Metrics
+- **Adoption Rate:** >80% of beta testers continue to use after 1 month
+- **Task Completion Rate:** >90% of cross-CLI tasks completed successfully
+- **User Satisfaction:** >4.5/5 rating on user feedback surveys
+- **Support Requests:** <5% of users require support for basic functionality
+
+---
+
+## 🚧 Risk Assessment
+
+### High-Risk Items
+1. **CLI Tool Compatibility:** Risk of breaking changes in target CLI tools
+2. **Integration Complexity:** Different integration mechanisms per CLI tool
+3. **Performance Impact:** Potential overhead on CLI operations
+
+### Mitigation Strategies
+1. **Version Compatibility:** Maintain compatibility matrix and automated testing
+2. **Modular Architecture:** Isolate each CLI adapter to limit blast radius
+3. **Performance Monitoring:** Continuous monitoring of integration overhead
+
+---
+
+## 📅 Implementation Phases
+
+### Phase 1: Core Infrastructure (Weeks 1-4)
+- [ ] Develop base adapter framework
+- [ ] Implement CLI detection and discovery
+- [ ] Create natural language parsing engine
+- [ ] Build cross-CLI execution engine
+
+### Phase 2: Primary CLI Integration (Weeks 5-8)
+- [ ] Implement Claude CLI hook integration
+- [ ] Implement Aider CLI plugin integration
+- [ ] Implement Gemini CLI module integration
+- [ ] Test three-tool cross-CLI functionality
+
+### Phase 3: Extended CLI Support (Weeks 9-12)
+- [ ] Implement remaining 5 CLI tool integrations
+- [ ] Add intelligent CLI selection
+- [ ] Implement comprehensive error handling
+- [ ] Performance optimization
+
+### Phase 4: Polish and Launch (Weeks 13-16)
+- [ ] Complete documentation
+- [ ] Security audit and hardening
+- [ ] User acceptance testing
+- [ ] Production deployment
+
+---
+
+## 📝 Version History
+
+| Version | Date | Changes | Author |
+|---------|------|---------|--------|
+| 1.0 | 2025-01-22 | Initial requirements specification | AI System |
+
+---
+
+## 📚 References
+
+1. Claude Code Documentation - Hook system and plugin architecture
+2. Aider CLI Documentation - Plugin system and command registry
+3. Gemini CLI Documentation - Configuration and module system
+4. spec.kit Standards - Requirements specification format
+5. User Requirements Analysis - Cross-CLI calling needs and constraints
+
+---
+
+*This document follows spec.kit standards for requirements specification and will be updated as the project evolves.*

package/docs/PROJECT_STRUCTURE.md

@@ -0,0 +1,304 @@
+# AI CLI Universal Integration System
+## Project Structure (项目结构)
+
+**Project ID:** AI-CLI-UNIFIED-001
+**Structure Version:** 1.0
+**Date:** 2025-01-22
+
+---
+
+## 📁 目录结构
+
+```
+smart-cli-router/
+├── 📄 核心文档
+│   ├── README.md                    # 项目介绍和快速开始
+│   ├── PROJECT_REQUIREMENTS.md      # 统一需求规范
+│   ├── PROJECT_CONSTITUTION.md      # 项目宪法（约束条件）
+│   ├── UNIFIED_TECHNICAL_ARCHITECTURE.md  # 统一技术架构
+│   ├── NATIVE_INTEGRATION_GUIDE.md  # 原生集成实现指南
+│   ├── PROJECT_STRUCTURE.md         # 项目结构说明（本文件）
+│   ├── CONTRIBUTING.md              # 贡献指南
+│   ├── LICENSE                      # 开源许可证
+│   └── requirements.txt             # Python依赖
+│
+├── 🔧 核心代码 (src/)
+│   ├── core/                        # 核心框架
+│   │   ├── __init__.py
+│   │   ├── base_adapter.py          # 适配器基类
+│   │   ├── factory.py               # 适配器工厂
+│   │   ├── parser.py                # 自然语言解析器
+│   │   ├── router.py                # 意图路由器
+│   │   └── collaboration.py         # 协作协调器
+│   │
+│   ├── adapters/                    # CLI适配器实现
+│   │   ├── claude/                  # Claude CLI适配器
+│   │   │   ├── __init__.py
+│   │   │   ├── hook_adapter.py      # Hook系统适配器
+│   │   │   └── config.json          # Claude CLI配置
+│   │   │
+│   │   ├── qwencode/                # QwenCodeCLI适配器
+│   │   │   ├── __init__.py
+│   │   │   ├── class_adapter.py     # 类继承适配器
+│   │   │   └── config.json          # QwenCodeCLI配置
+│   │   │
+│   │   ├── gemini/                  # Gemini CLI适配器
+│   │   │   ├── __init__.py
+│   │   │   ├── module_adapter.py    # 模块扩展适配器
+│   │   │   └── config.json          # Gemini CLI配置
+│   │   │
+│   │   ├── iflow/                   # iFlowCLI适配器
+│   │   │   ├── __init__.py
+│   │   │   ├── workflow_adapter.py  # 工作流脚本适配器
+│   │   │   ├── workflow.yml         # iFlowCLI工作流
+│   │   │   └── config.json          # iFlowCLI配置
+│   │   │
+│   │   ├── qoder/                   # QoderCLI适配器
+│   │   │   ├── __init__.py
+│   │   │   ├── plugin_adapter.py    # Plugin系统适配器
+│   │   │   └── config.json          # QoderCLI配置
+│   │   │
+│   │   ├── codebuddy/               # CodeBuddyCLI适配器
+│   │   │   ├── __init__.py
+│   │   │   ├── buddy_adapter.py     # Buddy系统适配器
+│   │   │   └── config.json          # CodeBuddyCLI配置
+│   │   │
+│   │   └── codex/                   # Codex CLI适配器
+│   │       ├── __init__.py
+│   │       ├── extension_adapter.py # Extension系统适配器
+│   │       └── config.json          # Codex CLI配置
+│   │
+│   └── utils/                       # 工具模块
+│       ├── __init__.py
+│       ├── logger.py                # 日志工具
+│       ├── config.py                # 配置管理
+│       ├── atomic_state.py          # 原子状态管理
+│       └── protocols.py             # 协议定义
+│
+├── 🧪 测试代码 (tests/)
+│   ├── unit/                        # 单元测试
+│   │   ├── __init__.py
+│   │   ├── test_core/               # 核心框架测试
+│   │   │   ├── test_base_adapter.py
+│   │   │   ├── test_factory.py
+│   │   │   ├── test_parser.py
+│   │   │   └── test_router.py
+│   │   │
+│   │   └── adapters/                # 适配器单元测试
+│   │       ├── test_claude_adapter.py
+│   │       ├── test_qwencode_adapter.py
+│   │       ├── test_gemini_adapter.py
+│   │       ├── test_iflow_adapter.py
+│   │       ├── test_qoder_adapter.py
+│   │       ├── test_codebuddy_adapter.py
+│   │       └── test_codex_adapter.py
+│   │
+│   ├── integration/                 # 集成测试
+│   │   ├── __init__.py
+│   │   ├── test_cross_cli_calls.py  # 跨CLI调用测试
+│   │   ├── test_collaboration.py    # 间接协作测试
+│   │   └── adapters/                # 适配器集成测试
+│   │       ├── test_claude_integration.py
+│   │       ├── test_qwencode_integration.py
+│   │       └── ...
+│   │
+│   ├── fixtures/                    # 测试数据
+│   │   ├── sample_requests.json
+│   │   ├── mock_responses.json
+│   │   └── test_configs/
+│   │
+│   └── conftest.py                  # pytest配置
+│
+├── 📚 文档 (docs/)
+│   ├── api/                         # API文档
+│   │   ├── core.md                  # 核心API
+│   │   └── adapters.md              # 适配器API
+│   │
+│   ├── user_guide/                  # 用户指南
+│   │   ├── installation.md          # 安装指南
+│   │   ├── usage.md                 # 使用指南
+│   │   └── troubleshooting.md       # 故障排除
+│   │
+│   └── developer_guide/             # 开发者指南
+│       ├── contributing.md          # 贡献指南
+│       ├── testing.md               # 测试指南
+│       └── architecture.md          # 架构说明
+│
+├── 🚀 部署和配置
+│   ├── install_unix.sh              # Unix安装脚本
+│   ├── install_windows.bat          # Windows安装脚本
+│   ├── config.json                  # 全局配置文件
+│   ├── pyproject.toml               # Python项目配置
+│   └── setup.py                     # 安装脚本
+│
+├── 🌐 网站 (website/)
+│   ├── index.html                   # 主页
+│   ├── css/                         # 样式文件
+│   ├── js/                          # JavaScript文件
+│   └── docs/                        # 网站文档
+│
+├── 🗄️ 存档 (archive/)
+│   ├── obsolete_files/              # 过时文件存档
+│   └── old_versions/                # 旧版本存档
+│
+├── 📋 项目管理
+│   ├── PROJECT_SPEC.json            # 项目规范
+│   └── .gitignore                   # Git忽略文件
+│
+└── 🔒 配置和缓存
+    ├── .git/                        # Git仓库
+    ├── .claude/                     # Claude配置
+    └── __pycache__/                 # Python缓存
+```
+
+---
+
+## 🎯 目录设计原则
+
+### 1. **CLI专用目录结构**
+每个CLI工具都有独立的适配器目录：
+- **独立的适配器实现** - 避免代码耦合
+- **专用配置文件** - 每个CLI的特定配置
+- **独立测试** - 针对性的单元测试和集成测试
+
+### 2. **TDD驱动结构**
+测试先行，代码后实现：
+- **单元测试** - 每个组件的独立测试
+- **集成测试** - 跨组件功能测试
+- **测试数据** - 标准化的测试数据集
+
+### 3. **模块化设计**
+清晰的模块划分：
+- **core/** - 核心框架和通用功能
+- **adapters/** - CLI特定的适配器实现
+- **utils/** - 通用工具和辅助功能
+
+### 4. **文档分层**
+面向不同用户的文档：
+- **用户文档** - 安装、使用、故障排除
+- **开发者文档** - API、架构、贡献指南
+- **技术文档** - 详细的技术规范
+
+---
+
+## 📦 开发工作流
+
+### TDD开发流程
+1. **编写测试** - 在`tests/`中创建测试用例
+2. **运行测试** - 测试应该失败（RED）
+3. **实现代码** - 在`src/`中编写最小可行代码
+4. **运行测试** - 测试应该通过（GREEN）
+5. **重构优化** - 改进代码质量，保持测试通过（REFACTOR）
+
+### CLI适配器开发流程
+1. **创建适配器目录** - `src/adapters/{cli_name}/`
+2. **编写适配器测试** - `tests/unit/adapters/test_{cli_name}_adapter.py`
+3. **实现适配器类** - `src/adapters/{cli_name}/{type}_adapter.py`
+4. **创建配置文件** - `src/adapters/{cli_name}/config.json`
+5. **编写集成测试** - `tests/integration/adapters/test_{cli_name}_integration.py`
+
+---
+
+## 🔧 核心组件说明
+
+### 1. **BaseAdapter** (`src/core/base_adapter.py`)
+所有CLI适配器的基类，定义统一接口：
+```python
+class BaseCrossCLIAdapter(ABC):
+    @abstractmethod
+    async def execute_task(self, task: str, context: dict) -> str
+    @abstractmethod
+    def is_available(self) -> bool
+```
+
+### 2. **AdapterFactory** (`src/core/factory.py`)
+适配器工厂，负责创建和管理适配器实例：
+```python
+class CrossCliAdapterFactory:
+    def get_adapter(self, cli_name: str) -> BaseCrossCLIAdapter
+    def list_available_adapters(self) -> Dict[str, bool]
+```
+
+### 3. **NaturalLanguageParser** (`src/core/parser.py`)
+自然语言解析器，识别跨CLI调用意图：
+```python
+class NaturalLanguageParser:
+    def parse_intent(self, user_input: str) -> IntentResult
+    def detect_cross_cli_call(self, text: str) -> bool
+```
+
+### 4. **IntentRouter** (`src/core/router.py`)
+意图路由器，根据解析结果路由到相应处理器：
+```python
+class IntentRouter:
+    def route_request(self, intent: IntentResult) -> RequestTarget
+    def select_adapter(self, target_cli: str) -> BaseCrossCLIAdapter
+```
+
+---
+
+## 📋 开发优先级
+
+基于原生集成可行性，开发优先级为：
+
+### Phase 1: 高可行性CLI (Weeks 1-4)
+1. **Claude CLI** - 官方Hook系统，文档完善
+2. **QwenCodeCLI** - Python类继承，原生支持
+3. **Gemini CLI** - 官方Extension接口
+
+### Phase 2: 标准CLI (Weeks 5-8)
+4. **CodeBuddyCLI** - 官方Buddy系统
+5. **QoderCLI** - 官方Plugin架构
+6. **Codex CLI** - 官方Extension系统
+
+### Phase 3: 创新CLI (Weeks 9-12)
+7. **iFlowCLI** - 官方Python工作流节点
+
+---
+
+## 🧪 测试策略
+
+### 测试金字塔
+```
+    E2E Tests (5%)
+      用户场景测试
+    Integration Tests (25%)
+      适配器集成测试
+      跨CLI调用测试
+    Unit Tests (70%)
+      核心组件测试
+      适配器单元测试
+```
+
+### 测试覆盖率目标
+- **核心框架**: 95%+ 覆盖率
+- **适配器代码**: 90%+ 覆盖率
+- **工具模块**: 85%+ 覆盖率
+
+### 测试环境
+- **本地测试**: 单元测试和基础集成测试
+- **CI/CD测试**: 全量测试套件
+- **端到端测试**: 真实CLI环境测试
+
+---
+
+## 🚀 部署结构
+
+### 包结构
+```
+ai_cli_unified/
+├── __init__.py
+├── core/
+├── adapters/
+├── utils/
+└── __main__.py
+```
+
+### 配置管理
+- **全局配置**: `~/.config/ai-cli-unified/config.yml`
+- **CLI特定配置**: `~/.config/{cli}/config.yml`
+- **用户配置**: `~/.ai-cli-unified/config.json`
+
+---
+
+*本项目结构设计遵循TDD原则、模块化设计和CLI专用化策略，确保代码的可维护性、可测试性和可扩展性。*