[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75PRPV3BR28VMT4JX4XVF27":3,"skill-same:01M75PRPV3BR28VMT4JX4XVF27":56},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":29,"repositoryHtmlUrl":30,"repositoryHomepageUrl":31,"ownerHtmlUrl":32,"ownerBlogUrl":33,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M75PRPV3BR28VMT4JX4XVF27","create-changeset",null,"Use when a PR or branch changes any released package (crates\u002F*, sdk\u002Ftypescript, sdk\u002Fpython, packages\u002Fedit-tools), when the changeset-gate CI check fails, or before pushing work that touches versioned package directories. Creates the required .changeset\u002F*.md file for knope per-package versioning.","RoderAI\u002Froder","RoderAI","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F284978122?v=4","01M75PQQ8DXA6WMHGMZXS7CTP5","Roder","01M75PQQ91JEF84WMNZG8GQH8Q",9,"MIT","https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fcreate-changeset\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: create-changeset\ndescription: Use when a PR or branch changes any released package (crates\u002F*, sdk\u002Ftypescript, sdk\u002Fpython, packages\u002Fedit-tools), when the changeset-gate CI check fails, or before pushing work that touches versioned package directories. Creates the required .changeset\u002F*.md file for knope per-package versioning.\nmetadata:\n  short-description: Add knope changesets for changed packages\n---\n\n# Create a changeset\n\nRoder uses [knope](https:\u002F\u002Fknope.tech) with **per-package changesets**. Commit\nmessages never bump versions — only files in `.changeset\u002F` do. CI enforces this\nvia `.github\u002Fworkflows\u002Fchangeset-gate.yml`.\n\nBroader release context: `docs\u002Freleases.md` and `$changesets`.\n\n## When you need a changeset\n\nAdd one when your branch modifies files under any **released package directory**:\n\n| Path pattern | knope package name |\n| --- | --- |\n| `crates\u002F\u003Ccrate>\u002F` | crate name from `Cargo.toml` (usually `roder-*`) |\n| `sdk\u002Ftypescript\u002F` | `roder-sdk-typescript` |\n| `sdk\u002Fpython\u002F` | `roder-sdk-python` |\n| `packages\u002Fedit-tools\u002F` | `roder-edit-tools` |\n\n**No changeset needed** for docs-only, roadmap, scripts, workflows, or\nexamples that are not under a released package root.\n\n## Workflow (follow in order)\n\n### 1. See what CI will complain about\n\nFrom repo root, against the PR base branch (usually `master`):\n\n```sh\npython3 scripts\u002Fcheck-changesets.py --base origin\u002Fmaster\n```\n\nIf it fails, the error lists missing package names and prints a template.\n\nAlso confirm knope config is current (second CI step):\n\n```sh\npython3 scripts\u002Fgenerate-knope-config.py --check\n```\n\nIf stale, run `python3 scripts\u002Fgenerate-knope-config.py` and commit `knope.toml`\n(see `$changesets` when adding a new crate).\n\n### 2. List packages your branch actually touched\n\n```sh\ngit fetch origin master\ngit diff --name-only \"$(git merge-base origin\u002Fmaster HEAD)\" HEAD\n```\n\nMap each changed path to a package: anything under `crates\u002Froder-api\u002F` →\n`roder-api`, under `crates\u002Froder-ext-process-host\u002F` → `roder-ext-process-host`,\netc. Package names are the keys in `knope.toml` — when unsure, grep:\n\n```sh\nrg '^\\[packages\\.\"' knope.toml | rg roder-api\n```\n\nOne changeset file can cover **multiple packages** changed by the same PR.\n\n### 3. Choose bump types\n\nFrontmatter bump per package: `major`, `minor`, or `patch`.\n\n| Change | Typical bump (pre-1.0) |\n| --- | --- |\n| Bug fix, internal refactor, tests, docs inside package | `patch` |\n| New feature, new public API, new protocol surface | `minor` |\n| Breaking public API or wire contract | `minor` (pre-1.0) or `major` (post-1.0) |\n\nWhen in doubt for additive work, use `patch`. Use `minor` when clients or\nintegrators must notice new capability.\n\n### 4. Write the change file\n\nCreate **one** descriptive file, e.g. `.changeset\u002Fcursor_sdk_process_extension.md`:\n\n```markdown\n---\nroder-api: patch\nroder-app-server: patch\nroder-ext-process-host: patch\n---\n\n# Short summary (becomes changelog heading)\n\nOptional longer Markdown body for release notes.\n```\n\nRules:\n\n- File **must** start with `---` frontmatter and a closing `---` before the body.\n- Only `.md` files belong in `.changeset\u002F` — no READMEs or notes there.\n- Name packages exactly as in `knope.toml` (quoted keys in TOML, unquoted in YAML).\n- Summary line after frontmatter should describe the **user-visible** change, not\n  the commit message.\n\nInteractive alternative (if knope is installed): `knope document-change`.\n\n### 5. Verify and commit\n\n**The changeset must be committed.** CI diffs `merge-base..HEAD`; an untracked\nfile does not satisfy the gate until it is in the branch history.\n\n```sh\npython3 scripts\u002Fcheck-changesets.py --base origin\u002Fmaster\ngit add .changeset\u002Fyour_file.md\ngit commit -m \"chore: add changeset for \u003Cshort description>\"\n```\n\nExpected success output:\n\n```text\nChangeset gate passed: roder-api, roder-app-server covered.\n```\n\n### 6. Push\n\nPush the commit with the changeset before expecting CI green (account billing\nmust also allow Actions to run).\n\n## Bypass (rare)\n\nApply the PR label `skip-changeset` only for changes that truly should not\nrelease (e.g. comment-only or test-only edits inside a crate with no behavioral\nchange worth noting). Do not use the label to avoid documenting real features.\n\nThe `knope\u002Frelease` branch is exempt from the gate by design.\n\n## Common mistakes\n\n| Mistake | Fix |\n| --- | --- |\n| Created `.changeset\u002Ffoo.md` but did not commit it | `git add` + commit, re-run check |\n| Wrong package name (`roder_ext_process_host`) | Use knope key: `roder-ext-process-host` |\n| Put README in `.changeset\u002F` | Move it elsewhere; knope parses every `.md` there |\n| Edited `knope.toml` by hand | Regenerate with `scripts\u002Fgenerate-knope-config.py` |\n| Changed a new crate but gate says unknown package | Regenerate `knope.toml` after adding the crate |\n\n## Example (this repo)\n\n`.changeset\u002Fcursor_sdk_process_extension.md`:\n\n```markdown\n---\nroder-api: patch\nroder-app-server: patch\nroder-ext-process-host: patch\n---\n\n# Process-extension protocol 0.2.0 and Cursor SDK remote-agent bridging\n\nExtend the process-extension protocol with subagent-dispatcher and task-executor\nservices, bridge them in the process host, and add app-server e2e coverage for\nthe cursor-sdk-agents TypeScript child.\n```\n","# Create a changeset\n\nRoder uses [knope](https:\u002F\u002Fknope.tech) with **per-package changesets**. Commit\nmessages never bump versions — only files in `.changeset\u002F` do. CI enforces this\nvia `.github\u002Fworkflows\u002Fchangeset-gate.yml`.\n\nBroader release context: `docs\u002Freleases.md` and `$changesets`.\n\n## When you need a changeset\n\nAdd one when your branch modifies files under any **released package directory**:\n\n| Path pattern | knope package name |\n| --- | --- |\n| `crates\u002F\u003Ccrate>\u002F` | crate name from `Cargo.toml` (usually `roder-*`) |\n| `sdk\u002Ftypescript\u002F` | `roder-sdk-typescript` |\n| `sdk\u002Fpython\u002F` | `roder-sdk-python` |\n| `packages\u002Fedit-tools\u002F` | `roder-edit-tools` |\n\n**No changeset needed** for docs-only, roadmap, scripts, workflows, or\nexamples that are not under a released package root.\n\n## Workflow (follow in order)\n\n### 1. See what CI will complain about\n\nFrom repo root, against the PR base branch (usually `master`):\n\n```sh\npython3 scripts\u002Fcheck-changesets.py --base origin\u002Fmaster\n```\n\nIf it fails, the error lists missing package names and prints a template.\n\nAlso confirm knope config is current (second CI step):\n\n```sh\npython3 scripts\u002Fgenerate-knope-config.py --check\n```\n\nIf stale, run `python3 scripts\u002Fgenerate-knope-config.py` and commit `knope.toml`\n(see `$changesets` when adding a new crate).\n\n### 2. List packages your branch actually touched\n\n```sh\ngit fetch origin master\ngit diff --name-only \"$(git merge-base origin\u002Fmaster HEAD)\" HEAD\n```\n\nMap each changed path to a package: anything under `crates\u002Froder-api\u002F` →\n`roder-api`, under `crates\u002Froder-ext-process-host\u002F` → `roder-ext-process-host`,\netc. Package names are the keys in `knope.toml` — when unsure, grep:\n\n```sh\nrg '^\\[packages\\.\"' knope.toml | rg roder-api\n```\n\nOne changeset file can cover **multiple packages** changed by the same PR.\n\n### 3. Choose bump types\n\nFrontmatter bump per package: `major`, `minor`, or `patch`.\n\n| Change | Typical bump (pre-1.0) |\n| --- | --- |\n| Bug fix, internal refactor, tests, docs inside package | `patch` |\n| New feature, new public API, new protocol surface | `minor` |\n| Breaking public API or wire contract | `minor` (pre-1.0) or `major` (post-1.0) |\n\nWhen in doubt for additive work, use `patch`. Use `minor` when clients or\nintegrators must notice new capability.\n\n### 4. Write the change file\n\nCreate **one** descriptive file, e.g. `.changeset\u002Fcursor_sdk_process_extension.md`:\n\n```markdown\n---\nroder-api: patch\nroder-app-server: patch\nroder-ext-process-host: patch\n---\n\n# Short summary (becomes changelog heading)\n\nOptional longer Markdown body for release notes.\n```\n\nRules:\n\n- File **must** start with `---` frontmatter and a closing `---` before the body.\n- Only `.md` files belong in `.changeset\u002F` — no READMEs or notes there.\n- Name packages exactly as in `knope.toml` (quoted keys in TOML, unquoted in YAML).\n- Summary line after frontmatter should describe the **user-visible** change, not\n  the commit message.\n\nInteractive alternative (if knope is installed): `knope document-change`.\n\n### 5. Verify and commit\n\n**The changeset must be committed.** CI diffs `merge-base..HEAD`; an untracked\nfile does not satisfy the gate until it is in the branch history.\n\n```sh\npython3 scripts\u002Fcheck-changesets.py --base origin\u002Fmaster\ngit add .changeset\u002Fyour_file.md\ngit commit -m \"chore: add changeset for \u003Cshort description>\"\n```\n\nExpected success output:\n\n```text\nChangeset gate passed: roder-api, roder-app-server covered.\n```\n\n### 6. Push\n\nPush the commit with the changeset before expecting CI green (account billing\nmust also allow Actions to run).\n\n## Bypass (rare)\n\nApply the PR label `skip-changeset` only for changes that truly should not\nrelease (e.g. comment-only or test-only edits inside a crate with no behavioral\nchange worth noting). Do not use the label to avoid documenting real features.\n\nThe `knope\u002Frelease` branch is exempt from the gate by design.\n\n## Common mistakes\n\n| Mistake | Fix |\n| --- | --- |\n| Created `.changeset\u002Ffoo.md` but did not commit it | `git add` + commit, re-run check |\n| Wrong package name (`roder_ext_process_host`) | Use knope key: `roder-ext-process-host` |\n| Put README in `.changeset\u002F` | Move it elsewhere; knope parses every `.md` there |\n| Edited `knope.toml` by hand | Regenerate with `scripts\u002Fgenerate-knope-config.py` |\n| Changed a new crate but gate says unknown package | Regenerate `knope.toml` after adding the crate |\n\n## Example (this repo)\n\n`.changeset\u002Fcursor_sdk_process_extension.md`:\n\n```markdown\n---\nroder-api: patch\nroder-app-server: patch\nroder-ext-process-host: patch\n---\n\n# Process-extension protocol 0.2.0 and Cursor SDK remote-agent bridging\n\nExtend the process-extension protocol with subagent-dispatcher and task-executor\nservices, bridge them in the process host, and add app-server e2e coverage for\nthe cursor-sdk-agents TypeScript child.\n```\n",{"name":5,"metadata":24,"description":7},{"short-description":25},"Add knope changesets for changed packages","master","cc8a773a0aeb90b9a2c6d9496045d0086befa159",".agents\u002Fskills\u002Fcreate-changeset",1,"https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder","https:\u002F\u002Froder.sh","https:\u002F\u002Fgithub.com\u002FRoderAI","roder.sh","Roder maintain the last model harness the world will need","2026-11-13 16:46:55",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add RoderAI\u002Froder --skill create-changeset",{"tool":42,"command":43},"bunx","bunx skills add RoderAI\u002Froder --skill create-changeset",{"tool":45,"command":46},"pnpm","pnpm dlx skills add RoderAI\u002Froder --skill create-changeset","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fcreate-changeset\u002FSKILL.md",true,[50],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},"agents\u002Fopenai.yaml","REFERENCE","参考文档",360,"https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002F.agents\u002Fskills\u002Fcreate-changeset\u002Fagents\u002Fopenai.yaml",[57,64,71,78,85,91],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M75PV4G2KGTM7SWT2CH1V4AF","repo-tour","Use when a user asks for an orientation tour of an unfamiliar repository. Produces a structured tour of entry points, key modules, and how to run tests.","https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002Fexamples\u002Fpackages\u002Fdemo-roder-package\u002Fskills\u002Frepo-tour\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M75PV378N4WSCDFRD1BCDAPS","review","Review code changes.","https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002Fcrates\u002Froder-skills\u002Ftests\u002Ffixtures\u002Fmodel\u002Fworkspace-review\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M75PV216EXMRD1ZXTWZ94CZD","vcs-snapshot","Create a scoped version-control snapshot.","https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002Fcrates\u002Froder-skills\u002Ftests\u002Ffixtures\u002Fmodel\u002Fbuiltin-vcs-snapshot\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M75PTW4RMS1K8FTKGSXBC895","webwright","Drive a local Playwright browser through a Roder-owned Webwright workspace with plan, final script, screenshots, logs, and verification evidence.","https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002Fcrates\u002Froder-skills\u002Fbuiltin\u002Fwebwright\u002FSKILL.md",[],[],{"skillNo":86,"name":73,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":19},"01M75PTRBG4VZVNJY9D7C8J7RK","Create scoped VCS snapshots from the current workspace state.","https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002Fcrates\u002Froder-skills\u002Fbuiltin\u002Fvcs-snapshot\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M75PTNTG14BJ27N6S5QBVGNA","roder-config","Configure and live-reload Roder from pasted config snippets, especially MCP server JSON, without leaking secrets or enabling executable integrations without approval.","https:\u002F\u002Fgithub.com\u002FRoderAI\u002Froder\u002Fblob\u002Fmaster\u002Fcrates\u002Froder-skills\u002Fbuiltin\u002Froder-config\u002FSKILL.md",[],[]]