finishlisted
Install: claude install-skill pkulijing/claude-code-global
用户调用此 skill 表示当前开发项已完成。
**参数处理**:先解析并剔除下列**收尾开关**,剩余 args 才当作用户对本次开发的额外说明(撰写 SUMMARY.md 时融入「局限性」「后续 TODO」「关键设计」等章节;无剩余则按常规总结)。
**收尾开关**(控制 Step 8,可组合;不带任何开关 = rebase + FF merge + 删 worktree + 删分支 + 删 backup tag 一站到底):
| 调用 | 8.2 rebase + 备份 tag | 8.3 FF merge | 删 worktree / 分支 | 删 backup tag |
| --- | --- | --- | --- | --- |
| `/finish`(默认) | ✓ | ✓ | ✓ | ✓ |
| `--no-merge` / `--keep-branch` | ✓ | ✗ | ✗ | ✗ |
| `--keep-backup` | ✓ | ✓ | ✓ | ✗ |
| `--no-rebase` | ✗ | ⚠️ 仅当已可 FF | (随其它开关) | (随其它开关) |
各开关**做什么以上表为准**,下面只说什么时候用它:
- `--no-merge`(同义 `--keep-branch`):发包 / 外审前想先留分支等 review,或本轮想继续迭代。
- `--keep-backup`:高风险轮想让 backup tag 多留几天兜底。
- `--no-rebase`:不想动历史;此时**只有分支相对主分支已可 FF 才会 merge**,否则停下提示。
开关可组合、语义叠加(`--no-merge --keep-backup` 与单 `--no-merge` 等价 —— 后者本就保留全部)。
## Step 1 · 撰写 SUMMARY.md
按宪法「总结」部分的要求,在 `docs/` 下当前开发项文件夹中撰写 `SUMMARY.md`(结合 args)。
末尾(「后续 TODO」之后)额外加一段 **「## 可沉淀项」**:反思本轮有没有**值得沉淀成跨项目资产 / 可复用流程**的经验,列出来并标注去向(判据见 Step 3)。无则写「暂无」,**不留空让人猜**。这是本地持久记录,Step 3 据此对跨项目项采取行动。
## Step 2 · 扫 SUMMARY 提示「刻意不做」项归档
需求以云端 issue 为单一真源,无本地索引文件。写完 SUMMARY 后扫「局限性」与「后续 TODO」段,问用户:
> 「上面有没有**刻意决定不做**的项要归档留痕(避免未来翻老 SUMMARY 误以为是遗漏)?」
用户给出条目 + 原因 → **归档为带 `wontfix` 的 closed issue**(与「issue 是真源」一致、可检索)。二选一:① 用户跑 `/backlog` 起 issue、三轴之外额外加 `wontfix`,建完随即 close;② 本步直接建:
```bash
python3 $HOME/.claude/scripts/platform_issue.py issue-create \
--title "刻意不做:<一句话>" --body-file /tmp/wontfix.md \
--label wontfix --label type:docs --label area:<Y> --label priority:P2
# 建完 close:gh