[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7D1XFQM2JV8J89KTHNPA3CS":3,"skill-same:01M7D1XFQM2JV8J89KTHNPA3CS":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7D1XFQM2JV8J89KTHNPA3CS","release",null,"Automate AK5 version bump and release workflows for PyPI. Use when releasing a new version of AK5 (patch, minor, or major), running pre-flight linting and test suites, compiling embedded Web UI assets, synchronizing lockfiles, and pushing release git tags for automated CI\u002FCD deployment.","fritzprix\u002Fak5","fritzprix","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F917899?v=4","01M7D1W1M07E0W6V21KN562TER","01M7D1W1N32G35YCYYHENV0WZ4",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5\u002Fblob\u002Fmaster\u002Fskills\u002Frelease\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: release\ndescription: >-\n  Automate AK5 version bump and release workflows for PyPI.\n  Use when releasing a new version of AK5 (patch, minor, or major),\n  running pre-flight linting and test suites, compiling embedded Web UI assets,\n  synchronizing lockfiles, and pushing release git tags for automated CI\u002FCD deployment.\n---\n\n# AK5 Release Automation Skill\n\nUse this skill when preparing and publishing a new release of **AK5** (Python package on PyPI, embedded Web UI, and TypeScript SDK).\n\n---\n\n## 1. Release Types & Semantic Versioning\n\nChoose the appropriate release bump based on SemVer 2.0 (`MAJOR.MINOR.PATCH`):\n\n| Release Type | Command | When to Use | Example |\n|---|---|---|---|\n| **`patch`** | `python3 scripts\u002Frelease.py patch --push` | Bug fixes, documentation revisions, minor styling or security patches | `1.0.3` → `1.0.4` |\n| **`minor`** | `python3 scripts\u002Frelease.py minor --push` | New CLI commands, backwards-compatible API features, new MCP tools | `1.0.3` → `1.1.0` |\n| **`major`** | `python3 scripts\u002Frelease.py major --push` | Breaking API\u002Fschema changes, major architectural redesigns | `1.0.3` → `2.0.0` |\n\n---\n\n## 2. One-Command Automated Release\n\nAK5 includes an automated release script that executes the complete quality and publishing pipeline:\n\n```bash\n# Preview version calculation without modifying files\npython3 scripts\u002Frelease.py patch --dry-run\npython3 scripts\u002Frelease.py minor --dry-run\npython3 scripts\u002Frelease.py major --dry-run\n\n# Run full pipeline: test -> compile web UI -> bump versions -> lock -> build -> commit & push\npython3 scripts\u002Frelease.py patch --push\n```\n\n### What the automation script executes:\n1. **Pre-flight Quality Check:** Runs `uv run ruff check backend` and `uv run pytest backend\u002Ftests`.\n2. **Web UI Compilation:** Executes `scripts\u002Fbuild_web_ui.sh` to compile Next.js static assets into `backend\u002Fsrc\u002Fak5\u002Fweb_ui\u002F`.\n3. **Monorepo Version Sync:** Synchronizes version numbers in:\n   - `backend\u002Fpyproject.toml`\n   - `frontend\u002Fpackage.json`\n   - `packages\u002Fsdk\u002Fpackage.json`\n4. **Lockfile Synchronization:** Executes `uv lock` to update `uv.lock`.\n5. **Distribution Build:** Runs `uv build backend --out-dir dist`.\n6. **Isolated wheel smoke (hard gate):** Runs `scripts\u002Fsmoke_uvx_wheel.sh` — installs the wheel alone (like `uvx`), asserts `greenlet`\u002Fasyncio import, `ak5.main:app`, embedded UI, and CLI help. **Release must not tag\u002Fpush if this fails.**\n7. **Git Tag & Push:** Commits changes, tags `v\u003Cversion>`, and pushes both `master` and the tag to GitHub `origin`.\n\n---\n\n## 3. Manual Step-by-Step Procedure\n\nIf you prefer to perform each step manually or need granular debugging:\n\n### Step 1: Quality Checks\n```bash\nuv run ruff check backend\nuv run pytest backend\u002Ftests\n```\n\n### Step 2: Build Embedded Static Web Assets\n```bash\nchmod +x scripts\u002Fbuild_web_ui.sh\n.\u002Fscripts\u002Fbuild_web_ui.sh\n```\n\n### Step 3: Bump Versions\nUpdate the version string in the following files:\n* `backend\u002Fpyproject.toml` (`version = \"X.Y.Z\"`)\n* `frontend\u002Fpackage.json` (`\"version\": \"X.Y.Z\"`)\n* `packages\u002Fsdk\u002Fpackage.json` (`\"version\": \"X.Y.Z\"`)\n\n### Step 4: Update Lockfile & Test Wheel Build\n```bash\nuv lock\nrm -rf dist\nuv build backend --out-dir dist\nunzip -l dist\u002F*.whl | grep web_ui  # Verify web UI is bundled\n```\n\n### Step 5: Commit, Tag, and Push\n```bash\nVERSION=\"1.0.4\"\ngit add backend\u002Fpyproject.toml frontend\u002Fpackage.json packages\u002Fsdk\u002Fpackage.json uv.lock\ngit commit -m \"release: v${VERSION} — bump version to ${VERSION}\"\ngit tag -a \"v${VERSION}\" -m \"v${VERSION} release\"\ngit push origin master\ngit push origin \"v${VERSION}\"\n```\n\n---\n\n## 4. Post-Release Verification\n\nAfter pushing the git tag, GitHub Actions automatically builds and publishes the package to PyPI:\n\n### Step 1: Monitor GitHub Actions Run\n```bash\ngh run list --workflow=release.yml -L 1\n```\n\n### Step 2: Check PyPI Propagation\n```bash\n# Check latest registered version on PyPI\ncurl -s https:\u002F\u002Fpypi.org\u002Fpypi\u002Fak5\u002Fjson | jq -r '.info.version'\n```\n\n### Step 3: Zero-Install Smoke Test\n```bash\n# Verify the published version executes via uvx\nuvx --refresh ak5@latest --version\n\n# Verify the server extra (API + embedded dashboard) resolves\nuvx --refresh --from 'ak5[server]@latest' ak5 serve --help\n```\n","# AK5 Release Automation Skill\n\nUse this skill when preparing and publishing a new release of **AK5** (Python package on PyPI, embedded Web UI, and TypeScript SDK).\n\n---\n\n## 1. Release Types & Semantic Versioning\n\nChoose the appropriate release bump based on SemVer 2.0 (`MAJOR.MINOR.PATCH`):\n\n| Release Type | Command | When to Use | Example |\n|---|---|---|---|\n| **`patch`** | `python3 scripts\u002Frelease.py patch --push` | Bug fixes, documentation revisions, minor styling or security patches | `1.0.3` → `1.0.4` |\n| **`minor`** | `python3 scripts\u002Frelease.py minor --push` | New CLI commands, backwards-compatible API features, new MCP tools | `1.0.3` → `1.1.0` |\n| **`major`** | `python3 scripts\u002Frelease.py major --push` | Breaking API\u002Fschema changes, major architectural redesigns | `1.0.3` → `2.0.0` |\n\n---\n\n## 2. One-Command Automated Release\n\nAK5 includes an automated release script that executes the complete quality and publishing pipeline:\n\n```bash\n# Preview version calculation without modifying files\npython3 scripts\u002Frelease.py patch --dry-run\npython3 scripts\u002Frelease.py minor --dry-run\npython3 scripts\u002Frelease.py major --dry-run\n\n# Run full pipeline: test -> compile web UI -> bump versions -> lock -> build -> commit & push\npython3 scripts\u002Frelease.py patch --push\n```\n\n### What the automation script executes:\n1. **Pre-flight Quality Check:** Runs `uv run ruff check backend` and `uv run pytest backend\u002Ftests`.\n2. **Web UI Compilation:** Executes `scripts\u002Fbuild_web_ui.sh` to compile Next.js static assets into `backend\u002Fsrc\u002Fak5\u002Fweb_ui\u002F`.\n3. **Monorepo Version Sync:** Synchronizes version numbers in:\n   - `backend\u002Fpyproject.toml`\n   - `frontend\u002Fpackage.json`\n   - `packages\u002Fsdk\u002Fpackage.json`\n4. **Lockfile Synchronization:** Executes `uv lock` to update `uv.lock`.\n5. **Distribution Build:** Runs `uv build backend --out-dir dist`.\n6. **Isolated wheel smoke (hard gate):** Runs `scripts\u002Fsmoke_uvx_wheel.sh` — installs the wheel alone (like `uvx`), asserts `greenlet`\u002Fasyncio import, `ak5.main:app`, embedded UI, and CLI help. **Release must not tag\u002Fpush if this fails.**\n7. **Git Tag & Push:** Commits changes, tags `v\u003Cversion>`, and pushes both `master` and the tag to GitHub `origin`.\n\n---\n\n## 3. Manual Step-by-Step Procedure\n\nIf you prefer to perform each step manually or need granular debugging:\n\n### Step 1: Quality Checks\n```bash\nuv run ruff check backend\nuv run pytest backend\u002Ftests\n```\n\n### Step 2: Build Embedded Static Web Assets\n```bash\nchmod +x scripts\u002Fbuild_web_ui.sh\n.\u002Fscripts\u002Fbuild_web_ui.sh\n```\n\n### Step 3: Bump Versions\nUpdate the version string in the following files:\n* `backend\u002Fpyproject.toml` (`version = \"X.Y.Z\"`)\n* `frontend\u002Fpackage.json` (`\"version\": \"X.Y.Z\"`)\n* `packages\u002Fsdk\u002Fpackage.json` (`\"version\": \"X.Y.Z\"`)\n\n### Step 4: Update Lockfile & Test Wheel Build\n```bash\nuv lock\nrm -rf dist\nuv build backend --out-dir dist\nunzip -l dist\u002F*.whl | grep web_ui  # Verify web UI is bundled\n```\n\n### Step 5: Commit, Tag, and Push\n```bash\nVERSION=\"1.0.4\"\ngit add backend\u002Fpyproject.toml frontend\u002Fpackage.json packages\u002Fsdk\u002Fpackage.json uv.lock\ngit commit -m \"release: v${VERSION} — bump version to ${VERSION}\"\ngit tag -a \"v${VERSION}\" -m \"v${VERSION} release\"\ngit push origin master\ngit push origin \"v${VERSION}\"\n```\n\n---\n\n## 4. Post-Release Verification\n\nAfter pushing the git tag, GitHub Actions automatically builds and publishes the package to PyPI:\n\n### Step 1: Monitor GitHub Actions Run\n```bash\ngh run list --workflow=release.yml -L 1\n```\n\n### Step 2: Check PyPI Propagation\n```bash\n# Check latest registered version on PyPI\ncurl -s https:\u002F\u002Fpypi.org\u002Fpypi\u002Fak5\u002Fjson | jq -r '.info.version'\n```\n\n### Step 3: Zero-Install Smoke Test\n```bash\n# Verify the published version executes via uvx\nuvx --refresh ak5@latest --version\n\n# Verify the server extra (API + embedded dashboard) resolves\nuvx --refresh --from 'ak5[server]@latest' ak5 serve --help\n```\n",{"name":5,"description":7},"master","221565f93aa9cf010e43bd19bcaa3d64de971d0f","skills\u002Frelease",0,"https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5","https:\u002F\u002Fpypi.org\u002Fproject\u002Fak5\u002F","https:\u002F\u002Fgithub.com\u002Ffritzprix","https:\u002F\u002Ffritzprix.github.io\u002F","2026-11-08 17:22:41",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add fritzprix\u002Fak5 --skill release",{"tool":38,"command":39},"bunx","bunx skills add fritzprix\u002Fak5 --skill release",{"tool":41,"command":42},"pnpm","pnpm dlx skills add fritzprix\u002Fak5 --skill release","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5\u002Fblob\u002Fmaster\u002Fskills\u002Frelease\u002FSKILL.md",true,[],[47,54,59,64,71,78],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":18},"01M7D1X89ZH1N7654JSWSGH01E","ak5","Work as a triage, worker, or gatekeeper agent on an AK5 board through the `ak5` CLI (pull model), in an adversarial loop where each role verifies the previous one and a human gives final approval. Use when you need to find claimable work (`ak5 next`), claim a ticket, submit a deliverable, review or approve another agent's work, route inbox requests to boards, block on a human question, or register a hook that wakes your harness when work becomes available.","https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5\u002Fblob\u002Fmaster\u002Fskills\u002Fak5\u002FSKILL.md",[],[],{"skillNo":55,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":18},"01M7D1X1KB34JBZC1TYWXT7FA2","https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5\u002Fblob\u002Fmaster\u002Fbackend\u002Fsrc\u002Fak5\u002Fskills\u002Fak5\u002FSKILL.md",[],[],{"skillNo":60,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":18},"01M7D1WWAV8JDN9JGTFFAP1SQS","https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Frelease\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":18},"01M7D1WNKWPFGE04VDCHJ54GNW","cursor-delegate","Delegate code reviews, refactoring, bug fixes, or implementation tasks to the Cursor Agent CLI (`cursor agent` \u002F `agent`). Use when running Cursor as an AK5 worker (claim → run → submit), executing headless\u002Fnon-interactive code reviews or refactoring, waking Cursor from AK5 WORK_AVAILABLE events, or syncing Cursor output back to AK5 tickets.","https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fcursor-delegate\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M7D1WHQSR1DVYP5BWNB2YK1V","create-pr","Create a GitHub pull request from the current feature branch into the latest ``dev\u002FMAJOR.MINOR.x`` integration branch. Use when the user asks to open\u002Fcreate a PR, ``\u002Fcreate-pr``, or merge feature work into ``dev\u002Fz.y.x``.","https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fcreate-pr\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M7D1WBTKFWA5DJ69DD1Y9HSM","audit-local","Audit uncommitted local working-tree changes for bugs, security issues, regressions, and missing tests. Use when the user asks to audit\u002Freview local changes, dirty tree, uncommitted diff, ``\u002Faudit-local``, or wants a hands-on review instead of only launching Bugbot.","https:\u002F\u002Fgithub.com\u002Ffritzprix\u002Fak5\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Faudit-local\u002FSKILL.md",[],[]]