Files
ChildHood/.claude/skills/project-initializer.md
T
starmen1265 6ba07318be docs(workflow): 工作流重构——3阶段状态机+独立审查代理+阶段技能体系
- 简化 game-pm:删除质量门审查和风险检测,改为进度检查+任务分配调度器
- 重写 game-reviewer:改为子代理模式,角色完成工作后自行启动,使用 ai-reviewer 账号
- 新增 project-initializer 技能:项目冷启动初始化
- 新增 stage-sketch/roadmap/iteration 技能:3 阶段任务序列管理
- 修改 game-designer/game-dev:添加审查交接流程
- 更新 gitea-collab/quality-gate-review/development-workflow
- gitea.js:添加 reviewer 角色 + 5 个新标签(review:pass/fail, stage:sketch/roadmap/iteration)
2026-06-07 23:49:58 +08:00

4.0 KiB
Raw Blame History

name, description
name description
project-initializer 项目初始化技能 — 检查版本管理/项目管理配置、初始化 Gitea 标签/里程碑/任务。仅在项目无进度时由 PM 调用。

项目初始化

本技能处理项目冷启动。在 PM 上下文中运行,完成后 PM 直接感知初始化结果。 仅在无 Pipeline Tracker 或无里程碑时触发。


初始化流程

步骤 1:版本管理确认

逐项确认以下内容:

  1. SSH 仓库地址:确认 git remote -v 中的仓库地址正确
  2. 角色 Gitea 账号:确认以下账号存在且可访问
    • starmen1265(用户)
    • ai-pm
    • ai-designer
    • ai-programmer
    • ai-artist
    • ai-reviewer
  3. SSH key 配置:运行 ssh -T git@micecola.top -p 2223 测试连接
    • 失败 → 引导用户生成并配置 SSH key

步骤 2:项目管理配置

确认以下配置就绪:

  1. Token 文件:scripts/.gitea-tokens.json 存在且包含所有角色 token
    • pm、designer、dev、artist、reviewer
  2. Token 文件已忽略:.gitignore 中包含 scripts/.gitea-tokens.json
  3. Gitea CLI 可用:node scripts/gitea.js --role pm test 运行通过

缺失时引导用户配置。

步骤 3:现有代码与需求检查

情况 A:有现有代码和需求

  • 探索 docs/ 和 Content/ 目录结构
  • 读取现有设计文档
  • 生成迁移方案:
    • 哪些文档可直接映射到新阶段
    • 哪些需要拆分或重写
    • 哪些可以作为已有产出直接关闭任务
  • 将迁移方案提交用户确认后执行

情况 B:无现有代码(全新项目)

  • 建议用户手动准备开发环境:
    1. 安装 UE 5.7.4
    2. 创建第三人称/第一人称/顶视角模板项目
    3. 添加插件:BlockoutStarterPack、LowpolyCharacter
    4. 启用 PythonEditorPlugins 插件
  • 等待用户确认环境就绪

步骤 4:Gitea 初始化

依次执行(所有操作需用户确认后再执行):

# 1. 创建标准标签
node scripts/gitea.js --role pm label init

# 2. 创建 Pipeline Tracker Issue
node scripts/gitea.js --role pm issue create \
  --title "Pipeline Tracker" \
  --body "# 流水线进度追踪

## 当前阶段
草图阶段

## 当前里程碑
- 名称: 草图阶段
- 状态: open
- Open Issues: 1
- Closed Issues: 0

## 阶段历史
| 阶段 | 里程碑 | 进入日期 | 完成日期 |
|------|--------|----------|----------|
| 草图阶段 | 草图阶段 | $(date +%Y-%m-%d) | — |" \
  --labels "stage:sketch,role:pm,status:in-progress"

# 3. 创建草图阶段里程碑
node scripts/gitea.js --role pm milestone create \
  --title "草图阶段" \
  --description "概念设计与技术可行性验证"

# 4. 创建第一个任务:概念设计
node scripts/gitea.js --role pm issue create \
  --title "D-001 概念设计" \
  --body "## 任务信息

- **任务ID**: D-001
- **所属阶段**: 草图阶段
- **角色**: 策划

## 预期产出

产出概念草案 \`docs/design/概念草案.md\`,包含以下 7 个必填字段:
1. 一句话概述(这是什么游戏)
2. 核心玩法(玩家做什么)
3. 美术风格
4. 目标平台
5. 灵感来源
6. 核心假设(为什么好玩)
7. 范围约束(MVP 包含什么)

## 质量标准

- 每个字段有明确的、不含糊的描述
- 美术风格有参考图或参考作品
- 核心假设可验证(能通过原型验证)" \
  --milestone "草图阶段" \
  --labels "stage:sketch,role:design,status:ready" \
  --assignees "ai-designer"

步骤 5:确认完成

初始化完成后向用户报告:

  • ✅ 版本管理配置状态
  • ✅ 项目管理配置状态
  • ✅ Gitea 初始化结果(标签数、Pipeline Tracker Issue 编号、里程碑、首个任务编号)
  • 📋 建议下一步:启动策划角色开始概念设计

注意事项

  • 每一步都需要用户确认后才执行,不自动推进
  • 如果中途失败(如 Gitea 连接失败),报告具体错误并建议修复方案
  • 初始化完成后,PM 进入草图阶段,后续由 stage-sketch 技能接管