zk-data-agent/docs/task-002-project-skills.md

Task 002：项目级 Skills

目标

允许项目维护者直接在 workspace 根目录添加 skills：

skills/
  my-skill/
    SKILL.md

查找顺序

当存在 workspace cwd 时：

1. cwd/skills/*/SKILL.md
2. src/skills/bundled/*/SKILL.md
3. Python 动态 skills

项目级 skills 优先于同名的内置目录 skill 或 Python 动态 skill。

接入点

• Skill 工具执行时，会通过当前 runtime cwd 解析项目级 skills。
• /skills 会列出当前 workspace 下的项目级 skills。
• Web UI /api/skills 会列出当前 Working dir 下的项目级 skills。

说明

• 项目级 skill 与内置目录化 skill 共用同一套 SKILL.md front matter 格式。
• name、aliases、allowed_tools 保持面向机器的英文字段。
• skill 正文可以使用中文或英文维护。