@dtt_siye/atool 1.1.0

package/templates/README.md.python

@@ -0,0 +1,66 @@
+# {{PROJECT_NAME}}
+
+{{PROJECT_DESCRIPTION}}
+
+## 技术栈
+
+- **语言**: Python
+- **框架**: Django / FastAPI / Flask
+- **包管理**: pip / poetry / uv
+
+## 项目结构
+
+> 由 `project-analyze` skill 自动填充
+
+```
+├── app/                # 应用主目录
+│   ├── __init__.py
+│   ├── main.py         # 入口文件
+│   ├── models/         # 数据模型
+│   ├── schemas/        # Pydantic schemas (如使用)
+│   ├── routers/        # API 路由
+│   ├── services/       # 业务逻辑
+│   ├── utils/          # 工具函数
+│   └── config.py       # 配置
+├── tests/              # 测试
+├── migrations/         # 数据库迁移
+├── requirements.txt    # 依赖
+└── pyproject.toml      # 项目配置
+```
+
+## 架构设计
+
+> 由 `project-analyze` skill 自动填充
+
+- 架构模式:
+- 分层结构:
+- 数据库方案:
+
+## 快速开始
+
+```bash
+# 创建虚拟环境
+python -m venv venv
+source venv/bin/activate
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 运行
+python -m app.main
+```
+
+## 开发规范
+
+- 遵循 PEP 8 编码规范
+- 类型注解 (type hints)
+- 使用虚拟环境隔离依赖
+- 统一的异常处理
+
+## API 接口
+
+> 由 `project-analyze` skill 自动填充
+
+| 方法 | 路径 | 描述 |
+|------|------|------|
+| | | |

package/templates/README.md.rust

@@ -0,0 +1,69 @@
+# {{PROJECT_NAME}}
+
+{{PROJECT_DESCRIPTION}}
+
+## 技术栈
+
+- **语言**: Rust
+- **包管理**: Cargo
+- **检测类型**: {{STACK_TYPE}}
+
+## 项目结构
+
+> 由 `project-analyze` skill 自动填充
+
+```
+├── src/
+│   ├── main.rs         # 二进制入口
+│   ├── lib.rs          # 库入口
+│   ├── config/         # 配置模块
+│   ├── models/         # 数据模型
+│   ├── services/       # 业务逻辑
+│   ├── handlers/       # 请求处理
+│   ├── errors/         # 错误类型
+│   └── utils/          # 工具函数
+├── tests/              # 集成测试
+├── benches/            # 基准测试
+├── Cargo.toml          # 项目清单
+└── Cargo.lock          # 依赖锁定
+```
+
+## 架构设计
+
+> 由 `project-analyze` skill 自动填充
+
+- 模块组织:
+- 错误处理策略:
+- 异步运行时:
+
+## 快速开始
+
+```bash
+# 构建
+cargo build
+
+# 运行
+cargo run
+
+# 测试
+cargo test
+
+# 发布构建
+cargo build --release
+```
+
+## 开发规范
+
+- 遵循 Rust API Guidelines
+- 使用 `Result<T, E>` 进行错误处理
+- 充分利用所有权系统
+- 编写单元测试和集成测试
+- 使用 `clippy` 进行代码检查
+
+## Crate 模块
+
+> 由 `project-analyze` skill 自动填充
+
+| 模块 | 描述 | 公开 API |
+|------|------|----------|
+| | | |

package/templates/README.md.rust-tauri

