skillset-dev-compiler
Implement or review Skillset compiler behavior, package ownership, rendering, command composition, operation results, and generated-output semantics. Use for changes under apps/skillset or packages/core, registry, lint, transforms, toolkit, or workbench that are not primarily shared schema-contract changes.
- License 许可
- MIT
- 最近更新
- 2026-11-01
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- skillset-dev-compiler
- metadata
- { "version": "0.1.0", "skillset.schema": "1" }
- description
- Implement or review Skillset compiler behavior, package ownership, rendering, command composition, operation results, and generated-output semantics. Use for changes under apps/skillset or packages/core, registry, lint, transforms, toolkit, or workbench that are not primarily shared schema-contract changes.
02 资源文件 1
- 参考文档references/package-map.md2.9 KB
03 SKILL.md 正文
Skillset Compiler Development
Work From The Owner
- Read
docs/project/tenets.md, the relevant ADRs, anddocs/development/package-ownership.md. - Inspect the closest implementation, its package-root API, and focused tests before editing.
- Place provider-neutral compiler facts and write semantics in
@skillset/core; keep CLI parsing, presentation, prompts, and exit mapping inapps/skillset. - Keep provider evidence in
@skillset/registry, shared source shape in@skillset/schema, authoring diagnostics in@skillset/workbench, and reusable lint or transform behavior in their owning packages. - Return structured diagnostics and operation facts from compiler layers. Do not hide writes, call
process.exit, or make core behavior depend on terminal presentation.
Read references/package-map.md when choosing an owner, changing a large implementation anchor, or deciding whether an internal should become a package-root export.
Implement And Verify
- Add focused tests for each behavior change and run them with
bun run test:focused -- <test-files...>. - Run
bun run typecheckfor TypeScript or package changes. - Run the relevant deterministic or adapter conformance lane for rendering, destination, provider, or structured-result changes.
- If self-hosted source or generated-output promises change, run
bun run skillset:build, inspect the generated diff, then runbun run skillset:checkandbun run skillset:check:outputs. - Add the required package Changeset and Skillset change entry when the release or source-change contracts require them.
- Run
bun run checkbefore handoff.
Do not publish, install generated artifacts, mutate user-level provider configuration, or turn provider-specific behavior into fake portable behavior.
04 同仓库更多 Skills
use-skillset
Use the skillset compiler in a repo with skillset.yaml or a .skillset/ directory. Covers creating a workspace, adding skills, rules, agents, hooks, and plugins, building and checking Claude, Codex, and Cursor output, repairing stale or hand-edited generated files, recording changes, cutting releases, importing existing skills, and marketplaces. Use when asked to add a rule, record a change, cut a release, or fix generated output.
broken
42
reference
Keep project references organized for review.
portable-proof
Proves that generated Agent Skills are accepted by pinned external consumers.
plugin-proof
Proves immediate-child skill fidelity inside an Agent Plugins package.
sink
Kitchen-sink skill exercising shared resources and custom resource mappings.