AgentSkillsCN

blueprint-descriptor-standard

应用 BDS-001，定义并审计用于注册表发现与 MCP 清单生成的 TypeScript/Node 蓝图描述符合约。

SKILL.md
--- frontmatter
name: blueprint-descriptor-standard
description: Apply BDS-001 to define and audit the TypeScript/Node blueprint descriptor contract used for registry discovery and MCP manifest generation.

Blueprint Descriptor Standard (BDS-001)

Use this skill when adding or updating blueprint descriptors so they remain rich enough for MCP exposure and audits without bundling workflow code.

When to Use

  • •Creating a new blueprint descriptor under packages/blueprints/src/descriptors/
  • •Updating manifest generation that reads blueprint descriptors
  • •Auditing blueprint governance fields (owner, costCenter, roles, SLA, classification)

Instructions

  1. •Keep IDs consistent: blueprintId must equal metadata.id and registry key.
  2. •Include governance fields: metadata/security/operations are required.
  3. •Include schemas: input + config always; output is required for MCP-exposed tools.
  4. •Validate aiHints: exampleInput must validate against input; for MCP tools, exampleOutput must validate against output.
  5. •Use CSS-001 classification semantics (do not restate).

See references/blueprint-descriptor-standard.md for the normative specification.