bcquality/schemas/skill-index.schema.json
dayland 25accf021e Add machine-readable review contracts
Generate a deterministic action-skill index from frontmatter, publish structural schemas for orchestration and findings, and validate flat review composition in CI.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 76eb42c4-2acd-4f9c-a898-f4a44f9d46f7
2026-09-11 13:55:03 +01:00

84 lines
2.8 KiB
JSON

{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://github.com/microsoft/BCQuality/schemas/skill-index.schema.json",
"title": "BCQuality action-skill index",
"type": "object",
"additionalProperties": false,
"required": ["version", "generatedAt", "skillCount", "sourceSnapshot", "skills"],
"properties": {
"version": { "const": 1 },
"generatedAt": { "type": "string", "format": "date-time" },
"skillCount": { "type": "integer", "minimum": 0 },
"sourceSnapshot": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
"skills": {
"type": "array",
"items": { "$ref": "#/definitions/skill" }
}
},
"definitions": {
"stringArray": {
"type": "array",
"items": { "type": "string", "minLength": 1 }
},
"skill": {
"type": "object",
"additionalProperties": false,
"required": [
"path",
"layer",
"id",
"version",
"title",
"description",
"inputs",
"outputs",
"filters",
"subSkills",
"sourceSha256"
],
"properties": {
"path": { "type": "string", "pattern": "^(microsoft|community|custom)/skills/.+\\.md$" },
"layer": { "enum": ["microsoft", "community", "custom"] },
"id": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" },
"version": { "type": "integer", "minimum": 1 },
"title": { "type": "string", "minLength": 1 },
"description": { "type": "string", "minLength": 1 },
"inputs": { "$ref": "#/definitions/stringArray" },
"outputs": {
"type": "array",
"minItems": 1,
"maxItems": 1,
"items": { "const": "findings-report" }
},
"filters": {
"type": "object",
"additionalProperties": false,
"required": ["bc-version", "technologies", "countries", "application-area"],
"properties": {
"bc-version": {
"type": "array",
"items": {
"oneOf": [
{ "type": "integer", "minimum": 1 },
{ "type": "string", "pattern": "^(all|[1-9][0-9]*\\.\\.[1-9][0-9]*|[1-9][0-9]*\\.\\.)$" }
]
}
},
"technologies": { "$ref": "#/definitions/stringArray" },
"countries": { "$ref": "#/definitions/stringArray" },
"application-area": { "$ref": "#/definitions/stringArray" }
}
},
"subSkills": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^(microsoft|community|custom)/skills/.+\\.md$"
}
},
"sourceSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
}
}
}
}