From 876fe4d60f14a7c5ba712599288926e982889d0e Mon Sep 17 00:00:00 2001 From: JaredLiu <940101379@qq.com> Date: Tue, 31 Mar 2026 21:12:35 +0800 Subject: [PATCH 1/3] feat: add auto version bump rules to CLAUDE.md & AGENTS.md, bump wechat-article to 1.0.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CLAUDE.md: detailed version bump guidelines (semver y for features, z for fixes) - AGENTS.md: concise version bump rules + cross-reference to CLAUDE.md - youmind-wechat-article: 1.0.0 → 1.0.1 to trigger ClawHub publish --- AGENTS.md | 41 ++++++++++++++++++ CLAUDE.md | 59 ++++++++++++++++++++++++++ skills/youmind-wechat-article/SKILL.md | 2 +- 3 files changed, 101 insertions(+), 1 deletion(-) create mode 100644 AGENTS.md create mode 100644 CLAUDE.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..be2c0b0 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,41 @@ +# AGENTS.md — AI Contributor Guidelines + +## Auto Version Bump (MANDATORY) + +**Every code change to a skill MUST include a version bump in its `SKILL.md` frontmatter.** + +The version field uses [semver](https://semver.org/) (`x.y.z`): + +| Change Type | Bump | Examples | +|---|---|---| +| **Breaking changes / major feature** | `y` (minor) | New capability, restructured workflow, API change, added major reference docs | +| **Bug fix / small tweak / docs fix** | `z` (patch) | Typo fix, wording improvement, bug fix, dependency update, minor config change | + +### Rules + +1. **Before committing**, check the current `version:` in the skill's `SKILL.md` frontmatter. +2. Determine if the change is a feature/major change → bump `y` (reset `z` to 0), or a fix/minor change → bump `z`. +3. Update the `version:` line in the SKILL.md frontmatter accordingly. +4. CI auto-publishes to ClawHub on merge to `main` based on this version field. **If the version is not bumped, the publish is skipped.** + +### Examples + +``` +# Bug fix: typo in SKILL.md instructions +version: 1.0.0 → version: 1.0.1 + +# New feature: added image generation support +version: 1.0.1 → version: 1.1.0 + +# Fix error handling in scripts +version: 1.1.0 → version: 1.1.1 + +# Major restructure of the skill workflow +version: 1.1.1 → version: 1.2.0 +``` + +## Other Guidelines + +- See `CLAUDE.md` for detailed version bump criteria (what counts as major vs fix). +- See `shared/SKILL_TEMPLATE.md` for skill structure conventions. +- See `shared/PUBLISHING.md` for publishing details. diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..0f0acc6 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,59 @@ +# CLAUDE.md — AI Contributor Guidelines + +## Auto Version Bump (MANDATORY) + +**Every code change to a skill MUST include a version bump in its `SKILL.md` frontmatter.** + +The version field uses [semver](https://semver.org/) (`x.y.z`): + +| Change Type | Bump | Examples | +|---|---|---| +| **Breaking changes / major feature** | `y` (minor) | New capability, restructured workflow, API change, added major reference docs | +| **Bug fix / small tweak / docs fix** | `z` (patch) | Typo fix, wording improvement, bug fix, dependency update, minor config change | + +### Rules + +1. **Before committing**, check the current `version:` in the skill's `SKILL.md` frontmatter. +2. Determine if the change is a feature/major change → bump `y` (reset `z` to 0), or a fix/minor change → bump `z`. +3. Update the `version:` line in the SKILL.md frontmatter accordingly. +4. CI auto-publishes to ClawHub on merge to `main` based on this version field. **If the version is not bumped, the publish is skipped.** + +### Examples + +``` +# Bug fix: typo in SKILL.md instructions +version: 1.0.0 → version: 1.0.1 + +# New feature: added image generation support +version: 1.0.1 → version: 1.1.0 + +# Fix error handling in scripts +version: 1.1.0 → version: 1.1.1 + +# Major restructure of the skill workflow +version: 1.1.1 → version: 1.2.0 +``` + +### What counts as "major change" (bump y)? + +- Adding a new command or workflow step +- Adding/removing required environment variables +- Changing the skill's API interface or expected input/output +- Adding significant new reference docs or scripts +- Restructuring the skill directory + +### What counts as "fix/small tweak" (bump z)? + +- Fixing a bug in scripts or instructions +- Fixing typos, grammar, or formatting +- Updating dependency versions +- Minor wording improvements +- Adding comments or clarifications + +## Other Guidelines + +- See `shared/SKILL_TEMPLATE.md` for skill structure conventions. +- See `shared/PUBLISHING.md` for publishing details. +- Every skill must have a `.clawhubignore` file. +- SKILL.md must be written in English (multilingual triggers in description are OK). +- Every user-facing `youmind.com` link must include `?utm_source=`. diff --git a/skills/youmind-wechat-article/SKILL.md b/skills/youmind-wechat-article/SKILL.md index 0c04dac..05d15b2 100644 --- a/skills/youmind-wechat-article/SKILL.md +++ b/skills/youmind-wechat-article/SKILL.md @@ -1,6 +1,6 @@ --- name: youmind-wechat-article -version: 1.0.0 +version: 1.0.1 description: | Write and publish WeChat Official Account articles end-to-end with AI — trending topic mining, de-AI voice writing, beautiful theme formatting, cover image generation, and one-click draft box publishing. From b830d03b606f36bb6e0183a3fb82c8d8c0ed2a06 Mon Sep 17 00:00:00 2001 From: JaredLiu <940101379@qq.com> Date: Tue, 31 Mar 2026 21:16:35 +0800 Subject: [PATCH 2/3] chore: remove wechat-article version bump (already submitted separately) --- skills/youmind-wechat-article/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/youmind-wechat-article/SKILL.md b/skills/youmind-wechat-article/SKILL.md index 05d15b2..0c04dac 100644 --- a/skills/youmind-wechat-article/SKILL.md +++ b/skills/youmind-wechat-article/SKILL.md @@ -1,6 +1,6 @@ --- name: youmind-wechat-article -version: 1.0.1 +version: 1.0.0 description: | Write and publish WeChat Official Account articles end-to-end with AI — trending topic mining, de-AI voice writing, beautiful theme formatting, cover image generation, and one-click draft box publishing. From f78d93b8fc01cbcea7b4132a170aca84b08fe881 Mon Sep 17 00:00:00 2001 From: JaredLiu <940101379@qq.com> Date: Tue, 31 Mar 2026 21:20:51 +0800 Subject: [PATCH 3/3] fix: clarify one version bump per branch/PR, avoid repeated bumps --- AGENTS.md | 5 +++-- CLAUDE.md | 6 ++++-- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index be2c0b0..740c33d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,10 +13,11 @@ The version field uses [semver](https://semver.org/) (`x.y.z`): ### Rules -1. **Before committing**, check the current `version:` in the skill's `SKILL.md` frontmatter. +1. **Before your first commit on a branch**, check the current `version:` in the skill's `SKILL.md` frontmatter. 2. Determine if the change is a feature/major change → bump `y` (reset `z` to 0), or a fix/minor change → bump `z`. 3. Update the `version:` line in the SKILL.md frontmatter accordingly. -4. CI auto-publishes to ClawHub on merge to `main` based on this version field. **If the version is not bumped, the publish is skipped.** +4. **One bump per branch/PR.** Do NOT bump again on subsequent commits in the same branch. +5. CI auto-publishes to ClawHub on merge to `main` based on this version field. **If the version is not bumped, the publish is skipped.** ### Examples diff --git a/CLAUDE.md b/CLAUDE.md index 0f0acc6..61051b3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -13,10 +13,12 @@ The version field uses [semver](https://semver.org/) (`x.y.z`): ### Rules -1. **Before committing**, check the current `version:` in the skill's `SKILL.md` frontmatter. +1. **Before your first commit on a branch**, check the current `version:` in the skill's `SKILL.md` frontmatter. 2. Determine if the change is a feature/major change → bump `y` (reset `z` to 0), or a fix/minor change → bump `z`. 3. Update the `version:` line in the SKILL.md frontmatter accordingly. -4. CI auto-publishes to ClawHub on merge to `main` based on this version field. **If the version is not bumped, the publish is skipped.** +4. **One bump per branch/PR.** If you already bumped the version in an earlier commit on the same branch, do NOT bump again on subsequent commits. The version reflects the entire PR, not individual commits. +5. If a branch starts as a patch (z bump) but later adds a feature, upgrade to a minor (y bump) — but still only one bump total. +6. CI auto-publishes to ClawHub on merge to `main` based on this version field. **If the version is not bumped, the publish is skipped.** ### Examples