Files
deepseek-harness/packages/skill
yudshj ca3ad0cc85 fix(office): 按 review 意见同步文档事实、Office 行兜底、拒绝用例结构与主运行时默认值归属
- Native Office 工具 Agent Note:移除已删除的 `/locate` 子路径、把「PDF 页数」改为转换器报告的页数、补全输出文件删除条件、把「工具不可用」统一为「不在工具列表中」,中英文与配对哈希同步。
- skill-office / tool-office README:Progressive loading 与 unavailable 提示摘要按实际行为描述,重录 i18n 哈希。
- Office 行:结果只含图片块时不再回退到扁平化输出(避免向用户显示附件引用 JSON),用例随之改为断言没有输出区。
- tool-office 用例:参数拒绝与路径拒绝拆成两组,用 resolve 调用次数显式表达「是否碰文件系统」。
- office-docx / office-xlsx:去掉引导语会让模型把「只做内容检查」误读成「需要渲染」,并刷新内嵌技能正文的 office 快照。
- visual-intent 夹具:用具名 intent 常量代替下标引用。
- Desktop:主运行时「运行时目录旁」的布局假设只保留在 Host 侧,壳传空参数表示使用默认,行为不变。
2026-11-04 18:18:03 +08:00
..
2026-11-04 15:50:06 +08:00
2026-11-04 15:50:06 +08:00
2026-11-04 15:50:06 +08:00

description, kind
description kind
The skill group map: reusable agent instructions discovered from providers and loaded through the session catalog and skill tool, for users and maintainers navigating the group. package-group

skill/ — skill capability family

English | 中文

Summary

The skill family lets agents and users discover and load reusable task instructions only when needed. Use skill/ to combine catalogs and expose one instruction set per name; choose skill-filesystem for project, custom, or user-directory discovery, skill-office for Word, PowerPoint, and Excel workflows. Add tool-skill when models should receive a sorted, durable session catalog, load full instructions through the skill tool, or accept direct /name invocation. Different sources produce the same model-visible format, and model access requires at least one source.

Table of Contents


Packages

Package Role ctx key
skill/ Registry that merges skill catalogs from any provider and resolves the winning skill for a name ctx.skills
skill-filesystem/ Discovers skills from project, custom, and user directories and watches them for changes registers on ctx.skills
skill-office/ Bundles Word, PowerPoint, and Excel workflows with structural file checks registers on ctx.skills
tool-skill/ Publishes the session skill catalog and the model-facing skill loader tool registers on ctx.tools
tool-workspace-dependencies/ Reports bundled Office interpreter paths and versions for Desktop and SDK carriers registers on ctx.tools

Start with the subsystem reference for the shared vocabulary, then read the Agent Notes for the design rationale.


See skill-badge for the experimental optional capability.

Dev Note

Working context for maintainers — click to expand

None.