メニュー
根据《软件工程目录规范》自动创建仓库级和工程级（C++）的完整目录结构及文档骨架。自动识别当前目录所属级别，仓库级则逐级向下完成全部初始化。当用户说"初始化项目结构"、"创建仓库目录"、"搭建工程结构"、"按规范创建目录"、"初始化docs"、"创建C++工程"时触发。增量创建，已存在的文件和目录不会覆盖。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
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 以纳入版本控制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 等命令，仅输出报告和提交说明，由用户手动执行提交。