需要按模板撰写 PRD、做 8 项格式校验并通过…

在已安装并认证 gh CLI、拥有目标 GitHub 仓库 push 权限的环境中，快速完成 PRD 起草、格式验证和 PR 提交。

适用场景

解决思路

1. 启动时先做环境预检：运行 `git --version`、`gh --version`、`gh auth status`、`git remote -v`，把结果显示给参与者（git 是否安装、gh CLI 是否安装、GitHub 登录用户、项目仓库 URL）。任一项失败就按失败项解决，全部通过前不要进入下一步。
2. Step 0 失败处理：git 未安装 → 让用户联系运营/管理员；gh CLI 未安装 → macOS 让用户执行 `brew install gh`，失败则联系运营；gh 未认证 → 让用户执行 `gh auth login` 并按提示用 GitHub 账号登录；repo 未连接 → 让用户执行 `gh repo clone {owner/repo}`。
3. Step 1 用 Step 0 中 `gh auth status` 检测到的 GitHub ID 向用户确认：问“GitHub 用户名是 '{detected-id}' 吗？”；若不对则让用户直接输入。
4. 验证 GitHub ID 格式：只允许英文字母、数字、连字符 `-`；包含特殊字符、空格、斜杠等则提示后重新输入；输入后规范化为小写。
5. 用规范化后的 ID 生成后续路径和分支名：文件 `{github-id}/PRD.md`，分支 `prd/{github-id}`。
6. Step 2 用 AskUserQuestion 询问当前状态：选择“PRD 新写”进入 Step 2-A，选择“验证已有 PRD”进入 Step 2-B。
7. Step 2-A 先展示 PRD 模板，再问项目主题：基于 camp 中创建的 skill、业务自动化想法、或直接输入。若选“基于 camp 创建的 skill”，扫描 `.claude/skills/` 目录，列出参与者创建的 skill 供选择。
8. Step 2-A 根据用户回答生成 PRD 草稿。
9. Step 2-A 将草稿输出到终端并询问：选“就这样继续”则保存到 `{github-id}/PRD.md` 并进入 Step 2-B；选“想修改”则询问修改哪部分（问题定义 / 技能列表 / 变化记录），应用后重新输出草稿。
10. Step 2-A 重要约束：PRD 内容要反映参与者的真实经验和项目，不要用泛化示例；引导写入 camp 中创建的 skill、真实业务问题。
11. PRD 模板按以下结构写：`# [프로젝트 제목]`；`## 문제`；`> 한 줄: 누구의, 어떤 불편을, 어떻게 해결하는가`；`- **현재 상태**: (구체적 수치 — 몇 건, 몇 분, 몇 명)`；`- **원하는 상태**: (1주 후 돌아가고 있을 모습)`；`- **성공 기준**: (숫자로 판단 가능한 것 1~2개)`；`## 스킬` 表格含 `#`、`스킬명`、`한 줄 설명`、`상태`，行如 `| 1 | /my-skill-1 | 입력 → 출력 | ✅ 동작 / 🔨 진행중 |`；`## 변화 기록` 含 `- **Day 1**: "처음 정의" →`、`- **Day 6**: "지금 정의" →`、`- **가장 크게 달라진 점**:`。
12. Step 2-B 读取 `{github-id}/PRD.md`，按 8 项检查表验证：1) 项目标题：第一个 `#` 开头的大标题存在；2) 问题节：`## 문제` 标题存在；3) 当前状态：`현재 상태` 文本存在且至少 10 个字符；4) 期望状态：`원하는 상태` 文本存在且至少 10 个字符；5) 成功标准：`성공 기준` 文本存在且至少 10 个字符；6) 技能节：`## 스킬` 标题存在；7) 技能至少 2 个：技能表中以 `| 1 |`、`| 2 |` 等编号开头的 data row 至少 2 行（不含表头行和分隔线）；8) 变化记录：`## 변화 기록` 标题存在。
13. 输出验证结果：显示 `[PASS]` 或 `[需要补充]`，逐项用 ✅/❌ 列出 8 项，并显示 `结果: 8/8 通过 → PASS`。
14. 需要补充时，指出缺失项并给具体示例，例如成功标准太短时提示“请包含具体数字：每周使用 3 次，单件处理时间 30 分钟 → 5 分钟”。
15. Step 3 在验证 PASS 后询问是否提交到 GitHub：选项为“是，提交（推荐）”和“之后再做”。选“之后再做”则提示“准备好时重新运行此技能”后结束。
16. 选择提交后按 5 步输出进度并执行：[1/5] 同步最新状态：`git checkout main && git pull origin main`；[2/5] 创建提交空间：`git checkout -b prd/{github-id}`；若分支已存在则用 `git checkout prd/{github-id}` 切换；[3/5] 注册 PRD 文件：`git add {github-id}/PRD.md`；并用 `git status` 确认暂存的只有 `{github-id}/PRD.md` 这 1 个文件，若混入其他文件则 unstage 对应文件；[4/5] 保存：`git commit -m "feat: {github-id} PRD 초안 제출"`；[5/5] 上传到 GitHub：`git push origin prd/{github-id}`。
17. push 完成后用 gh CLI 创建 PR：`gh pr create --repo {owner/repo} --title "PRD: {github-id}" --body "$(cat <<'EOF' ## PRD 초안 제출 - 작성자: {github-id} - 파일: {github-id}/PRD.md 검증 결과: PASS (8/8) EOF )"`。
18. 创建 PR 后输出 PR URL 并告知完成。
19. 完成报告包含：GitHub ID、文件 `{github-id}/PRD.md`、分支 `prd/{github-id}`、验证 `PASS (8/8)`、PR URL，并告知“已向 GitHub 提交第一个 PR，运营/管理员确认后会批准”。
20. 错误处理：git 未安装 → 让用户联系运营/管理员；gh CLI 未安装 → `brew install gh`，失败则联系运营；gh 未认证 → `gh auth login` 并用 GitHub 账号登录；`PRD.md` 文件不存在 → 问“还没有 PRD 文件，要先写吗？”；验证需补充 → 给缺失项、具体示例并帮助修改；git 分支已存在 → 自动切到已有分支；push 失败（认证）→ 让用户执行 `gh auth login`；push 失败（权限）→ 告知没有提交权限，让用户在 Slack 给运营 `@zoon` 发“권한이 필요합니다”；repo 未 clone → 让用户执行 `gh repo clone {owner/repo}`；GitHub ID 格式错误 → 告知只能使用英文字母、数字、连字符 `-`。
21. 输出位置：PRD 文件固定写入 `{github-id}/PRD.md`。
22. 按 Step 0 环境检查（~1 分钟）、Step 1 GitHub ID 确认（~1 分钟）、Step 2 PRD 编写/验证（~10 分钟）、Step 3 提交 git + PR（~3 分钟）推进；环境已设置时总计约 15 分钟，环境问题则 +5~10 分钟。

适用边界 · 注意事项

• 没有 GitHub 账号、gh CLI 或目标仓库 push 权限时。
• 不想使用固定 PRD 模板和 8 项校验，或不需要通过 GitHub PR 提交时。
• 只想写 PRD 而不提交 GitHub 时（可只参考 Step 2，但该技能目标是提交 PR）。