@@ -0,0 +1,149 @@
+# {{PROJECT_NAME}}
+
+{{PROJECT_DESCRIPTION}}
+
+## 技术栈
+
+| 类别 | 技术 | 版本 |
+|------|------|------|
+| 桌面框架 | Tauri | {{FRAMEWORK_VERSION}} |
+| 后端语言 | Rust | {{RUST_VERSION}} |
+| 前端框架 | {{FRAMEWORK_NAME}} | {{FRONTEND_FRAMEWORK_VERSION}} |
+| UI 库 | {{UI_LIBRARY}} | {{UI_LIBRARY_VERSION}} |
+| 状态管理 | {{STATE_MANAGEMENT}} | |
+| 构建工具 | Vite | |
+| CSS 方案 | {{CSS_SOLUTION}} | |
+| 包管理 | {{PACKAGE_MANAGER}} | |
+
+## 项目概况
+
+- **源码文件**: {{SOURCE_FILE_COUNT}}
+- **检测类型**: {{STACK_TYPE}}
+- **双架构**: Rust 后端 (src-tauri/) + Web 前端 (src/)
+
+## 项目结构
+
+```
+{{PROJECT_NAME}}/
+├── src/                    # 前端代码
+│   ├── components/         # UI 组件
+│   ├── hooks/              # 自定义 Hooks
+│   ├── services/           # Tauri IPC 调用层
+│   └── stores/             # 状态管理
+├── src-tauri/              # Rust 后端
+│   ├── src/
+│   │   ├── main.rs         # 主入口
+│   │   ├── lib.rs          # 命令注册
+│   │   └── commands/       # Tauri 命令
+│   ├── Cargo.toml          # Rust 依赖
+│   └── tauri.conf.json     # Tauri 配置
+├── package.json
+└── vite.config.ts
+```
+
+## 架构设计
+
+```
+┌──────────────────────────────────────┐
+│            Web 前端 (src/)           │
+│  React/Vue + TypeScript + Vite      │
+│  ┌──────────┐  ┌─────────────────┐  │
+│  │  UI 组件  │  │  IPC 调用层     │  │
+│  │          │──│  (services/)    │  │
+│  └──────────┘  └────────┬────────┘  │
+└─────────────────────────┼────────────┘
+                          │ invoke()
+                          ▼
+┌──────────────────────────────────────┐
+│          Rust 后端 (src-tauri/)      │
+│  ┌──────────────────────────────────┐│
+│  │       Tauri Commands             ││
+│  │  #[tauri::command] 函数集合      ││
+│  └──────────────┬───────────────────┘│
+│                 │                    │
+│  ┌──────────────▼───────────────────┐│
+│  │       系统 API / 文件 / 网络      ││
+│  └──────────────────────────────────┘│
+└──────────────────────────────────────┘
+```
+
+## 快速开始
+
+```bash
+# 安装前端依赖
+pnpm install
+
+# 开发模式（前后端同时启动，支持热重载）
+pnpm tauri dev
+
+# 构建发布版本
+pnpm tauri build
+```
+
+### 前置要求
+
+- Node.js >= 18
+- Rust (通过 rustup 安装)
+- 系统依赖（参见 Tauri 官方文档的 Platform-specific prerequisites）
+
+## 开发指南
+
+### 新增 Tauri 命令
+
+1. 在 `src-tauri/src/commands/` 新建模块文件
+2. 定义 `#[tauri::command]` 函数
+3. 在 `src-tauri/src/lib.rs` 注册命令
+4. 在前端 `services/` 封装 `invoke()` 调用
+5. 在 `capabilities/` 声明必要权限
+
+### 前端开发
+
+与常规 Web 开发一致，额外使用 `@tauri-apps/api` 进行 IPC 调用。
+
+### Rust 后端开发
+
+遵循 Rust 标准开发流程：`cargo check` → `cargo clippy` → `cargo test`。
+
+## 页面路由
+
+{{#ROUTE_TABLE}}
+| 路径 | 组件 | 描述 |
+|------|------|------|
+| / | | 首页 |
+{{/ROUTE_TABLE}}
+
+## 新人上手检查清单
+
+{{#NEWCOMER_CHECKLIST}}
+> 由 `project-analyze` skill 自动填充
+
+### 阶段 1：环境准备
+- [ ] 安装 Node.js、Rust、系统依赖
+- [ ] 克隆代码仓库
+- [ ] 运行 `pnpm install`
+- [ ] 运行 `pnpm tauri dev` 确认项目正常启动
+
+### 阶段 2：项目理解
+- [ ] 阅读 README 的架构设计章节
+- [ ] 理解前后端 IPC 通信模式
+- [ ] 了解 Tauri 权限模型
+
+### 阶段 3：开发实战
+- [ ] 尝试新增一个简单的 Tauri 命令
+- [ ] 在前端调用该命令并展示结果
+- [ ] 运行 `cargo clippy` 确认代码质量
+
+### 阶段 4：业务理解
+- [ ] 理解各模块的业务职责
+- [ ] 熟悉状态管理方案
+- [ ] 了解错误处理策略
+{{/NEWCOMER_CHECKLIST}}
+
+## Related Documentation
+
+{{#RELATED_DOCS}}
+> 由 `project-analyze` skill 自动填充
+
+| 文档 | 说明 |
+|------|------|
+{{/RELATED_DOCS}}

package/templates/README.md.web

@@ -0,0 +1,94 @@
+# {{PROJECT_NAME}}
+
+{{PROJECT_DESCRIPTION}}
+
+## 技术栈
+
+| 类别 | 技术 | 版本 |
+|------|------|------|
+| 框架 | {{FRAMEWORK_NAME}} | {{FRAMEWORK_VERSION}} |
+| UI 库 | {{UI_LIBRARY}} | {{UI_LIBRARY_VERSION}} |
+| 状态管理 | {{STATE_MANAGEMENT}} | |
+| 路由 | {{ROUTER}} | |
+| HTTP 客户端 | {{HTTP_CLIENT}} | |
+| 构建工具 | {{BUILDER}} | |
+| CSS 方案 | {{CSS_SOLUTION}} | |
+| 包管理 | {{PACKAGE_MANAGER}} | |
+
+## 项目概况
+
+- **源码文件**: {{SOURCE_FILE_COUNT}}
+- **检测类型**: {{STACK_TYPE}}
+
+## 项目结构
+
+```
+{{#PROJECT_STRUCTURE}}
+> 由 `project-analyze` skill 自动填充
+{{/PROJECT_STRUCTURE}}
+```
+
+## 快速开始
+
+```bash
+{{#QUICK_START}}
+npm install
+npm run dev
+npm run build
+{{/QUICK_START}}
+```
+
+## 开发规范
+
+{{#DEV_CONVENTIONS}}
+- 组件化开发，单一职责原则
+- 统一的 API 请求封装
+{{/DEV_CONVENTIONS}}
+
+## 页面路由
+
+{{#ROUTE_TABLE}}
+| 路径 | 组件 | 描述 |
+|------|------|------|
+| / | | 首页 |
+{{/ROUTE_TABLE}}
+
+## 新人上手检查清单
+
+{{#NEWCOMER_CHECKLIST}}
+> 由 `project-analyze` skill 自动填充
+
+### 阶段 1：环境准备
+- [ ] 克隆代码仓库
+- [ ] 安装 Node.js 和包管理器
+- [ ] 运行依赖安装
+- [ ] 配置环境变量（复制 `.env.example` → `.env`）
+- [ ] 启动开发服务器确认项目正常运行
+
+### 阶段 2：项目理解
+- [ ] 阅读 [文档导航](docs/000-navigation/000-index.md) 了解文档全貌
+- [ ] 阅读本 README 的「架构设计」章节
+- [ ] 阅读 [系统设计](docs/400-design/401-system-design.md)
+- [ ] 了解技术栈和项目结构
+
+### 阶段 3：开发实战
+- [ ] 阅读核心模块的 MODULE-DOC.md 中的「常见开发场景」
+- [ ] 按场景 step-by-step 完成一次练习
+- [ ] 运行测试确认环境正常
+- [ ] 了解 CI/CD 流程
+
+### 阶段 4：业务理解
+- [ ] 阅读核心模块的「业务术语表」
+- [ ] 理解路由结构和功能列表
+- [ ] 理解权限模型和数据流向
+- [ ] 熟悉故障排查路径
+{{/NEWCOMER_CHECKLIST}}
+
+## Related Documentation
+
+{{#RELATED_DOCS}}
+> 由 `project-analyze` skill 自动填充
+
+| 文档 | 说明 |
+|------|------|
+{{/RELATED_DOCS}}

package/templates/UI_STYLE.md.android

@@ -0,0 +1,74 @@
+# {{PROJECT_NAME}} - UI 样式文档
+
+> 本文档由 `project-analyze` skill 自动生成，也可手动维护。
+
+## 设计系统
+
+> 由 `project-analyze` skill 自动填充
+
+- 设计规范: Material Design 3 / 自定义
+- UI 工具包: Jetpack Compose / XML Layout
+
+## 主题配置
+
+> 由 `project-analyze` skill 自动填充
+
+### 颜色 (Colors)
+
+| Token | 色值 | 用途 |
+|-------|------|------|
+| primary | | 主色 |
+| onPrimary | | 主色上的内容 |
+| secondary | | 辅助色 |
+| background | | 背景色 |
+| surface | | 表面色 |
+| error | | 错误色 |
+
+### 字体 (Typography)
+
+| 样式 | 字号 | 字重 | 用途 |
+|------|------|------|------|
+| headlineLarge | | | 大标题 |
+| headlineMedium | | | 中标题 |
+| bodyLarge | | | 正文 |
+| bodyMedium | | | 次要正文 |
+| labelSmall | | | 标签 |
+
+### 间距 (Spacing)
+
+> 由 `project-analyze` skill 自动填充
+
+| Token | 值 (dp) | 用途 |
+|-------|---------|------|
+| spacing-xs | | 极小 |
+| spacing-sm | | 小 |
+| spacing-md | | 中 |
+| spacing-lg | | 大 |
+| spacing-xl | | 超大 |
+
+## 自定义组件样式
+
+> 由 `project-analyze` skill 自动填充
+
+| 组件 | 文件路径 | 样式描述 |
+|------|----------|----------|
+| | | |
+
+## 图片资源规范
+
+> 由 `project-analyze` skill 自动填充
+
+| 资源名 | 分辨率 | 描述 |
+|--------|--------|------|
+| | mdpi | |
+| | hdpi | |
+| | xhdpi | |
+| | xxhdpi | |
+
+## 动效规范
+
+> 由 `project-analyze` skill 自动填充
+
+| 效果 | 时长 | 描述 |
+|------|------|------|
+| | | |

package/templates/UI_STYLE.md.devops

@@ -0,0 +1,50 @@
+# {{PROJECT_NAME}} - UI 样式文档
+
+> 本文档由 `project-analyze` skill 自动生成，也可手动维护。
+> DevOps 项目的「UI」即基础设施可视化（监控面板、Dashboard 等）。
+
+## 监控 Dashboard
+
+> 由 `project-analyze` skill 自动填充
+
+| Dashboard | 工具 | URL | 描述 |
+|-----------|------|-----|------|
+| | Grafana | | |
+| | | | |
+
+## 告警规则
+
+> 由 `project-analyze` skill 自动填充
+
+| 告警名 | 级别 | 条件 | 通知渠道 |
+|--------|------|------|----------|
+| | critical | | |
+| | warning | | |
+
+## 日志规范
+
+> 由 `project-analyze` skill 自动填充
+
+| 服务 | 日志格式 | 日志级别 | 存储 |
+|------|----------|----------|------|
+| | | | |
+
+## 环境变量规范
+
+> 由 `project-analyze` skill 自动填充
+
+| 变量名 | 环境 | 描述 |
+|--------|------|------|
+| | dev | |
+| | staging | |
+| | production | |
+
+## CI/CD 状态徽章
+
+> 由 `project-analyze` skill 自动填充
+
+| 徽章 | 描述 |
+|------|------|
+| | Build Status |
+| | Test Coverage |
+| | Docker Image |

package/templates/UI_STYLE.md.generic

@@ -0,0 +1,31 @@
+# {{PROJECT_NAME}} - UI 样式文档
+
+> 本文档由 `project-analyze` skill 自动生成，也可手动维护。
+
+## 设计规范
+
+> 由 `project-analyze` skill 自动填充
+
+## 颜色系统
+
+> 由 `project-analyze` skill 自动填充
+
+| Token | 色值 | 用途 |
+|-------|------|------|
+| | | |
+
+## 字体系统
+
+> 由 `project-analyze` skill 自动填充
+
+| Token | 值 | 用途 |
+|-------|-----|------|
+| | | |
+
+## 组件样式
+
+> 由 `project-analyze` skill 自动填充
+
+| 组件 | 样式描述 |
+|------|----------|
+| | |

package/templates/UI_STYLE.md.go

@@ -0,0 +1,49 @@
+# {{PROJECT_NAME}} - UI 样式文档
+
+> 本文档由 `project-analyze` skill 自动生成，也可手动维护。
+> Go 项目通常为后端服务或 CLI 工具，此文档记录 API 格式和 CLI 规范。
+
+## API 响应格式
+
+> 由 `project-analyze` skill 自动填充
+
+### 统一响应
+
+```json
+{
+  "code": 0,
+  "message": "success",
+  "data": {}
+}
+```
+
+### 错误码
+
+| 错误码 | HTTP 状态码 | 描述 |
+|--------|-------------|------|
+| 0 | 200 | 成功 |
+| | | |
+
+## CLI 界面规范（如适用）
+
+> 由 `project-analyze` skill 自动填充
+
+| 命令 | 参数 | 描述 |
+|------|------|------|
+| | | |
+
+## 配置文件格式
+
+> 由 `project-analyze` skill 自动填充
+
+| 配置项 | 环境变量 | 默认值 | 描述 |
+|--------|----------|--------|------|
+| | | | |
+
+## 日志格式
+
+> 由 `project-analyze` skill 自动填充
+
+- 日志库:
+- 输出格式:
+- 日志级别:

package/templates/UI_STYLE.md.harmony

@@ -0,0 +1,71 @@
+# {{PROJECT_NAME}} - UI 样式文档
+
+> 本文档由 `project-analyze` skill 自动生成，也可手动维护。
+
+## 设计系统
+
+> 由 `project-analyze` skill 自动填充
+
+- 设计规范: HarmonyOS Design Guidelines
+- UI 框架: ArkUI (声明式)
+
+## 主题配置
+
+> 由 `project-analyze` skill 自动填充
+
+### 颜色系统
+
+| Token | 资源引用 | 色值 | 用途 |
+|-------|----------|------|------|
+| primary | $r('app.color.primary') | | 主色 |
+| secondary | $r('app.color.secondary') | | 辅助色 |
+| background | $r('app.color.background') | | 背景色 |
+| foreground | $r('app.color.foreground') | | 前景色 |
+
+### 字体系统
+
+| Token | 值 | 用途 |
+|-------|-----|------|
+| font-family | | 字体族 |
+| font-size-headline | | 大标题 |
+| font-size-title | | 标题 |
+| font-size-body | | 正文 |
+| font-size-caption | | 辅助文字 |
+
+### 间距系统
+
+> 由 `project-analyze` skill 自动填充
+
+| Token | 值 (vp) | 用途 |
+|-------|---------|------|
+| spacing-xs | | 极小 |
+| spacing-sm | | 小 |
+| spacing-md | | 中 |
+| spacing-lg | | 大 |
+
+## ArkUI 组件样式
+
+> 由 `project-analyze` skill 自动填充
+
+| 组件 | 文件路径 | 样式描述 |
+|------|----------|----------|
+| | | |
+
+## 资源引用规范
+
+> 由 `project-analyze` skill 自动填充
+
+| 类型 | 目录 | 引用格式 |
+|------|------|----------|
+| 字符串 | resources/base/element/string.json | $r('app.string.xxx') |
+| 颜色 | resources/base/element/color.json | $r('app.color.xxx') |
+| 浮点数 | resources/base/element/float.json | $r('app.float.xxx') |
+| 图片 | resources/base/media/ | $r('app.media.xxx') |
+
+## 自定义样式 (@Styles / @Extend)
+
+> 由 `project-analyze` skill 自动填充
+
+| 样式名 | 文件路径 | 描述 |
+|--------|----------|------|
+| | | |