smallnest/goal-workflow/ship-it

# 1a. 检查变更状态
git status
git diff --stat HEAD
 
# 1b. 暂存本次 Issue 相关的文件（不要 add 不相关的文件）
git add <files related to this issue>
 
# 1c. 提交，commit message 关联 Issue
git commit -m "$(cat <<'EOF'
{简要描述} (#issue-number)
 
{可选的详细说明}
EOF
)"

# 如果还在 main/master 上，先创建功能分支
git checkout -b {branch-name}  # 如已在功能分支则跳过
 
# 推送到远程
git push -u origin {branch-name}

gh pr create \
  --title "{简要描述}" \
  --body "$(cat <<'EOF'
## Summary
- 实现内容概述
 
Closes #{issue-number}
 
## Test plan
- [ ] 测试项 1
- [ ] 测试项 2
EOF
)"

# 4a. 查看 PR 状态（确认 checks 通过）
gh pr checks
 
# 4b. 合入（默认 merge commit，可选 --squash 或 --rebase）
gh pr merge --squash --delete-branch

gh issue comment {issue-number} --body "$(cat <<'EOF'
## 实现总结
 
**核心变更**
- {从 PR body Summary 提取的实现摘要，3-5 条 bullet}
 
**实现亮点（Highlights）**
- {值得强调的技术亮点：性能优化、优雅设计、复用抽象、关键测试覆盖等}，或 None
 
**设计决策（Design Decisions）**
- {spec 模糊/未定处所做的选择及理由}，或 None
 
**偏离（Deviations）**
- {有意偏离 spec 之处：spec 怎么说 → 实际怎么做 → 为什么}，或 None
 
**权衡（Tradeoffs）**
- {考虑过的备选方案及最终选择的原因}，或 None
 
**待确认（Open Questions）**
- {需用户确认的假设或后续跟进项}，或 None
 
---
- **PR**: #{pr-number}
- **Commit**: {hash}
EOF
)"

gh issue close {issue-number} --reason completed

# 创建分支并提交
git checkout -b feat/issue-42-case-model
git add cases/case.go cases/case_test.go
git commit -m "$(cat <<'EOF'
Add Case data model and Markdown read/write (#42)
 
Define Case struct with YAML frontmatter + Markdown body
serialization. Provide WriteCase/ReadCase/ListCases/UpdateCase.
EOF
)"
 
# 推送
git push -u origin feat/issue-42-case-model
 
# 创建 PR
gh pr create \
  --title "Add Case data model and Markdown read/write" \
  --body "$(cat <<'EOF'
## Summary
- Define Case struct with YAML frontmatter + Markdown body
- Implement WriteCase/ReadCase/ListCases/UpdateCase functions
- Add comprehensive test coverage
 
Closes #42
 
## Test plan
- [x] Unit tests pass
- [x] go vet / lint clean
EOF
)"
 
# 确认 checks 通过后合入
gh pr checks
gh pr merge --squash --delete-branch
 
# 添加实现总结评论（参考 note-it 四类结构）
gh issue comment 42 --body "$(cat <<'EOF'
## 实现总结
 
**核心变更**
- Define Case struct with YAML frontmatter + Markdown body
- Implement WriteCase/ReadCase/ListCases/UpdateCase
 
**实现亮点（Highlights）**
- 单文件自包含存储，读写无需外部索引，测试覆盖率 100%
 
**设计决策（Design Decisions）**
- Markdown body 与 YAML frontmatter 分离存储，便于人工编辑与 diff
 
**偏离（Deviations）**
- None — 实现与 spec 一致
 
**权衡（Tradeoffs）**
- 选用 frontmatter 而非独立 JSON 元数据：单文件自包含，牺牲了少量解析性能
 
**待确认（Open Questions）**
- None
 
---
- **PR**: #43
- **Commit**: abc1234
EOF
)"
 
# 切回主分支
git checkout main
git pull