maintain-looplisted
Install: claude install-skill nicholyx/ai-skills
# 维护闭环（maintain-loop）
本 skill 描述**任何按开源方式维护的项目**的日常迭代闭环。
**核心闭环**：`规划 → 实现 → 发布 → 继续规划`。每一轮迭代围绕一个主题
（如 v1.4.0 = 某条主线），走完一轮再开下一轮。
**规则部分优先级最高** —— 它们是踩过坑之后沉淀的，且与具体项目无关。
先读「硬规则」一节，再按阶段走。
> 本 skill 假设项目基建已就位（CI、治理文件、仓库自动化、看板）。
> **新项目从零搭建请先用 `oss-bootstrap` skill**，搭完再回到这里。
---
## 第零步：先探测项目（每次会话开始时）
**本 skill 不绑定任何具体仓库。** 下面这些先问清楚，后面的流程才落得下去：
```bash
gh repo view --json nameWithOwner --jq .nameWithOwner # owner/repo
ls scripts/lint.sh 2>/dev/null || echo "无统一入口" # 本地检查入口叫什么
git log --oneline -5 # 提交信息风格
head -20 CHANGELOG.md 2>/dev/null # CHANGELOG 格式与分类
gh label list --limit 30 # 标签体系
```
要确定的四件事：
1. **本地检查入口**：`./scripts/lint.sh`？`make check`？`npm test`？（本 skill 后文
统一写作 `<检查入口>`）
2. **提交规范**：Conventional Commits？有没有校验脚本？类型表在哪（通常在
`CONTRIBUTING.md`）
3. **CHANGELOG 格式**：Keep a Changelog？分类是哪几类？
4. **分支策略**：`main` 是否受保护？合并方式是 squash 还是 merge？
**项目自己的规范文档优先级高于本 skill**：`docs/MAINTAINER_GUIDE.md`、
`CONTRIBUTING.md`、`.trellis/spec/`（若项目用了 Trellis）。本 skill 是流程框架，
项目文档是细节的事实来源。
### 与 Trellis 的分工（若项目用了它）
Trellis 管「知识与任务上下文」，本 skill 管「GitHub 侧闭环」：
- 编码规范在 `.trellis/spec/`（会话自动注入）
- 任务 PRD 在 `.trellis/tasks/`（`task.py create/start/finish/archive`）
- 会话记忆在 `.trellis/workspace/`
- **Issue / 里程碑 / 看板 / PR / 发布仍走本 skill 的流程**——Trellis 不覆盖这些
一个开发任务 = 一个 Trellis task + 一个 GitHub Issue + 一个分支 PR。
踩坑沉淀的去向：**代码约定** → `.trellis/spec/`；**流程规则** → 本 skill。
---
## 一、盘点现状