[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69A734GN0Q2EP545Y8460VT":3,"skill-same:01M69A734GN0Q2EP545Y8460VT":71},{"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":23,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":48,"commitSha":49,"skillDirectory":50,"forksCount":51,"repositoryHtmlUrl":52,"repositoryHomepageUrl":6,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":55,"updatedAt":56,"install":57,"resources":70},"01M69A734GN0Q2EP545Y8460VT","agent-versioning",null,"Use when creating or editing PilotSwarm .agent.md files, prompt-layer manifests, or builder templates that generate agents. Covers schemaVersion\u002Fversion frontmatter, SemVer bump guidance, and session.prompt_layers expectations.","microsoft\u002FPilotSwarm","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M69A6RNK492A5JSNBTXANKX5",16,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fagent-versioning\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42],"versioning","agent versioning","version","when","frontmatter","layers","layer","manifests","guidance","files","bump","builder","use","session","prompt","editing","templates","semver","generate","2026-11-10 10:12:30",false,"---\nname: agent-versioning\ndescription: Use when creating or editing PilotSwarm .agent.md files, prompt-layer manifests, or builder templates that generate agents. Covers schemaVersion\u002Fversion frontmatter, SemVer bump guidance, and session.prompt_layers expectations.\n---\n\n# Agent Versioning\n\nUse this skill whenever you create or update PilotSwarm agent definitions in `agents\u002F*.agent.md`, embedded agents under `packages\u002Fsdk\u002Fplugins\u002F**\u002Fagents\u002F`, or builder templates that generate agent files.\n\n## Required Frontmatter\n\nEvery authored `.agent.md` should include:\n\n```yaml\n---\nschemaVersion: 1\nversion: 1.0.0\nname: example-agent\ndescription: Example agent.\n---\n```\n\n- `schemaVersion` is the PilotSwarm agent schema version. Use `1` by default, `3` for `initialRequiredTool`, and `4` for per-profile `nativeTaskTools` allowlists. See `docs\u002Fdeveloper\u002Fnative-task-tools.md`; never auto-inherit all parent tools into a native task.\n- `version` is a string. PilotSwarm-authored agents use SemVer. App authors may use any non-empty string, but SemVer is recommended.\n\n## When To Bump `version`\n\nFor PilotSwarm-authored agents and templates, bump `version` whenever you change prompt behavior, tool expectations, workflow guidance, frontmatter metadata, or output\u002Fcontract expectations.\n\nUse SemVer intent:\n\n- Patch: wording clarifications or typo fixes that should not materially change behavior.\n- Minor: new capabilities, tools, guidance, examples, or backwards-compatible workflow behavior.\n- Major: changed role semantics, removed expectations, or incompatible output\u002Fcontract changes.\n\nIf you only move a file without changing prompt behavior or metadata, a version bump is not required.\n\n## Builder Templates\n\nWhen a builder agent creates a new app agent, it should include `schemaVersion: 1` and `version: 1.0.0` by default.\n\nWhen it edits an existing app `.agent.md`, it should update the `version` string according to the change. If the existing app uses non-SemVer labels, preserve the user's style unless they ask to migrate.\n\n## Prompt Layers\n\nPilotSwarm prompt-layer manifests have three authored layers:\n\n```text\nPilotSwarm base -> App base -> Agent\n```\n\nRuntime context is not an agent layer; runtime behavior is tracked through orchestration version and session\u002Fruntime metadata.\n\n`session.prompt_layers` records the effective layer names, types, schema versions, and versions used by the worker that created or resumed the Copilot session. During rolling deploys, absence of the event means legacy\u002Funreported, and old workers may report old loaded versions until restarted.\n","# Agent Versioning\n\nUse this skill whenever you create or update PilotSwarm agent definitions in `agents\u002F*.agent.md`, embedded agents under `packages\u002Fsdk\u002Fplugins\u002F**\u002Fagents\u002F`, or builder templates that generate agent files.\n\n## Required Frontmatter\n\nEvery authored `.agent.md` should include:\n\n```yaml\n---\nschemaVersion: 1\nversion: 1.0.0\nname: example-agent\ndescription: Example agent.\n---\n```\n\n- `schemaVersion` is the PilotSwarm agent schema version. Use `1` by default, `3` for `initialRequiredTool`, and `4` for per-profile `nativeTaskTools` allowlists. See `docs\u002Fdeveloper\u002Fnative-task-tools.md`; never auto-inherit all parent tools into a native task.\n- `version` is a string. PilotSwarm-authored agents use SemVer. App authors may use any non-empty string, but SemVer is recommended.\n\n## When To Bump `version`\n\nFor PilotSwarm-authored agents and templates, bump `version` whenever you change prompt behavior, tool expectations, workflow guidance, frontmatter metadata, or output\u002Fcontract expectations.\n\nUse SemVer intent:\n\n- Patch: wording clarifications or typo fixes that should not materially change behavior.\n- Minor: new capabilities, tools, guidance, examples, or backwards-compatible workflow behavior.\n- Major: changed role semantics, removed expectations, or incompatible output\u002Fcontract changes.\n\nIf you only move a file without changing prompt behavior or metadata, a version bump is not required.\n\n## Builder Templates\n\nWhen a builder agent creates a new app agent, it should include `schemaVersion: 1` and `version: 1.0.0` by default.\n\nWhen it edits an existing app `.agent.md`, it should update the `version` string according to the change. If the existing app uses non-SemVer labels, preserve the user's style unless they ask to migrate.\n\n## Prompt Layers\n\nPilotSwarm prompt-layer manifests have three authored layers:\n\n```text\nPilotSwarm base -> App base -> Agent\n```\n\nRuntime context is not an agent layer; runtime behavior is tracked through orchestration version and session\u002Fruntime metadata.\n\n`session.prompt_layers` records the effective layer names, types, schema versions, and versions used by the worker that created or resumed the Copilot session. During rolling deploys, absence of the event means legacy\u002Funreported, and old workers may report old loaded versions until restarted.\n",{"name":5,"description":7},"main","cecafe1ca7a9f2778a6166abdd12f6165d99f777",".github\u002Fskills\u002Fagent-versioning",10,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-13 16:15:33",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add microsoft\u002FPilotSwarm --skill agent-versioning",{"tool":63,"command":64},"bunx","bunx skills add microsoft\u002FPilotSwarm --skill agent-versioning",{"tool":66,"command":67},"pnpm","pnpm dlx skills add microsoft\u002FPilotSwarm --skill agent-versioning","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fagent-versioning\u002FSKILL.md",true,[],[72,93,114,129,154,176],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":43},"01M69A9CY8CXHED3AFC8DAT9G0","pilotswarm-three-tier","Reference for adding a Tier 3 worker AKS cluster to a PilotSwarm deployment. Covers provisioning, identity, Dockerfile changes, entrypoint, manifests, and verification.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm\u002Fblob\u002Fmain\u002Ftemplates\u002Fbuilder-agents\u002Fskills\u002Fpilotswarm-three-tier\u002FSKILL.md",[],[79,80,81,31,82,83,84,85,86,87,88,89,90,91,92],"pilotswarm three tier","three","entrypoint","for","changes","aks","verification","deployment","reference","dockerfile","identity","provisioning","worker","cluster",{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":43},"01M69A9B6R5H88HJFEYC0P4R57","pilotswarm-sdk-builder","Use when creating or updating an SDK-first app on top of PilotSwarm. Covers the client\u002Fworker split, plugin layering, tool registration, tests, and the DevOps sample structure.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm\u002Fblob\u002Fmain\u002Ftemplates\u002Fbuilder-agents\u002Fskills\u002Fpilotswarm-sdk-builder\u002FSKILL.md",[],[100,101,35,102,103,104,36,105,27,106,107,108,109,91,110,111,112,113],"sdk","pilotswarm sdk builder","tool","first","plugin","client","top","split","app","tests","sample","structure","registration","devops",{"skillNo":115,"name":116,"nameZh":6,"description":117,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":43},"01M69A99A43M97VTYZBCN1JQ1H","pilotswarm-portal-builder","Use when creating or updating a browser portal on top of PilotSwarm. Covers portal branding, plugin.json.portal, named-agent exposure, auth add-ons, and remote deployment wiring.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm\u002Fblob\u002Fmain\u002Ftemplates\u002Fbuilder-agents\u002Fskills\u002Fpilotswarm-portal-builder\u002FSKILL.md",[],[121,35,122,27,123,106,124,125,36,126,127,86,104,128],"pilotswarm portal builder","remote","wiring","branding","add","json","browser","auth",{"skillNo":130,"name":131,"nameZh":6,"description":132,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":133,"categories":134,"keywords":138,"publishedAt":43},"01M69A97JZY10V1VE12NF4JR5A","pilotswarm-knowledge-harvester","Use when an SDK or CLI app needs to ingest external sources into durable, searchable knowledge and an open knowledge graph. Covers enabling the EnhancedFactStore + GraphStore providers, authoring a crawler:true agent, the crawl→graph→reader flow, ACL\u002FscopeKey evidence, and tests.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm\u002Fblob\u002Fmain\u002Ftemplates\u002Fbuilder-agents\u002Fskills\u002Fpilotswarm-knowledge-harvester\u002FSKILL.md",[135],{"categoryNo":136,"categoryName":137,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000021","资料检索与研究",[139,140,36,27,141,142,143,144,108,145,109,146,147,148,149,150,151,152,100,153],"knowledge","pilotswarm knowledge harvester","cli app","true","crawler","sources","authoring","crawl","ingest","evidence","reader","open","flow","knowledge graph","cli",{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":158,"categories":159,"keywords":163,"publishedAt":43},"01M69A95Y3EWHSZ1TDFMXWAKX3","pilotswarm-hybrid-datastore","Use when a PilotSwarm app needs stock PostgreSQL for runtime storage plus HorizonDB for enhanced facts, semantic\u002Flexical search, and the knowledge graph. Covers env topology, horizonConfigFromEnv wiring, harvester agents, Azure secret\u002Fresource guidance, and the rule that Docker defaults remain stock Postgres.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm\u002Fblob\u002Fmain\u002Ftemplates\u002Fbuilder-agents\u002Fskills\u002Fpilotswarm-hybrid-datastore\u002FSKILL.md",[160],{"categoryNo":161,"categoryName":162,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000011","运维与部署",[164,165,166,108,167,168,169,32,36,139,152,170,171,172,173,174,27,123,82,175],"hybrid","pilotswarm hybrid datastore","storage","runtime","stock","postgres","search","postgresql","azure","env","docker","facts",{"skillNo":177,"name":178,"nameZh":6,"description":179,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":180,"categories":181,"keywords":182,"publishedAt":43},"01M69A94F4WR5CXDZ73N658DV0","pilotswarm-duroxide-versioning","Use when changing PilotSwarm durable orchestration behavior, continue-as-new state, or replay-sensitive control flow.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FPilotSwarm\u002Fblob\u002Fmain\u002Ftemplates\u002Fbuilder-agents\u002Fskills\u002Fpilotswarm-duroxide-versioning\u002FSKILL.md",[],[183,24,184,185,27,186,187,188,36,189,190,151,191],"pilotswarm duroxide versioning","orchestration","new","as","control","replay","behavior","continue","state"]