Skip to content

docs: 新增维护者手册与 campusrunning-release 发版技能 - #67

Merged
YuShenLiu06 merged 1 commit into
mainfrom
docs/maintainer-handbook
Nov 4, 2026
Merged

YuShenLiu06 merged 1 commit into
mainfrom
docs/maintainer-handbook

Conversation

@YuShenLiu06

Copy link
Copy Markdown
Collaborator

摘要

将散落在 desktop-packaging.md 构建章节、release.yml 注释与脚本 docstring 中的构建/打包/发版知识,收敛为统一的维护者手册,并新增 AI 发版技能。

变更内容

docs/maintainer/ 维护者手册(面向人)

  • build.md 构建与打包:自 desktop-packaging.md 迁移重组,补 /D 注入、MSYS_NO_PATHCONV、完整重建规则等常见坑
  • release.md 发版全流程:CHANGELOG → tag(只打 main)→ CI 三 job 解读 → Release 验收,端到端 checklist;含预发布段名必须与 tag 一致(## [3.2.0-pr.1])等规则
  • tools.md 工具速查:sync_version / extract_changelog / make_icon 三脚本用法 + 外部工具链

desktop-packaging.md:裁剪为纯用户使用文档,与手册双向互链

README:文档节追加维护者手册入口

campusrunning-release 技能(面向 AI)

  • .claude/skills/ + .agents/skills/ 软链(随 campusrunning-cli 惯例)
  • 硬规则:外向动作授权前置、tag 只打 main 合入后提交、禁手动建/改 Release(正文由 extract_changelog 从 CHANGELOG 原样提取)、禁手改版本号三处
  • CHANGELOG 风格:中文段名固定顺序 新增→变更→修复(3.1.2 的英文段名为偏差)
  • 已用子代理干跑验证:正确加载、在授权停点停下

待确认(不在本 PR 修改)

README L45 的 Releases 链接指向 YuShenLiu06/CampusRunning,而 desktop-packaging.md 指向 EmberCollective/CampusRunning,两处不一致,需要确认哪个是期望的下载入口后另行修正。

测试

  • 全仓无死锚点(构建指南开发者 0 命中)
  • 迁移无丢失:旧构建指南 8 个命令块在新手册均有着落
  • 手册链接可达;技能 frontmatter 正常解析(本会话已识别加载)
  • 技能干跑验证通过(授权停点 + 规程引用正确)

- docs/maintainer/ 三篇:构建与打包(自 desktop-packaging.md 迁移重组+常见坑)、发版全流程(CHANGELOG/tag/CI/Release 端到端)、工具速查
- desktop-packaging.md 回归纯用户文档,双向互链;README 文档节加入口
- 新增 .claude/skills/campusrunning-release 发版技能(授权停点、tag 只打 main、Release 正文自动来自 CHANGELOG、中文段名规范)+ .agents/skills 软链
@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ⚠️ Failed 2026-11-04T04:07:28.325261Z
We couldn’t complete this review. Comment @codex review to try again.
bb58b9a PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@YuShenLiu06
YuShenLiu06 merged commit 7f7d8d2 into main Nov 4, 2026
1 check passed
@YuShenLiu06
YuShenLiu06 deleted the docs/maintainer-handbook branch November 4, 2026 04:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant