← 返回 Skills 市场

agent-project-structure

Name: agent-project-structure
Author: songxf1024

作者 Song Xianfeng · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install agent-project-structure

功能描述

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

使用说明 (SKILL.md)

Agent Project Structure 规范

快速开始

检查现有结构

python scripts/check_structure.py \x3C项目路径>

创建新项目结构

python scripts/create_structure.py \x3C项目路径>

标准目录结构

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

文件分类原则

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

使用场景

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

相关资源

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

安全使用建议

This skill appears safe for organizing local project directories. Before installing or using it, note that the create script writes folders and placeholder files under the path you provide; avoid running it against important existing directories unless you have reviewed what it will create and have a backup if needed.

功能分析

Type: OpenClaw Skill Name: agent-project-structure Version: 1.0.0 The skill bundle provides a standardized project directory structure for AI agents, including scripts to validate and create the layout. The Python scripts (check_structure.py and create_structure.py) perform legitimate file system operations consistent with the stated purpose, and no evidence of data exfiltration, malicious execution, or prompt injection was found.

能力评估

✓ Purpose & Capability

The stated purpose is to check or create a standardized agent project directory layout, and the included files consistently document and implement that behavior.

ℹ Instruction Scope

The usage examples ask the user to run local Python helper scripts against a project path; this is purpose-aligned, but users should choose the target path carefully.

ℹ Install Mechanism

There is no install spec and no external dependency, but the skill does rely on running the included Python scripts despite metadata declaring no required binaries.

ℹ Credentials

The create script performs local filesystem writes under the supplied path, which is expected for a directory-structure helper but should be run only on intended project directories.

✓ Persistence & Privilege

The skill creates persistent project folders and placeholder files only when invoked; there is no evidence of background execution, privilege escalation, credential use, or ongoing persistence.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install agent-project-structure
安装完成后，直接呼叫该 Skill 的名称或使用 /agent-project-structure 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release introducing the agent-project-structure skill. - Provides a standard directory structure for agent projects, separating project files, logs, temp data, configs, and documentation. - Includes scripts to check existing structures or create new, compliant directory layouts. - Offers clear documentation and usage examples for both new and existing projects.

元数据

Slug agent-project-structure

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题