Token导航 LogoToken导航

Agent Skill · 开发

project-structure(项目结构)

project-structure 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

project-structure 是开发类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为只读;许可证信息还不明确,第三方扫描已通过,按安装量在开发类的 21,746 个 Skill 里排第 17,575。

总安装 396周安装 17GitHub Stars 179下载 139核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:project-structure(项目结构)
来源仓库:https://github.com/mingyuepop/specforge
仓库路径:skills/project-structure
安装命令:
npx skills add https://github.com/mingyuepop/specforge --skill project-structure
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/mingyuepop/specforge --skill project-structure

这个 Skill 是做什么的

开发类 Skill 面向写代码、改代码和排查问题,一般会读写仓库文件,部分还会执行构建或测试命令。

project-structure 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中围绕仓库状态、代码变更或协作事项进行整理。适用于需要分析项目目录结构、规范代码组织或优化模块划分的场景。

通过安装命令添加后,可结合来源仓库和 README 文档进一步了解具体用法。安装前需确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写操作。适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

来源仓库内路径:skills/project-structure

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/mingyuepop/specforge --skill project-structure;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它标注为只读,先用只读任务试一次,确认行为符合预期再扩大使用范围。

常见问题

6 条

project-structure 怎么安装?

在终端执行 npx skills add https://github.com/mingyuepop/specforge --skill project-structure。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

project-structure 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

project-structure 需要什么权限?

权限级别是只读。该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

project-structure 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

project-structure 用的人多吗?

公开数据是累计安装 396 次,近一周安装 17 次,下载 139 次,GitHub 179 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

project-structure 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。
  • 标注为只读权限,试用阶段不容易误改本地文件。

先想清楚的地方

  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理开发类任务、又不想每次都手写提示词的人。
  • 只想先试试效果、不希望它改动本地文件的人。

不太适合

  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

开发类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
skill-vetter

技能审查员 · OpenClaw

8,779,018986操作浏览器MIT-0通过
ontology

本体论 · OpenClaw

6,636,960576只读MIT-0通过
entra-app-registration

内部应用程序注册 · Codex、Claude

6,631,872764接触敏感数据未明确通过
entra-app-registration

内部应用程序注册 · Codex、Claude

3,757,680201接触敏感数据未明确通过
nano-banana-pro

纳米香蕉专业版 · OpenClaw

3,526,898364接触敏感数据MIT-0有提醒
project-structure

项目结构 · 本页

396179只读未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

Role: 系统架构师 (System Architect)

这是一个 Meta-Prompt。当用户提及此文档时,请扮演上述角色。 你的目标是设计清晰、高内聚低耦合的项目目录结构。

你的任务

基于技术栈 (specs/2_技术栈.md) 和核心业务 (specs/1_产品概述.md),生成具体的项目目录结构。

边界守卫 (Guardrails) - CRITICAL

请严格遵守通用边界守卫规则:specs/GUARDRAILS.md 当前阶段: 架构与设计阶段 (Architecture & Design)

工作流程

  1. 读取上下文:

- 读取 specs/2_技术栈.md:确定是用 Next.js 的路由结构,还是 Go 的 clean architecture。 * 读取 specs/1_产品概述.md:提取“核心板块”(如 Auth, User, Order),将它们映射到模块目录中。

  1. 设计结构 (Architectural Design):

- 根目录:必须包含标准文件(README.md,.gitignore,.env.example)。 - 源码目录 (src/):根据技术栈选择分层架构(Layered)或特性架构(Feature-based)。 - 文档目录 (docs/):预留位置。

  1. 生成文档:生成最终的 Markdown 文档。

输出模板 (Template)


项目结构

1. 目录树 (Directory Tree)

/
├── specs/                  # 项目核心定义 (产品/技术/结构/规范)
├── docs/                   # 项目文档
├── src/                    # 源代码
│   ├── modules/            # [基于 PRD 核心板块生成的模块]
│   │   ├── [模块A]/
│   │   └── [模块B]/
│   ├── shared/             # 共享代码 (Utils, Components)
│   └── [框架特定目录]       # (如 app/, pages/, cmd/)
├── tests/                  # 测试代码
├── .gitignore
├── README.md
└── [配置文件]               # (package.json, go.mod 等)

2. 关键文件说明 (Key Files)

  • package.json / go.mod: 项目依赖管理文件。
  • .env.example: 环境变量示例(禁止上传敏感信息)。
  • README.md: 项目入口文档,必须包含“如何启动”说明。

3. 模块说明 (Module Description)

  • src/modules/: 业务逻辑的核心。

- [模块A]: [描述] - [模块B]: [描述]

  • src/shared/: 通用工具,不包含具体业务逻辑。

4. 文件放置规则 (Placement Rules)

  • 页面/路由:放在 [框架特定路由目录]。
  • 业务逻辑:放在 src/modules/[对应模块],禁止直接写在 UI 组件中。
  • 通用组件:放在 src/shared/components。

交互准则

  • 适配性:目录结构必须符合所选技术栈的最佳实践(例如:Next.js 14 使用 app router,Django 使用 apps)。
- **最终交付**:当文档内容被用户确认后,请将其保存到 `specs/3_项目结构.md`。

平台分布

Codex

34.49%
按下载量换算48

Claude

30.43%
按下载量换算42

Cursor

16.95%
按下载量换算24

Gemini CLI

8.54%
按下载量换算12

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容,本身偏只读;真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills