القائمة
根据《软件工程目录规范》自动创建仓库级和工程级（C++）的完整目录结构及文档骨架。自动识别当前目录所属级别，仓库级则逐级向下完成全部初始化。当用户说"初始化项目结构"、"创建仓库目录"、"搭建工程结构"、"按规范创建目录"、"初始化docs"、"创建C++工程"时触发。增量创建，已存在的文件和目录不会覆盖。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Generate comprehensive test cases from already analyzed or decomposed requirements specifications. Use when the input is a completed requirements breakdown, feature specification, PRD analysis, user story map, acceptance criteria list, or module/function requirements and the user wants test case design, scenario expansion, module-based test flows, coverage review, or exportable test case documents in Markdown, Excel/XLSX, CSV, or document formats.
Use when refining an architecture or design document based on new learnings, before a rewrite. Use when you have an existing doc and related docs to cross-check against. Use when you need systematic section-by-section validation of decisions.
项目文档的全生命周期管理。支持：初始化文档（按阶段+范围选择性生成）、更新文档（扫描代码对比，输出差异并更新）。范围可指定仅仓库级/指定子工程/全部。与 project-structure-init 配合使用但不强制依赖。当用户说"初始化文档"、"更新文档"、"生成文档"、"补文档"、"刷新文档"、"同步文档与代码"、"检查文档"、"只初始化仓库级"、"只更新某个文档"时触发。
系统性技术问题诊断框架。通过"边界收敛→分支诊断→假设验证→证据链→方案决策"五步法，将试错式排查变为结构化分析。当用户说"分析这个问题"、"报错了帮我看看"、"定位一下根因"、"帮我分析一下这个现象"、"这个Bug怎么查"、"内存泄漏/崩溃/性能退化/死锁怎么定位"、或描述了任何软件异常现象时触发。不用于产品需求分析或日常决策（那是 structured-thinking 的范畴）。
编写 C++ 项目的详细设计文档和设计变更影响面分析。当用户说要写详细设计、生成设计文档、做影响面分析、描述功能需求要写设计、或者说"把这个需求的设计写出来"时触发。也用于增量更新已有设计文档、以及清除迭代标记输出最终版。
在代码提交（svn commit / git commit）前，自动执行一套完整的审查与提交辅助流程： 1. 阅读项目 CLAUDE.md 了解项目功能模块背景； 2. 阅读编码规范约束（统一编码约束、Qt 命名规范、日志规范）； 3. 自动调用 code-review-skill 对已完成的改动进行结构化评审； 4. 输出评审报告+修改说明，提交给用户进行确认； 5. 用户确认修复完成后，输出本次修改说明。 使用时机：用户说"要提交代码了"、"帮我审一下改动"、"看看这些改动有什么问题"、"准备 commit / svn ci"、或者直接描述需要提交评审的场景时，**必须**触发本 skill。 注意：本 skill 不直接执行 commit / push 等命令，仅输出报告和提交说明，由用户手动执行提交。
استنادا إلى تصنيف SOC المهني
| 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 以纳入版本控制