Agent Project Structure 规范#

如何触发#

当用户说以下内容时， 默认触发此技能：

• "创建一个项目" / "create a project"
• "新建项目" / "new project"
• "项目结构" / "project structure"

除非用户明确指定其他目录结构需求，否则应按此规范组织项目结构。

快速开始#

检查现有结构#

bash

python scripts/check_structure.py <项目路径>

创建新项目结构#

bash

python scripts/create_structure.py <项目路径>

标准目录结构#

text

agent-project/
├── projects/          # 项目文件目录
├── log/               # 日志文件目录
├── temp/              # 临时文件目录（截图、缓存等）
│   ├── screenshots/   # 截图文件
│   └── cache/         # 缓存文件
├── config/            # 配置文件目录
├── data/              # 数据文件目录
│   ├── input/         # 输入数据
│   └── output/        # 输出数据
├── scripts/           # 脚本文件目录
└── docs/              # 文档目录

文件分类原则#

类型目录说明项目文件projects/项目代码、资源日志文件log/应用日志临时文件temp/截图、缓存配置文件config/环境配置数据文件data/输入/输出数据

使用场景#

1. 检查现有结构 - 检查现有项目结构是否符合规范
2. 创建新项目 - 生成标准目录结构
3. 重构项目结构 - 指导现有项目重构

相关资源#

• QUICK_START.md - 快速开始指南
• references/PROJECT_STRUCTURE.md - 详细规范说明
• references/GITIGNORE.md - .gitignore 模板