maintain-loop SKILL.md skillA

maintain-loop from nicholyx/ai-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nicholyx/ai-skills/maintain-loop@git:20260930.16f0140

Pins git:20260930.16f0140 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nicholyx/ai-skills
Path
custom/daily/maintain-loop/SKILL.md
Versions recorded
4
Latest version
git:20260930.16f0140, committed Sep 30, 2026
First version recorded
Sep 23, 2026
Size
18,991 bytes
Repository stars
6
License
Apache-2.0

开源项目的维护闭环流程——规划、实现、发布、继续规划的完整循环,以及踩坑沉淀的硬规则。当需要在项目中继续迭代(新功能、修缺陷、补文档)、发布新版本、盘点未完成事项,或有人说「继续」「走维护流程」「按开源流程开发」时使用。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 维护闭环(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 侧闭环」:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nicholyx/ai-skills/maintain-loop@sha256:da04810b08830580

The line at the top of this page pins the label git:20260930.16f0140, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_l6gbxhwrdmj7ehal.svg)](https://markdownregistry.com/a/art_l6gbxhwrdmj7ehal)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Sep 23, 2026 and Sep 30, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20260930.16f0140 latest2026-09-30 16f0140 18,991 BA view · diff
git:20260928.d37ee902026-09-28 d37ee90 18,877 BA view · diff
git:20260924.7ec440f2026-09-24 7ec440f 18,715 BA view · diff
git:20260923.6b60ef92026-09-23 6b60ef9 17,329 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (18991 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nicholyx/ai-skills · 6 stars · license Apache-2.0 · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_l6gbxhwrdmj7ehal
GET https://markdownregistry.com/api/v1/resolve?ref=nicholyx/ai-skills/maintain-loop
GET https://markdownregistry.com/api/v1/blob/da04810b08830580ecacc54213160c51026d6f832485f6b2ef3b1b708f5dedae

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nicholyx/ai-skills

agent-browser SKILL.md skill
nicholyx/ai-skills · .agents/skills/agent-browser/SKILL.md · Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages…
git:20260516.dd241a9 · audit A · 6 stars
architecture-designer SKILL.md skill
nicholyx/ai-skills · .agents/skills/architecture-designer/SKILL.md · Use when designing new high-level system architecture, reviewing existing designs, or making architectural decisions…
v1.1.1 · audit A · 6 stars
architecture-patterns SKILL.md skill
nicholyx/ai-skills · .agents/skills/architecture-patterns/SKILL.md · Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven…
git:20260516.dd241a9 · audit A · 6 stars
browser-use SKILL.md skill
nicholyx/ai-skills · .agents/skills/browser-use/SKILL.md · Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs…
git:20260516.dd241a9 · audit A · 6 stars
deep-research SKILL.md skill
nicholyx/ai-skills · .agents/skills/deep-research/SKILL.md · Use when the user needs multi-source research with citation tracking, evidence persistence, and structured report…
git:20260516.dd241a9 · audit A · 6 stars
docx SKILL.md skill
nicholyx/ai-skills · .agents/skills/docx/SKILL.md · Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers…
git:20260516.4d9ab13 · audit A · 6 stars
enhance-prompt SKILL.md skill
nicholyx/ai-skills · .agents/skills/enhance-prompt/SKILL.md · Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects…
git:20260516.4d9ab13 · audit A · 6 stars
AGENTS.md@.agents/skills/extension-dev-skill AGENTS.md file
nicholyx/ai-skills · .agents/skills/extension-dev-skill/AGENTS.md
git:20260516.9c51e17 · audit A · 6 stars
extension-dev-skill SKILL.md skill
nicholyx/ai-skills · .agents/skills/extension-dev-skill/SKILL.md · AI Skill for building EasyEDA Pro extension plugins. Used when users need to create, modify, or debug EasyEDA Pro…
v2.0.0 · audit A · 6 stars
find-skills SKILL.md skill
nicholyx/ai-skills · .agents/skills/find-skills/SKILL.md · Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is…
git:20260516.4d9ab13 · audit A · 6 stars
frontend-design SKILL.md skill
nicholyx/ai-skills · .agents/skills/frontend-design/SKILL.md · Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to…
git:20260516.4d9ab13 · audit A · 6 stars
gh-cli SKILL.md skill
nicholyx/ai-skills · .agents/skills/gh-cli/SKILL.md · GitHub CLI (gh) comprehensive reference for repositories, issues, pull requests, Actions, projects, releases, gists…
git:20260516.4d9ab13 · audit A · 6 stars

Every file in nicholyx/ai-skills

Browse by kind, by grade A, or by owner.