Skip to content

Unify skill description metadata for progressive loading; bump all 4 plugins#82

Merged
qxbyte merged 1 commit into
mainfrom
claude/skill-metadata-progressive-load-a6wltz
Jul 6, 2026
Merged

Unify skill description metadata for progressive loading; bump all 4 plugins#82
qxbyte merged 1 commit into
mainfrom
claude/skill-metadata-progressive-load-a6wltz

Conversation

@qxbyte

@qxbyte qxbyte commented Jul 6, 2026

Copy link
Copy Markdown
Owner

背景

Agent(如 Claude Code)加载 skill 是渐进式的:启动时只把每个 skill 的 frontmatter description 常驻上下文,模型据此判断是否唤起该 skill,之后才读入 SKILL.md 正文。所以 description 是决定"能否被按需正确唤起"的唯一元数据。

改动

把全部 11 个 skilldescription 统一为一套轻量模板:

用途场景开头(Use when …)→ 做什么/产物 → Trigger 触发词/命令 → 边界/谁触发
  • ragkit(query / embed / status / eval):补上 /ragkit:* 触发命令 + 彼此的交叉引用边界(query↔embed↔status)。
  • obsidian-wiki(wiki-struct / wiki-curate / wiki-orchestrate):补上结构层↔内容策展的交叉引用边界,删去版本史噪音(v2.0.0 剥离)。
  • specode(specode / intake / distill):统一 Trigger: 标签,删去 intake 的 replaces the old brainstorming… 版本史噪音。
  • task-swarm:统一 Trigger: 标签,补上"specode 执行阶段委托至此"的触发场景。

各插件保持既有语言(specode / task-swarm / ragkit 英文,obsidian-wiki 中文)。skill 正文与行为逻辑一字未动——纯元数据变更。

版本(patch,零行为变化)

插件 版本
specode 6.1.4 → 6.1.5
task-swarm 0.10.3 → 0.10.4
obsidian-wiki 2.0.3 → 2.0.4
ragkit 0.1.1 → 0.1.2

每个都同步了 plugin.json + marketplace.json 条目 + CHANGELOG。

验证

  • scripts/check_marketplace_versions.py 版本同步门禁通过。
  • specode + task-swarm 测试 264 项通过;obsidian-wiki 41 项通过。
  • ragkit 的 3 个 collection error 是本机缺 numpy(向量后端的测试期依赖)导致,与本次改动无关。

🤖 Generated with Claude Code

https://claude.ai/code/session_01322b4SmfbKMY1DQcutdgZ7


Generated by Claude Code

…plugins

A skill's frontmatter `description` is the only metadata kept resident during
progressive loading — the model decides whether to invoke a skill from it
alone, before the body is ever read. Rewrote all 11 skills' descriptions onto
one lightweight template: "use-when scenario → what it does/produces → trigger
words/commands → boundary / who invokes it", and dropped version-history noise
from the descriptions (e.g. intake's "replaces the old brainstorming…",
wiki-curate's "v2.0.0 剥离"). Each plugin keeps its established language
(specode / task-swarm / ragkit English; obsidian-wiki Chinese). Skill bodies
and behavior are unchanged.

Patch bumps (description metadata only, zero behavior change):
- specode 6.1.4 → 6.1.5
- task-swarm 0.10.3 → 0.10.4
- obsidian-wiki 2.0.3 → 2.0.4
- ragkit 0.1.1 → 0.1.2

Version-sync gate passes; specode+task-swarm (264) and obsidian-wiki (41)
test suites pass.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01322b4SmfbKMY1DQcutdgZ7
@qxbyte qxbyte merged commit 9f84541 into main Jul 6, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants