agent-project-structure

Agent project directory structure规范。指导agent生成规范的项目文件结构，包括：项目文件单独存放在项目目录下，日志文件统一放在log目录，临时文件（截图、缓存等）与正式文件分离。使用时检查现有结构是否符合规范，或根据规范创建/调整目录结构。

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install agent-project-structure

Agent Project Structure 规范

如何触发

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

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

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

快速开始

检查现有结构

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

创建新项目结构

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

标准目录结构

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

文件分类原则

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

使用场景

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