mcpp-release SKILL.md skillA

mcpp-release from mcpp-community/mcpp is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mcpp-community/mcpp/mcpp-release@git:20261002.1bb5ea3

Pins git:20261002.1bb5ea3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mcpp-community/mcpp
Path
.agents/skills/mcpp-release/SKILL.md
Versions recorded
7
Latest version
git:20261002.1bb5ea3, committed Oct 2, 2026
First version recorded
Jul 31, 2026
Size
18,669 bytes
Repository stars
197
License
Apache-2.0

Use when releasing a new version of mcpp — bumps version, creates tag, triggers release CI, and monitors until all platforms succeed. Covers the full release checklist to avoid common pitfalls like version string mismatches.

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

# mcpp 版本发布流程

## 版本号规范

**格式:`YYYY.M.D.N`**(日期版本,月/日不补零),例如 `2026.7.27.1`。
自 `2026.7.27.1` 起启用,此前为 `0.0.x`。与 xlings 生态一致(xlings 于同日从 `0.4.70` 迁入)。

第 4 段的语义:

> **`.0` 保留给正式版本 / 稳定版本。日常迭代默认从 `.1` 开始。**

即一天内可发 `.1`、`.2`、`.3` …… 若干次常规版本;`.0` 只在该版本被认定为正式 release 或稳定版时使用。

跨方案的序是单调的:`0.0.109` < `2026.7.27.1`,第一段从 `0` 变 `2026`,不存在回退。

> 比较逻辑见 `src/version_req.cppm`。它支持 4 段;**改动那里时务必保证 `str()` 精确回写**,
> `src/pm/resolver.cppm` 用它重建依赖版本串,会流向 lock 文件与 xlings wire 地址。
> 尤其 `.0` 结尾的版本不能塌成三段。

## Overview

mcpp 有 **三个持久化版本位置**,以及 `ci-fresh-install` 的一个运行时推导值。它们分属
两组,在不同时间更新;把"正在构建的版本"与 bootstrap pin 一起前移会让 CI 尝试安装
尚未发布的 mcpp。

**第一组:正在构建的版本**(发布时改,走 bump PR)

1. `mcpp.toml` → `[package].version` — 构建系统读取的项目版本,release.yml 由它推导 tag
2. `src/version.cppm` → `MCPP_VERSION` — 编译期硬编码常量(`--version` 输出、BMI 指纹、E0006 索引底线比较)

这两处必须**在同一个 commit 里**一起改:`tests/e2e/01_help_and_version.sh` 交叉比对
`mcpp.toml` 与 `mcpp --version`,只改一处 CI 立刻红。

**第二组:bootstrap pin —— CI 用哪个 mcpp 来自举**(发布并进索引之后才可改)

3. `.xlings.json` → `workspace.mcpp` — CI bootstrap 装哪个 mcpp

`.xlings.json` 必须指向一个**已经发布、镜像并进入索引**的版本。因此它在 bump PR 中
保持已有的可安装版本,直到发布收尾时才可前移。

`ci-fresh-install.yml` 的 `MCPP_PIN` 不是持久化 pin:`wait-index` 从最新 GitHub
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mcpp-community/mcpp/mcpp-release@sha256:af0e1acfa0a91857

The line at the top of this page pins the label git:20261002.1bb5ea3, 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_lm6ovdcl5g4g62zf.svg)](https://markdownregistry.com/a/art_lm6ovdcl5g4g62zf)

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

Versions

The registry has recorded 7 versions of this file, between Jul 31, 2026 and Oct 2, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261002.1bb5ea3 latest2026-10-02 1bb5ea3 18,669 BA view · diff
git:20260928.6410eaa2026-09-28 6410eaa 18,639 BA view · diff
git:20260905.5922be22026-09-05 5922be2 18,541 BA view · diff
git:20260811.c402dd42026-08-11 c402dd4 16,133 BA view · diff
git:20260803.44479d02026-08-03 44479d0 16,085 BA view · diff
git:20260803.a01fdd42026-08-03 a01fdd4 16,127 BA view · diff
git:20260731.f4a75682026-07-31 f4a7568 16,242 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 (18669 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

mcpp-community/mcpp · 197 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lm6ovdcl5g4g62zf
GET https://markdownregistry.com/api/v1/resolve?ref=mcpp-community/mcpp/mcpp-release
GET https://markdownregistry.com/api/v1/blob/af0e1acfa0a918576efd5ddb1b09db74c0e96409d284288c734d7e63131cec6d

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 mcpp-community/mcpp

mcpp-contributing SKILL.md skill
mcpp-community/mcpp · .agents/skills/mcpp-contributing/SKILL.md · Use when contributing to the mcpp project — submitting bug fixes, new features, code optimizations, documentation…
git:20261028.e0b1133 · audit A · 197 stars
mcpp-docs-style SKILL.md skill
mcpp-community/mcpp · .agents/skills/mcpp-docs-style/SKILL.md · Use when writing or editing anything under docs/ (English or 简体中文), docs/specs/, README files, or the design records…
git:20260908.9a71c9a · audit A · 197 stars
mcpp-usage SKILL.md skill
mcpp-community/mcpp · .agents/skills/mcpp-usage/SKILL.md · Use when helping users install, configure, or use mcpp — the C++23 modular build tool. Covers installation, project…
git:20261023.d5ec182 · audit B · 197 stars

Every file in mcpp-community/mcpp

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