菜单
根据《软件工程目录规范》自动创建仓库级和工程级（C++）的完整目录结构及文档骨架。自动识别当前目录所属级别，仓库级则逐级向下完成全部初始化。当用户说"初始化项目结构"、"创建仓库目录"、"搭建工程结构"、"按规范创建目录"、"初始化docs"、"创建C++工程"时触发。增量创建，已存在的文件和目录不会覆盖。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/Herxinsasa/Skills-Collector --skill project-structure-init命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
在代码提交（svn commit / git commit）前，自动执行一套完整的审查与提交辅助流程： 1. 阅读项目 CLAUDE.md 了解项目功能模块背景； 2. 阅读编码规范约束（统一编码约束、Qt 命名规范、日志规范）； 3. 自动调用 code-review-skill 对已完成的改动进行结构化评审； 4. 输出评审报告+修改说明，提交给用户进行确认； 5. 用户确认修复完成后，输出本次修改说明。 使用时机：用户说"要提交代码了"、"帮我审一下改动"、"看看这些改动有什么问题"、"准备 commit / svn ci"、或者直接描述需要提交评审的场景时，**必须**触发本 skill。 注意：本 skill 不直接执行 commit / push 等命令，仅输出报告和提交说明，由用户手动执行提交。
分析系统与应用日志以定位问题根因的通用排查助手。支持多类型日志（文本日志 .log/.txt、结构化日志 .json、 Windows 事件日志 .evtx、性能监视器日志 .blg、崩溃转储 .dmp），并支持组合多类型日志做时间线关联的根因分析。 适用于工业生产软件、嵌入式系统、服务端应用等场景。 当用户提供日志目录/日志文件、说"分析这组日志"、"帮我看看日志出了什么问题"、"定位一下这个故障"、 "排查系统异常"、"日志诊断"、"问题分析"、或描述任何系统异常行为时主动触发。 分析前询问用户日志范围和问题描述，智能决定分析哪些日志，确保有上下文支撑。 分析完成后可按固定模板导出问题排查报告，支持用户自定义报告模板。
从已拆解的需求生成三种测试用例：AI自测用例（命令/接口级步骤+可验证断言，带完成勾选，供 AI 开发完自测）、系统测试用例（对齐正式测试模板，含测试用例类型与生命阶段）、人工自测用例（最简的步骤+预期结果+勾选）。当输入是已完成的需求拆解、功能规格、PRD 分析、用户故事、验收标准或模块/功能需求，且用户需要测试用例设计、场景扩展、覆盖检查，或可导出的 Markdown/Excel 测试用例文档时使用。
基于 SOC 职业分类
正在显示 SKILL.md
| name | project-structure-init |
| description | 根据《软件工程目录规范》自动创建仓库级和工程级（C++）的完整目录结构及文档骨架。自动识别当前目录所属级别，仓库级则逐级向下完成全部初始化。当用户说"初始化项目结构"、"创建仓库目录"、"搭建工程结构"、"按规范创建目录"、"初始化docs"、"创建C++工程"时触发。增量创建，已存在的文件和目录不会覆盖。 |
根据《软件工程目录规范 v1.0》，自动识别目录层级，为 C++ 项目创建标准化的仓库级和工程级目录结构及文档骨架。
projects/ 下的 C++ 子工程并逐个初始化取用户提供的路径，无则用当前工作目录。
按优先级判断：
| 条件 | 判定 | 后续动作 |
|---|---|---|
目录下存在 projects/ 子目录 | 仓库级 | 执行 Step 2 → Step 3（逐个初始化子工程） |
路径包含 projects/<name>/ 或存在 xmake.lua | 工程级（C++） | 执行 Step 3 |
存在 src/ + include/ 目录 | 工程级（C++） | 执行 Step 3 |
| 以上都不满足 | 不确定 | 询问用户：要初始化为仓库级还是工程级 |
仓库级初始化完成后，自动扫描 projects/ 下的所有子目录，对每个 C++ 子工程（存在 xmake.lua 或 src/ 目录）执行工程级初始化。已有的不重复创建。
如果目录是工程级，用户可选指定工程名；未指定则取当前目录名。
以目标路径为 <repo_root>，按以下顺序创建：
逐个检查并创建：
<repo_root>/
├── .gitignore ──── 标准 C++ 忽略规则（*.o *.obj *.exe *.dll *.so build/ bin/ lib/ .vs/ .vscode/ node_modules/ *.log *.pid .env）
├── README.md ──── 含标题和简介/技术栈/快速开始占位段落
├── CLAUDE.md ──── 含项目定位/技术栈/子工程清单/文档地图占位段落
├── docs/ ──── 目录，按 2.2 创建
├── scripts/ci/ ──── 目录 + .gitkeep
├── scripts/sql/ ──── 目录 + .gitkeep
├── tools/ ──── 目录 + .gitkeep
└── projects/ ──── 目录 + .gitkeep
CLAUDE.md 模板内容：
# [目录名] — AI 上下文入口
## 项目定位
<!-- 一句话描述该工程的用途 -->
## 技术栈
| 工程 | 语言 | 框架 |
|------|------|------|
| | | |
## 子工程清单
| 子工程 | 类型 | 职责 |
|--------|------|------|
| | C++ | |
## 文档地图
- `docs/` — 仓库级文档
- `projects/<name>/docs/` — 各子工程文档
README.md 模板内容：
# [目录名]
## 简介
<!-- 工程用途和定位 -->
## 技术栈
<!-- 主要技术栈 -->
## 快速开始
<!-- 构建和运行方式 -->
创建规则：每个目录/文件创建前先检查是否存在，已存在则跳过并记录。
读取 references/仓库级/ 下的目录树（用 find 或 ls -R），在 <repo_root>/docs/ 下创建完全相同的结构。
每个文件的创建逻辑：
<repo_root>/docs/<相对路径>references/仓库级/<相对路径> 的模板内容 → 写入目标文件原型设计/）创建 .gitkeep预期创建的完整结构（与 references/仓库级/ 对应）：
docs/
├── 01-总览/
│ ├── 系统架构总览.md
│ └── 目录结构.md
├── 02-需求/
│ ├── 需求规格说明书.md
│ └── 需求影响分析矩阵.md
├── 03-概设/
│ ├── 客户端概要设计.md
│ └── 服务端概要设计.md
├── 04-协议/
│ ├── 通信协议.md
│ ├── 数据格式规范.md
│ └── 全局错误码.md
├── 05-UI/
│ ├── UI设计规范.md
│ └── 原型设计/
├── 06-测试/
│ ├── 测试方案.md
│ └── 测试报告.md
└── 07-工程说明/
├── client.md
├── server.md
└── robot.md
对 projects/<工程名>/ 路径执行（仓库级级联时逐个执行此步骤）。
projects/<工程名>/
├── .gitignore ──── C++ 子工程忽略规则
├── README.md ──── 子工程说明模板
├── CLAUDE.md ──── AI 上下文入口模板
├── xmake.lua ──── 构建骨架
├── src/ ──── 目录
│ └── internal/ ──── 目录 + .gitkeep
├── include/ ──── 目录 + .gitkeep
├── config/ ──── 目录 + .gitkeep
├── scripts/ ──── 目录 + .gitkeep
├── test/ ──── 目录 + .gitkeep
└── docs/ ──── 目录，按 3.2 创建
CLAUDE.md 模板：
# [工程名] — AI 上下文入口
## 本工程架构
<!-- 分层描述或一句话概括 -->
## 关键约定
- 编码规范参见 `docs/02-规范/编码规范.md`
- 模块依赖参见 `docs/03-模块依赖/模块索引.md`
## 构建
```bash
xmake build
xmake run
docs/01-总览/ — 架构总览与目录结构docs/03-模块依赖/ — 模块依赖关系docs/04-设计/ — 功能设计文档
**xmake.lua 模板**：
```lua
add_rules("mode.debug", "mode.release")
target("[工程名]")
set_kind("binary")
add_files("src/*.cpp")
add_includedirs("include")
与仓库级 docs 创建方式相同，对照 references/工程级/ 创建：
docs/
├── 01-总览/
│ ├── 架构总览.md
│ └── 目录结构.md
├── 02-规范/
│ ├── 编码规范.md
│ ├── 错误码.md
│ └── 测试规范.md
├── 03-模块依赖/
│ ├── 模块索引.md
│ └── 示例模块/
│ └── README.md
└── 04-设计/
├── 架构设计.md
└── 应用设计/
├── 设计文档模板.md
└── 设计说明.md
## 初始化完成
**目标**: <repo_root>
**识别级别**: 仓库级 → 已级联 <N> 个 C++ 子工程
### 仓库级
已创建目录: <N> 个
已创建文件: <M> 个
已跳过 (已存在): <K> 项
### 工程级: <工程名1>
已创建目录: <N> 个
已创建文件: <M> 个
已跳过: <K> 项
### 工程级: <工程名2>
...
| 操作 | 已存在时 | 不存在时 |
|---|---|---|
| 创建目录 | 跳过，记录 [跳过] | mkdir -p |
| 创建文件 | 完全跳过，不读不写 | 读取 reference 模板 → 写入目标 |
| .gitkeep | 同上 | touch 空文件 |
references/仓库级/ 和 references/工程级/ 下，结构与目标路径一一对应Read 对应 reference 文件，将其全部内容写入目标文件references/软件工程目录规范_v1.0.md 是规范全文，创建前先读一遍作为总览.gitkeep 以纳入版本控制