Chamilo Changelog Updater
chamilo/chamilo-lms
Adds commits for a new Chamilo release to the changelog page, classifying them into categories and skipping those already listed for that version.
A skill your agent uses when preparing to publish a new version of a PHP Composer package and need to write or update CHANGELOG, upgrade guides, and documentation before tagging and releasing
$ npx skills add yansongda/pay --skill releasing-php-package -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install yansongda/pay releasing-php-package --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/yansongda/pay.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/releasing-php-package .claude/skills/releasing-php-package && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "releasing-php-package" agent skill from https://github.com/yansongda/pay/tree/master/.agents/skills/releasing-php-package into .claude/skills/releasing-php-package/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "releasing-php-package", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/yansongda/pay/tree/master/.agents/skills/releasing-php-packageType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add yansongda/pay --skill releasing-php-package -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install yansongda/pay releasing-php-package --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yansongda/pay.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/releasing-php-package .agents/skills/releasing-php-package && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "releasing-php-package" agent skill from https://github.com/yansongda/pay/tree/master/.agents/skills/releasing-php-package into .agents/skills/releasing-php-package/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "releasing-php-package", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add yansongda/pay --skill releasing-php-package -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install yansongda/pay releasing-php-package --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yansongda/pay.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/releasing-php-package .cursor/skills/releasing-php-package && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "releasing-php-package" agent skill from https://github.com/yansongda/pay/tree/master/.agents/skills/releasing-php-package into .cursor/skills/releasing-php-package/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "releasing-php-package", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/yansongda/pay.git --path .agents/skills/releasing-php-package--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add yansongda/pay --skill releasing-php-package -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install yansongda/pay releasing-php-package --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yansongda/pay.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/releasing-php-package .gemini/skills/releasing-php-package && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "releasing-php-package" agent skill from https://github.com/yansongda/pay/tree/master/.agents/skills/releasing-php-package into .gemini/skills/releasing-php-package/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "releasing-php-package", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install yansongda/pay releasing-php-packageInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add yansongda/pay --skill releasing-php-package -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/yansongda/pay.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/releasing-php-package .github/skills/releasing-php-package && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "releasing-php-package" agent skill from https://github.com/yansongda/pay/tree/master/.agents/skills/releasing-php-package into .github/skills/releasing-php-package/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "releasing-php-package", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add yansongda/pay --skill releasing-php-package -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install yansongda/pay releasing-php-package --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/yansongda/pay.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/releasing-php-package .opencode/skills/releasing-php-package && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "releasing-php-package" agent skill from https://github.com/yansongda/pay/tree/master/.agents/skills/releasing-php-package into .opencode/skills/releasing-php-package/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "releasing-php-package", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
releasing-php-packageA skill your agent uses when preparing to publish a new version of a PHP Composer package and need to write or update CHANGELOG, upgrade guides, and documentation before tagging and releasing
Releasing Php Package is an agent skill from yansongda/pay. Use when preparing to publish a new version of a PHP Composer package and need to write or update CHANGELOG, upgrade guides, and documentation before tagging and releasing
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Changelog and release notes and Code migrations. It works with PHP, WeChat and Git. The repository describes itself as: 可能是我用过的最优雅的 Alipay/WeChat/Douyin/Unipay/江苏银行 的支付 SDK 扩展包了. The licence is MIT.
7 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 37cf0c1. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
gitghcomposerFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Releasing Php Package loads about 1.6k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 425 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from yansongda/pay at commit 37cf0c1, republished under its MIT licence (© yansongda). 425 words, ~1,626 tokens.
.claude/skills/releasing-php-package/SKILL.md (or your agent's skills folder).用于发布 PHP Composer 包的结构化流程,避免 CHANGELOG 格式混乱、升级指南缺失、文档示例过期等常见问题,并强制要求在打 tag 前通过独立分支 + PR 完成文档改动。
硬性约束(违反即流程无效):
gh pr merge、平台合并 API 等任何形式的自动合并)不要使用:
| 变更类型 | 版本号变化 | 是否需要升级指南 |
|---|---|---|
| 仅 Bug 修复 | Patch(1.0.X) | 否 |
| 新功能,向后兼容 | Minor(1.X.0) | 是 |
| 破坏性变更 | Major(X.0.0) | 是 |
| 预发布(beta/rc/alpha) | 预发布版本(1.0.0-beta.1) | 是 |
## v1.2.0 - 2024-01-01
### BREAKING CHANGES
- change: PHP version bumped to 8.2
### Added
- feat: add new provider support (#42)
- feat: add new config system (#43)
### Changed
- fix: correct error code (#45)
- chore: update dependencies (#46)## [v1.2.0] - 2024-01-01
### Added
- New payment provider support (#42)
- Typed configuration objects replacing arrays (#43)
### Changed
- Minimum PHP version from 8.0 to 8.2 (#41)
- All internal plugins migrated to trait-based architecture (#44)
### Removed
- Legacy helper functions file, migrated to static methods (#44)
- Deprecated `getOldConfig()` functions, use `getProviderConfig()` (#41)| 任务 | 命令 / 文件 | 关键规则 |
|---|---|---|
| 查看当前分支 | git branch --show-current | 禁止在 master/main 上直接修改 CHANGELOG |
| 创建发布分支 | git checkout -b docs/changelog-vX.Y.Z | 所有文档改动必须走 PR |
| 列出自上一个 tag 以来的提交 | git log --oneline --no-merges $(git describe --tags --abbrev=0)..HEAD | 排除 merge commit |
| 标准分类 | Added → Changed → Deprecated → Removed → Fixed → Security | 严格顺序,不新增分类 |
| 去除前缀 | 移除 feat:、fix:、refactor:、chore: | 仅当存在时才移除;已干净的中文描述保持原样 |
| 升级指南 | docs/v{major}/upgrade/v{version}.md 或实际等价路径 | 先探测真实 docs 路径 |
| 更新导航 | 侧边栏 / 菜单配置文件 | 若 .gitignore 忽略 docs 目录,使用 git add -f |
| 合并 PR | 由人工在平台审核后执行 | Agent 严禁自动合并(gh pr merge 等一律禁止) |
| 创建 annotated tag | git tag -a vX.Y.Z -m "release: vX.Y.Z" | 必须在 PR 由人工合并后执行 |
| 创建 GitHub Release | gh release create vX.Y.Z --notes-file release-notes.md --prerelease | beta/rc/alpha 需标记为 pre-release |
在修改任何发布相关文件前,必须先创建独立分支。
# 先确认当前分支
git branch --show-current
# 如果在 master/main 上,立即切出发布分支
git checkout -b docs/changelog-vX.Y.Z禁止在 master/main 上直接提交 CHANGELOG 或升级指南改动。
latest=$(git describe --tags --abbrev=0)
git log --oneline --no-merges ${latest}..HEAD重点关注:PR 编号、破坏性变更、新功能、已弃用 / 已移除项。
仅文档发布判断: 如果自上一个 tag 以来的代码变更已经在目标分支上,而你只是整理文档,则按「仅文档发布」处理。流程相同,但提交范围只包含 CHANGELOG / 升级指南 / 导航。
关键验证步骤: 分析完提交后,务必验证实际代码状态,避免把「新增后又移除」的功能写进发布说明:
# 验证文件增删
git diff ${latest}..HEAD --stat
# 验证 src/ 下实际代码变更
git diff ${latest}..HEAD -- src/验证规则:
对于 commit 消息中的「新增」项:
对于 commit 消息中的「移除」项:
对于 commit 消息中的「变更」项:
验证命令:
# 确认文件存在于 HEAD
git show HEAD:path/to/file
# 确认文件变更
git diff ${latest}..HEAD -- path/to/file分类顺序(严格):Added、Changed、Deprecated、Removed、Fixed、Security。
规则:
feat: / fix: / refactor: / chore: 等前缀时才移除BREAKING CHANGES 内容移入 Changed 或 Removed(#1234) 以便追溯版本标题格式:
## [v1.2.0] - 2024-01-01先探测真实 docs 路径。 常见位置:
docs/v{major}/upgrade/v{version}.mdweb/docs/v{major}/upgrade/v{version}.mdsrc/docs/v{major}/upgrade/v{version}.md如果目标升级指南已存在(例如后续 beta 版本),则在原有基础上追加新内容,不要整篇替换。
章节结构:
## 重点检查### 运行环境 — PHP 版本、扩展、其他运行时要求### 简单使用者 — 仅 end-user 可见变更(命名空间变化、移除的方法、配置调整)。不要罗列内部重构(内部辅助函数重组、不影响公共 API 的基类变化、代码组织调整)。### 自有插件开发者 — 影响自定义插件或扩展的内部架构变更(新基类、方法签名变化、移除的内部工具)。## 更改版本号 — composer require vendor/package:~{version}### BREAKING CHANGES(如有)— 完整破坏性变更列表搜索文档中已移除或已弃用功能的使用:
grep -rn "deprecatedMethod\|removedClass\|oldNamespace" docs/规则: 删除已移除功能的示例。不要保留「兼容两种写法」的双示例。文档只反映当前版本。
将新升级指南链接加入文档导航配置(如侧边栏、菜单、索引文件)。
注意: 如果 .gitignore 包含 docs 目录匹配规则,新文件需用 git add -f 强制添加。
创建 PR:
git add -f CHANGELOG.md docs/ # 或 web/docs/,按实际路径调整
git commit -m "docs: update CHANGELOG and upgrade guide for vX.Y.Z"
git push -u origin docs/changelog-vX.Y.Z
# 通过 GitHub / GitLab / Gitea 等平台创建 PR⛔ 流程暂停点:创建 PR 后必须停止,等待人工审核合并
gh pr merge(含 --squash/--merge/--rebase)、平台合并 API 等任何自动合并操作人工合并后(继续前必须确认 PR 已由人工合并):
# 核实 PR 状态(state 应为 MERGED,mergedBy 应为人工账号)
gh pr view <PR编号> --json state,mergedAt,mergedBy
git fetch origin
git log --oneline origin/master | head -5
# 打 tag 并推送
git checkout master && git pull origin master
git tag -a vX.Y.Z -m "release: vX.Y.Z"
git push origin vX.Y.Z创建 Release(以 GitHub 为例):
# 从 CHANGELOG 提取当前版本段落
sed -n '/^## vX.Y.Z/,/^## v/p' CHANGELOG.md | sed '$d' > release-notes.md
# beta/rc/alpha 版本需添加 --prerelease
gh release create vX.Y.Z --title "vX.Y.Z" --notes-file release-notes.md --prerelease| 错误 | 原因 | 修正 |
|---|---|---|
| 直接在 master 提交 CHANGELOG | 跳过分支隔离 | 必须先创建 docs/changelog-vX.Y.Z 分支 |
CHANGELOG 保留 feat:/fix: 前缀 | 从 commit 消息复制粘贴 | 仅在有前缀时剥离;保持已有干净描述 |
| 内部重构写入「简单使用者」 | 未区分用户可见变更与内部变更 | 移到「自有插件开发者」或直接删除 |
| 文档保留新旧双示例 | 试图在文档中保持向后兼容 | 删除旧示例;文档只反映当前版本 |
| 忘记更新导航 | 创建升级指南后未注册 | 立即加入侧边栏 / 菜单 |
| PR 未合并就创建 tag | 急于完成发布 | 先确认 origin/master 包含合并提交 |
| 使用 lightweight tag | git tag 缺少 -a | 始终使用 git tag -a 并附带 message |
| Release notes 与 CHANGELOG 不一致 | 单独编写 release notes | 从 CHANGELOG 提取或复制 |
| 预发布版本未标记 pre-release | 忘记 beta/rc/alpha 后缀 | 按版本后缀在发布平台勾选 pre-release |
| 写入「新增后又移除」的功能 | 仅依赖 commit 消息未验证代码 | 用 git diff 确认功能在 HEAD 中真实存在 |
| Agent 自行合并 PR | 误将「发布流程授权」当作「合并授权」 | 如需撤销:git revert <merge-commit>;此后一律仅创建 PR 并等待人工合并 |
© yansongda, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .agents/skills/releasing-php-package of yansongda/pay.
Open the folder on GitHubat commit 37cf0c1
Releasing Php Package next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Releasing Php Package this skillyansongda/pay | 5.4k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Chamilo Changelog Updaterchamilo/chamilo-lms | 1k | — | ~4.2k | Automated safety check: Pass | GPL-3.0 | |
| Skia Analystmono/SkiaSharp | 5.6k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Releasemarko-php/marko | 396 | — | ~2.9k | Automated safety check: Pass | MIT | |
| Changelog Generatordidi/mpx | 3.9k | — | ~640 | Automated safety check: Pass | Apache-2.0 | |
| Tabler Upgrade Guide Writertabler/tabler | 42k | — | ~1.7k | Automated safety check: Pass | MIT |
chamilo/chamilo-lms
Adds commits for a new Chamilo release to the changelog page, classifying them into categories and skipping those already listed for that version.
mono/SkiaSharp
Analyze Skia features for SkiaSharp - produces a unified analysis of what shipped (upstream engine benefits, PR links, migration guides) and what's missing (impact/priority/effort scoring, hidden…
marko-php/marko
Cut a new Marko release. An agent skill from marko-php/marko.
didi/mpx
通过查看当前最新版本与上一版本间的git提交记录与代码变更,生成版本变更日志,当用户询问“创建/生成变更日志”、“创建/生成changelog”时使用。
tabler/tabler
Writes the upgrade guide page for a Tabler release by collecting removed, renamed and deprecated items from changesets and diffs, with before and after examples.
TryGhost/Ghost
Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.
yansongda/pay
A skill your agent uses when local PHP environment is unavailable.
yansongda/pay
A skill your agent uses when reviewing PRs that add or modify a payment Provider in yansongda/pay - covers plugin pipeline, multi-tenant safety, signature verification, docs, and naming conventions.
yansongda/pay
A skill your agent uses when developing, testing, or adding new providers to yansongda/pay project.
Categories
A skill your agent uses when preparing to publish a new version of a PHP Composer package and need to write or update CHANGELOG, upgrade guides, and documentation before tagging and releasing. Releasing Php Package is an agent skill from yansongda/pay.
Releasing Php Package fits situations like: preparing to publish a new version of a PHP Composer package and need to write; update CHANGELOG; documentation before tagging and releasing.
Run `npx skills add yansongda/pay --skill releasing-php-package -a claude-code`. Or copy the skill folder (.agents/skills/releasing-php-package in yansongda/pay) into .claude/skills/releasing-php-package in your project. Claude Code loads it when a task matches its description.
Run `npx skills add yansongda/pay --skill releasing-php-package -a codex`. Or copy the skill folder (.agents/skills/releasing-php-package in yansongda/pay) into .agents/skills/releasing-php-package in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yansongda/pay --skill releasing-php-package -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/releasing-php-package, .gemini/skills/releasing-php-package, .github/skills/releasing-php-package and .opencode/skills/releasing-php-package in your project.
Going by SKILL.md and its folder, Releasing Php Package needs the command-line tools its instructions call (git, gh and composer).
SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Releasing Php Package is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.6k tokens (SKILL.md is roughly 6.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Releasing Php Package: Chamilo Changelog Updater (chamilo/chamilo-lms, 1k stars), Skia Analyst (mono/SkiaSharp, 5.6k stars), Release (marko-php/marko, 396 stars) and Changelog Generator (didi/mpx, 3.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
yansongda (a GitHub user) maintains it in yansongda/pay, which has 5,370 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 8, 2026.
Source: yansongda/pay on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.