[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6X5MCV74NHW5MEDNHZRF2C8":3,"skill-same:01M6X5MCV74NHW5MEDNHZRF2C8":101},{"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":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":60,"commitSha":61,"skillDirectory":62,"forksCount":14,"repositoryHtmlUrl":63,"repositoryHomepageUrl":64,"ownerHtmlUrl":65,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":66,"install":67,"resources":80},"01M6X5MCV74NHW5MEDNHZRF2C8","schema-management",null,"Manage generated processkit schema contracts through deterministic MCP rebuild and inspection workflows.","projectious-work\u002Fprocesskit","projectious-work","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F263889726?v=4","01M6N97TJJ118WQ35CHRV8RD0E","projectious.work","01M6N97TPWJPF0BMKYQ4PBY5W8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fschema-management\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],"schema management","management","schema","rebuild","mode","contract","get","deterministic","wed","contracts","manage","MCP","generated","work","alpha","validation","workflows","2026-11-10 10:12:30",false,"---\nname: schema-management\ndescription: >\n  Manage generated processkit schema contracts through deterministic MCP\n  rebuild and inspection workflows.\nmetadata:\n  processkit:\n    apiVersion: processkit.projectious.work\u002Fv2\n    id: SKILL-schema-management\n    version: \"1.0.0-alpha.1\"\n    created: 2026-07-22T00:00:00Z\n    category: processkit\n    layer: 0\n    provides:\n      primitives: []\n      mcp_tools:\n        - regenerate_schemas\n        - get_schema_contract\n        - get_validation_mode\n---\n\n# Schema Management\n\n## Intro\n\nSchema management exposes the committed build-time schema generator and\nruntime contract metadata through MCP. Use it to rebuild all or selected\ngenerated schemas and to inspect the contract or validation mode for a kind.\n\n## Overview\n\nUse `regenerate_schemas` after changing canonical sources under\n`context\u002Fschemas\u002Fsrc\u002F`. A full rebuild accepts no kind filter; a partial\nrebuild accepts registry selectors such as `workitem` or `decisionrecord`.\nThe result always has `rebuilt`, `unchanged`, and `errors` fields.\n\nUse `get_schema_contract` to retrieve the runtime Schema `spec`, including\ninterfaces, validation mode, vocabularies, generation metadata, and the\ndraft-2020-12 entity-spec schema. Pass a discriminator such as `risk` to\ninspect an overlay. Use `get_validation_mode` for the smaller strict\u002Ftolerant\nrouting decision.\n\nThe source tree is canonical. Generated files are committed derived output;\nnever edit them directly.\n\n## Gotchas\n\n- **Rebuilding without reviewing the scope.** Regeneration overwrites committed\n  derived files. Inspect the requested kinds and current diff first when the\n  user has not already authorized a rebuild.\n- **Editing generated YAML directly.** Regeneration overwrites such edits.\n  Change the source fragment, primitive, discriminator, or composition.\n- **Confusing product and schema versions.** Product v1.x uses entity API v2,\n  while each Schema has its own compatibility version.\n- **Passing entity IDs as selectors.** Partial generation accepts registry\n  kind selectors, not entity IDs or schema filenames.\n- **Assuming every MCP process shares caches.** Regeneration clears the cache\n  in its own process. Restart or call existing reload tools in other granular\n  MCP processes when they must observe changed contracts immediately.\n- **Treating tolerant validation as valid data.** Tolerant mode supports\n  migration; it does not waive schema findings or release gates.\n- **Ignoring an `errors` mapping.** Generation is atomic. Any reported error\n  means no planned output from that call was written.\n- **Promising a rebuild without running it.** When regeneration is requested,\n  call `regenerate_schemas` in the same turn and report its actual result.\n\n## Full reference\n\n`regenerate_schemas(kinds=None)` renders the registry in deterministic order.\nKind names are normalized to lowercase registry selectors. Unknown selectors,\ninheritance failures, invalid merge strategies, and unsafe output paths appear\nunder `errors`.\n\n`get_schema_contract(kind, discriminator=None)` returns the selected contract.\nThe contract is the Schema entity's `spec` block because that is the runtime\nsurface consumed by processkit servers.\n\n`get_validation_mode(kind, discriminator=None)` returns the selected mode.\nMissing schemas return a structured error instead of silently choosing a mode.\n\nAnti-patterns:\n\n- Hand-editing `_generated\u002F` output.\n- Rebuilding schemas from an installed tree that lacks canonical sources.\n- Using schema regeneration as a substitute for an entity-data migration.\n- Converting a discriminator variant into a false top-level entity kind.\n","# Schema Management\n\n## Intro\n\nSchema management exposes the committed build-time schema generator and\nruntime contract metadata through MCP. Use it to rebuild all or selected\ngenerated schemas and to inspect the contract or validation mode for a kind.\n\n## Overview\n\nUse `regenerate_schemas` after changing canonical sources under\n`context\u002Fschemas\u002Fsrc\u002F`. A full rebuild accepts no kind filter; a partial\nrebuild accepts registry selectors such as `workitem` or `decisionrecord`.\nThe result always has `rebuilt`, `unchanged`, and `errors` fields.\n\nUse `get_schema_contract` to retrieve the runtime Schema `spec`, including\ninterfaces, validation mode, vocabularies, generation metadata, and the\ndraft-2020-12 entity-spec schema. Pass a discriminator such as `risk` to\ninspect an overlay. Use `get_validation_mode` for the smaller strict\u002Ftolerant\nrouting decision.\n\nThe source tree is canonical. Generated files are committed derived output;\nnever edit them directly.\n\n## Gotchas\n\n- **Rebuilding without reviewing the scope.** Regeneration overwrites committed\n  derived files. Inspect the requested kinds and current diff first when the\n  user has not already authorized a rebuild.\n- **Editing generated YAML directly.** Regeneration overwrites such edits.\n  Change the source fragment, primitive, discriminator, or composition.\n- **Confusing product and schema versions.** Product v1.x uses entity API v2,\n  while each Schema has its own compatibility version.\n- **Passing entity IDs as selectors.** Partial generation accepts registry\n  kind selectors, not entity IDs or schema filenames.\n- **Assuming every MCP process shares caches.** Regeneration clears the cache\n  in its own process. Restart or call existing reload tools in other granular\n  MCP processes when they must observe changed contracts immediately.\n- **Treating tolerant validation as valid data.** Tolerant mode supports\n  migration; it does not waive schema findings or release gates.\n- **Ignoring an `errors` mapping.** Generation is atomic. Any reported error\n  means no planned output from that call was written.\n- **Promising a rebuild without running it.** When regeneration is requested,\n  call `regenerate_schemas` in the same turn and report its actual result.\n\n## Full reference\n\n`regenerate_schemas(kinds=None)` renders the registry in deterministic order.\nKind names are normalized to lowercase registry selectors. Unknown selectors,\ninheritance failures, invalid merge strategies, and unsafe output paths appear\nunder `errors`.\n\n`get_schema_contract(kind, discriminator=None)` returns the selected contract.\nThe contract is the Schema entity's `spec` block because that is the runtime\nsurface consumed by processkit servers.\n\n`get_validation_mode(kind, discriminator=None)` returns the selected mode.\nMissing schemas return a structured error instead of silently choosing a mode.\n\nAnti-patterns:\n\n- Hand-editing `_generated\u002F` output.\n- Rebuilding schemas from an installed tree that lacks canonical sources.\n- Using schema regeneration as a substitute for an entity-data migration.\n- Converting a discriminator variant into a false top-level entity kind.\n",{"name":5,"metadata":46,"description":59},{"processkit":47},{"id":48,"layer":14,"created":49,"version":50,"category":51,"provides":52,"apiVersion":58},"SKILL-schema-management",1784678400000,"1.0.0-alpha.1","processkit",{"mcp_tools":53,"primitives":57},[54,55,56],"regenerate_schemas","get_schema_contract","get_validation_mode",[],"processkit.projectious.work\u002Fv2","Manage generated processkit schema contracts through deterministic MCP rebuild and inspection workflows.\n","main","4876a92620ee792aac2ac9a1a806322d8a572367","src\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fschema-management","https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit","https:\u002F\u002Fprojectious-work.github.io\u002Fprocesskit\u002F","https:\u002F\u002Fgithub.com\u002Fprojectious-work","2026-11-11 23:24:18",{"source":8,"skillName":5,"commands":68,"prompt":78,"zipAvailable":79},[69,72,75],{"tool":70,"command":71},"npx","npx skills add projectious-work\u002Fprocesskit --skill schema-management",{"tool":73,"command":74},"bunx","bunx skills add projectious-work\u002Fprocesskit --skill schema-management",{"tool":76,"command":77},"pnpm","pnpm dlx skills add projectious-work\u002Fprocesskit --skill schema-management","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fschema-management\u002FSKILL.md",true,[81,87,91,97],{"path":82,"resourceType":83,"resourceTypeDesc":84,"sizeBytes":85,"sourceHtmlUrl":86},"mcp\u002Fmcp-config.json","REFERENCE","参考文档",237,"https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fschema-management\u002Fmcp\u002Fmcp-config.json",{"path":88,"resourceType":83,"resourceTypeDesc":84,"sizeBytes":89,"sourceHtmlUrl":90},"mcp\u002FSERVER.md",796,"https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fschema-management\u002Fmcp\u002FSERVER.md",{"path":92,"resourceType":93,"resourceTypeDesc":94,"sizeBytes":95,"sourceHtmlUrl":96},"mcp\u002Fserver.py","SCRIPT","脚本",3243,"https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fschema-management\u002Fmcp\u002Fserver.py",{"path":98,"resourceType":93,"resourceTypeDesc":94,"sizeBytes":99,"sourceHtmlUrl":100},"scripts\u002Ftest_schema_management.py",2639,"https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fschema-management\u002Fscripts\u002Ftest_schema_management.py",[102,121,142,159,177,188],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":109,"publishedAt":41},"01M6X5MTC89B4ZGXW3JVSQCPF8","skill-management","Manage Skill package manifests as v1 ontology entities.","https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fskill-management\u002FSKILL.md",[108],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[25,110,37,111,112,113,114,115,30,104,116,34,117,38,118,119,120],"skill management","transition","skill package","v1","manifests","as","ontology","list","package","update","create",{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":41},"01M6X5M5G6YJ96AMZGSCZJ1D13","proposition-management","Record claims, risks, beliefs, world facts, WSJF estimates, and assumptions through the Proposition interface.","https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fproposition-management\u002FSKILL.md",[],[128,25,129,130,131,132,133,134,30,37,38,119,120,135,136,137,138,139,140,141],"proposition management","proposition","index","record","query","world","log","creation","WSJF","claims","facts","updates","interface","event",{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":148,"publishedAt":41},"01M6X5KMQ83QN9M6MPWZM7344F","ontology-management","Manage generated v1 ontology entities that do not require a dedicated domain server.","https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fontology-management\u002FSKILL.md",[],[25,149,116,150,151,113,152,141,34,120,30,153,154,134,155,36,156,157,38,158],"ontology management","keep","generic","measurement","domain","do","roadmap","archive","lifecycle","iteration",{"skillNo":160,"name":161,"nameZh":6,"description":162,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":163,"categories":164,"keywords":165,"publishedAt":41},"01M6X5KCY2DN3SM21RERSFNEBT","okf-compatibility","Import, export, and validate conformant Open Knowledge Format bundles.","https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fokf-compatibility\u002FSKILL.md",[],[166,167,168,169,170,171,172,37,173,174,175,38,176],"okf compatibility","compatibility","okf","import","bundle","bundles","export","format","knowledge","open","validate",{"skillNo":178,"name":179,"nameZh":6,"description":180,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":181,"categories":182,"keywords":183,"publishedAt":41},"01M6X5JA8S5PNGJVFW4EQY8T83","capability-management","Manage versioned Capability entities and their governed lifecycle.","https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Fsrc\u002Fcontext\u002Fskills\u002Fprocesskit\u002Fcapability-management\u002FSKILL.md",[],[184,25,185,37,186,140,141,150,30,131,34,187,134,117,111,157,38,130,119,120],"capability","capability management","changes","queries",{"skillNo":189,"name":190,"nameZh":6,"description":191,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":192,"categories":193,"keywords":194,"publishedAt":41},"01M6X5GY2P4FDKG20DDDD8GGB2","pk-wrapup","Use the session-handover skill to generate an end-of-session handover","https:\u002F\u002Fgithub.com\u002Fprojectious-work\u002Fprocesskit\u002Fblob\u002Fmain\u002Farchive\u002Fprocesskit-install-20261101\u002Fharness\u002Fclaude-skills\u002Fpk-wrapup\u002FSKILL.md",[],[195,196,197,198,199,200,201,202],"pk wrapup","wrapup","session handover","end","use","session","handover","generate"]