Skills

介绍

Tuanjie AI Skills 是 Tuanjie AI 智能体的专业能力扩展模块。一个 Skill 就是一个独立目录，把完成某类专项任务所需的指令流程、脚本、模板、参考文档打包成可被智能体自动发现、按需激活的标准化能力。

它让基础 AI 可以快速拥有专业领域能力（如代码评审、API 检测、部署、自动化流程），不用每次都重新描述复杂规则，也不会占用过多上下文。

什么是 Skills？

Skills 是可重复工作流程的可重用能力。它们通常包含：

指令：定义如何执行特定任务
脚本：可执行的代码
引用：相关文档和资源
元数据：名称、描述和触发条件

Skills 的核心价值

能力扩展：一键给 AI 增加专业技能，覆盖开发、测试、运维、流程自动化等场景
流程标准化：把团队固定工作流封装成 Skill，确保 AI 执行统一、结果稳定
知识共享：Skill 可在团队内共享，个人经验变成可复用的工具
资源一体化：内置脚本、模板、文档，AI 激活后直接使用
轻量高效：平时只加载名称和描述，用到时才加载完整内容，节省资源

适合用 Skills 的场景

你经常重复做某一类任务（例如：生成周报、整理会议纪要、把表格导出为 XLSX/PDF、做代码审查 checklist）
你希望把"做事的步骤/规范/约束"固化成模板，让模型在会话中随时调用
你希望为特定团队/项目提供统一的工作流（放在项目内 .codely-cli/skills/）

不适合用 Skills 的场景：

只是想运行内置命令（例如 /help、/chat 等）
技能内容需要真实执行外部程序/访问网络/读写文件——Skills 本身不是执行环境，它主要提供说明 + 模板

通过 GUI 管理 Skills

在对话框输入 '/'，在下拉菜单中选择 "Manage skills"。或者直接输入 "/skills"。
在打开的对话框口中，我们预设了一些 skills 供您直接使用。您也可以创建自己的 skill。
创建新的skill后，请开启新的对话会话，新增的 skill 将在新会话启动时完成加载。
在对话窗口输入 '@' 即可快速选中您新增的 skill。

创建skill时Project 与 Global 的区别：

Project 代表该 skill 在当前项目中使用。

Global 代表该 skill 在所有项目中都可以被使用。

通过 CLI 管理 Skills

Skill 发现路径与优先级

Tuanjie AI 会自动从三个位置加载 Skill，优先级从高到低：

工作区 Skill（Workspace Skills）

路径：.codely-cli/skills/ 或 .agents/skills/
作用：团队共享，跟随项目，优先级最高

个人 Skill（User Skills）

路径：~/.codely-cli/skills/ 或 ~/.agents/skills/
作用：个人全局使用，所有项目都生效

扩展 Skill（Extension Skills）

作用：随扩展插件自带，安装扩展即可使用

优先级规则：

工作区 Skill > 个人 Skill > 扩展 Skill

同层级内：.agents/skills/ 优先于 .codely/skills/

Skill 工作原理

发现：新建会话时，Tuanjie AI 扫描所有路径，加载 Skill 名称与描述
匹配：AI 根据你的需求，自动判断是否需要激活某个 Skill
确认：界面提示你是否允许激活该技能
加载：同意后，AI 加载该 Skill 的完整指令、目录与资源
执行：AI 按 Skill 定义的流程完成任务，整个会话持续生效

交互式会话内管理

在 Tuanjie AI 对话输入框中使用 /skills 系列命令：

/skills list：列出所有已发现的技能及状态
/skills enable <技能名>：启用技能（默认作用于用户级别）
/skills disable <技能名>：禁用技能（默认作用于用户级别）
/skills reload：重新扫描并加载所有技能

如需控制工作区范围，加参数：

--scope workspace

示例：

/skills disable api-checker --scope workspace

终端命令行管理

# 列出所有技能
codely skills list

# 链接本地技能目录
codely skills link /path/to/your/skills

# 链接到工作区
codely skills link /path/to/your/skills --scope workspace

# 安装技能（Git / 本地目录 / .skill 包）
codely skills install https://github.com/xxx/skill.git
codely skills install ./my-skill
codely skills install ./package.skill

# 安装到工作区
codely skills install ./my-skill --scope workspace

# 卸载技能
codely skills uninstall my-skill --scope workspace

# 启用/禁用
codely skills enable my-skill
codely skills disable my-skill --scope user

如何触发并使用 Skill

确保技能已被发现：/skills list 能看到
直接用自然语言描述任务，例如："帮我检查这个 API 是否可用"
AI 会自动匹配并提示你激活对应 Skill
确认激活后，AI 会按 Skill 内置流程执行任务

创建自定义 Skills

快速创建（推荐）

使用内置的 skill-creator 技能：

在对话里直接输入：

create a new skill called 'api-auditor'

Tuanjie AI 会自动生成：

技能目录（与技能名一致）
SKILL.md 主文件
scripts/、references/、assets/ 标准结构

手动创建

标准目录结构

my-skill/
├── SKILL.md       # 必须：技能元数据 + 指令
├── scripts/       # 可选：脚本
├── references/    # 可选：文档
└── assets/        # 可选：模板、资源

SKILL.md 格式

采用 YAML 元数据 + Markdown 指令：

---
name: api-auditor
description: Audit and test API endpoints. Use when user asks to check, test, or audit URL/API.
---

# API 审计技能说明

你是专业 API 测试专家。

## 执行流程

1. 获取用户提供的 URL。
2. 调用 scripts/audit.js 检测接口状态。
3. 返回清晰的检测结果与建议。

## 必须遵守

- 必须使用本技能目录下的脚本。
- 必须输出结构化结果：目标、状态、详情、建议。

重要规则：

name 必须与目录名完全一致
description 要写清楚功能 + 触发场景，AI 才能准确匹配

最佳实践

描述优化：编写清晰、具体的描述，帮助 AI 正确选择 Skill
工具权限管理：遵循最小权限原则，只授予 Skill 完成任务所需的工具
模块化设计：将复杂任务分解为多个可复用的 Skill
版本控制：将 Skill 纳入版本控制，便于团队协作
文档完善：为 Skill 添加详细的使用说明和示例

介绍​

什么是 Skills？​

Skills 的核心价值​

适合用 Skills 的场景​

通过 GUI 管理 Skills​

通过 CLI 管理 Skills​

Skill 发现路径与优先级​

Skill 工作原理​

交互式会话内管理​

终端命令行管理​

如何触发并使用 Skill​

创建自定义 Skills​

快速创建（推荐）​

手动创建​

标准目录结构​

SKILL.md 格式​

最佳实践​

介绍