README
¶
skillkit
技能与资产契约——SKILL.md 渐进披露/领域包布局契约/装配血缘图 —— oagentkit 模块矩阵 tier 1（能力层，依赖 tier0）。
go get github.com/oagentkit/skillkit
| 包 | 职责 |
|---|---|
skill |
SKILL.md 渐进披露：元数据常驻、正文按需加载；多根技能库与版本判定 |
pack |
领域包（expert/pack 目录布局）的契约面 |
lineage |
装配血缘：expert → skill → MCP server 三类资产节点的依赖图 |
定位
tier 1 — 能力层，依赖 tier0。
- 本仓依赖的矩阵内仓：
guardx、textx。
外部依赖地板
gopkg.in/yaml.v3github.com/Masterminds/semver/v3
与 oekit 的关系
本矩阵（oagentkit，Agent/LLM 编排工具链）依赖 oekit（Open Easy Kit，Go 微服务工具链）：
oekit/pkg / oekit/concurrency / oekit/logx 等。oekit 是另一套独立矩阵，不是子品牌。
开发
go test ./... -race
go vet ./...
gofmt -l .
规范见 AGENTS.md。
License
MIT
- SKILL.md 的渐进披露是硬要求：元数据常驻、正文按需加载。 不得为了「一次读全」把正文塞进元数据 —— 那会让常驻上下文无谓膨胀。
pack的目录布局是契约面，改动布局等于 breaking，必须升 major。
Directories
¶
| Path | Synopsis |
|---|---|
|
Package lineage 装配血缘：expert → skill → MCP server 三类资产节点的 声明式依赖图，used_by/granted_by 反查字段的单一事实源（多个 list API 共享 一份反查计算，消灭双份漂移）。
|
Package lineage 装配血缘：expert → skill → MCP server 三类资产节点的 声明式依赖图，used_by/granted_by 反查字段的单一事实源（多个 list API 共享 一份反查计算，消灭双份漂移）。 |
|
Package pack 领域包（expert/pack 目录布局）的契约面：布局约定为 `_shared/`（平台共享基线）+ 各包目录（`<包>/`，`_` 前缀目录不算包）， LayoutDirs 是该约定的单一事实源（本包的 mcp/ 扫描与 skill.Library 的 skills/ 扫描共用——布局演进单点修改）。
|
Package pack 领域包（expert/pack 目录布局）的契约面：布局约定为 `_shared/`（平台共享基线）+ 各包目录（`<包>/`，`_` 前缀目录不算包）， LayoutDirs 是该约定的单一事实源（本包的 mcp/ 扫描与 skill.Library 的 skills/ 扫描共用——布局演进单点修改）。 |
|
Package skill 技能内容与元数据：SKILL.md 解析（frontmatter 围栏 + canonical checksum）、进程内技能库（多根扫描、热替换）、版本区间约束（decl/version）、 决策式按需加载（decision.go 的 use_skill 渐进披露）。
|
Package skill 技能内容与元数据：SKILL.md 解析（frontmatter 围栏 + canonical checksum）、进程内技能库（多根扫描、热替换）、版本区间约束（decl/version）、 决策式按需加载（decision.go 的 use_skill 渐进披露）。 |
Click to show internal directories.
Click to hide internal directories.