القائمة
自动分析项目状态、检测开发阶段、识别缺失项，并根据现有工件推荐后续步骤。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | project-stage-detect |
| description | 自动分析项目状态、检测开发阶段、识别缺失项，并根据现有工件推荐后续步骤。 |
| argument-hint | [可选: 角色过滤器，如 'programmer' 或 'designer'] |
| user-invocable | true |
| allowed-tools | Read, Glob, Grep, Bash |
本技能扫描你的项目以确定其当前开发阶段、工件的完整性以及需要关注的缺失项。特别适用于以下场景：
分析项目结构和内容：
设计文档（design/）：
design/gdd/*.md 中的 GDD 文件数design/narrative/ 中的叙事文档数design/levels/ 中的关卡设计数源代码（src/）：
生产工件（production/）：
原型（prototypes/）：
架构文档（docs/architecture/）：
测试（tests/）：
根据扫描的工件确定阶段。先检查 production/stage.txt —
如果存在，使用其值（来自 /gate-check 的显式覆盖）。否则，
使用以下启发式规则自动检测（从最高阶段向前检查）：
| 阶段 | 指标 |
|---|---|
| 概念 | 无游戏概念文档，处于头脑风暴阶段 |
| 系统设计 | 游戏概念存在，系统索引缺失或不完整 |
| 技术搭建 | 系统索引存在，引擎未配置 |
| 预制作 | 引擎已配置，src/ 不到 10 个源文件 |
| 制作 | src/ 有 10 个以上源文件，活跃开发中 |
| 打磨 | 仅限显式设置（由 /gate-check 制作 -> 打磨关卡设置） |
| 发布 | 仅限显式设置（由 /gate-check 打磨 -> 发布关卡设置） |
不要只是列出缺失的文件。而是提出澄清问题：
src/gameplay/combat/）但没有 design/gdd/combat-system.md。这是先做的原型，还是应该进行逆向文档化？"production/ 中没有 Sprint 计划。你在其他地方跟踪工作吗（Jira、Trello 等）？"/map-systems？"使用模板：.claude/docs/templates/project-stage-report.md
报告结构：
# 项目阶段分析
**日期**：[日期]
**阶段**：[概念/系统设计/技术搭建/预制作/制作/打磨/发布]
## 完整性概览
- 设计：[X%]（[N] 个文档，[缺失项]）
- 代码：[X%]（[N] 个文件，[系统]）
- 架构：[X%]（[N] 个 ADR，[缺失项]）
- 生产管理：[X%]（[状态]）
- 测试：[X%]（[覆盖率估算]）
## 识别的缺失项
1. [缺失项描述 + 澄清问题]
2. [缺失项描述 + 澄清问题]
## 推荐后续步骤
[根据阶段和角色按优先级排列的列表]
如果用户提供了角色参数（例如 /project-stage-detect programmer）：
程序员：
设计师：
制作人：
通用（无角色）：
协作协议：
我已经分析了你的项目。以下是我的发现：
[展示摘要]
识别的缺失项：
1. [缺失项 1 + 问题]
2. [缺失项 2 + 问题]
推荐后续步骤：
- [优先级 1]
- [优先级 2]
- [优先级 3]
可以将完整的阶段分析写入 production/project-stage-report.md 吗？
等待用户批准后再创建文件。
# 通用项目分析
/project-stage-detect
# 程序员视角分析
/project-stage-detect programmer
# 设计师视角分析
/project-stage-detect designer
生成报告后，建议相关的后续步骤：
/map-systems 拆解为系统/reverse-document design src/[系统]/architecture-decision 或 /reverse-document architecture/reverse-document concept prototypes/[名称]/sprint-plan/milestone-review本技能遵循协作设计原则：
绝不要静默写入文件。始终先展示发现并询问再创建工件。
创建架构决策记录（Architecture Decision Record, ADR），记录重大技术决策及其背景、备选方案和影响后果。每个重大技术选择都应有对应的 ADR。
根据描述创建结构化的缺陷报告，或分析代码以识别潜在缺陷。确保每份缺陷报告包含完整的复现步骤、严重程度评估和上下文信息。
通过分析复杂度、依赖关系、历史速度和风险因素来估算任务工作量。生成包含置信水平的结构化估算。
运行本地化工作流：提取字符串、验证本地化就绪状态、检查硬编码文本，并生成可供翻译的字符串表。
将游戏概念拆解为独立系统，映射依赖关系，确定设计优先级，并创建系统索引。
生成全面的里程碑进度审查，包括功能完成度、质量指标、风险评估和推进/暂停建议。在里程碑检查点或评估里程碑截止日期的准备情况时使用。