Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-10-07 07:36:54 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Add machine-readable review contracts (#182)

Browse source 
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>

Co-authored-by: dayland <dayland@microsoft.com>
Copilot-Session: 76eb42c4-2acd-4f9c-a898-f4a44f9d46f7
This commit is contained in:
dayland 2026-09-15 10:27:40 +02:00 • committed by GitHub
parent 852a676285
commit b74967bc5b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
8 changed files with 803 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

84
schemas/skill-index.schema.json Normal file
View file

@ -0,0 +1,84 @@
{
"$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}$" }
}
}
}
}