技能

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

技能目录结构

用 write_file 或 edit_file 直接创建/修改文件,无需任何脚手架脚本。

frontmatter 字段说明

name:技能目录名(小写,连字符) description:最重要的字段。agent 靠它判断何时触发此技能,务必包含功能描述和触发词 metadata:运行配置 always:true = 每轮对话都注入完整正文;false = 按需加载(默认) requires.bins:所需 CLI 工具,缺失时技能标记为不可用

写作原则

简洁优先:SKILL.md 会被注入到 context,每个 token 都有成本。 只写 agent 不已知的信息 用示例命令代替大段文字解释 把冗长的参考内容放到 references/ 子文件,在 SKILL.md 里注明"详见 references/xxx.md" 正文控制在 100 行以内

创建流程

确认技能名称和保存位置(workspace 还是内置) 用 write_file 写入 SKILL.md 如有辅助脚本,写入 scripts/ 目录 验证:requires.bins 里的命令是否正确

改写已有技能

改写时重点检查: frontmatter 是否有 metadata 字段(旧技能可能缺失) requires.bins 是否列全了依赖 正文是否有指向不存在脚本的引用(如 init_skill.py) 安装命令是否适配当前系统(Linux 用 uv/pacman/apt,而非 brew)

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@kachofugetsu09 · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
需要 · Vendor-specific
兼容的系统
Linux
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# Skill 创建指南

## 技能目录结构

```
$HOME/.akashic/workspace/skills/{skill-name}/   ← 用户自定义技能(优先)
  SKILL.md                                  ← 必须
  scripts/                                  ← 可选,放辅助脚本
  references/                               ← 可选,放参考文档

项目/skills/{skill-name}/                  ← 内置技能
  SKILL.md
```

用 `write_file` 或 `edit_file` 直接创建/修改文件,无需任何脚手架脚本。

## SKILL.md 格式

```markdown
---
name: skill-name
description: 一句话说明技能功能 + 触发场景。触发词:词1, 词2, 词3
metadata: {"akashic": {"always": false, "requires": {"bins": ["curl"], "env": ["API_KEY"]}}}
---

# 技能标题

正文指令...
```

### frontmatter 字段说明

- `name`:技能目录名(小写,连字符)
- `description`:**最重要的字段**。agent 靠它判断何时触发此技能,务必包含功能描述和触发词
- `metadata`:运行配置
  - `always`:`true` = 每轮对话都注入完整正文;`false` = 按需加载(默认)
  - `requires.bins`:所需 CLI 工具,缺失时技能标记为不可用
  - `requires.env`:所需环境变量,缺失时技能标记为不可用

## 写作原则

**简洁优先**:SKILL.md 会被注入到 context,每个 token 都有成本。

- 只写 agent 不已知的信息
- 用示例命令代替大段文字解释
- 把冗长的参考内容放到 `references/` 子文件,在 SKILL.md 里注明"详见 references/xxx.md"
- 正文控制在 100 行以内

**触发词要全**:中英文都写,覆盖用户可能说的各种表达方式。

## 创建流程

1. 确认技能名称和保存位置(workspace 还是内置)
2. 用 `write_file` 写入 SKILL.md
3. 如有辅助脚本,写入 `scripts/` 目录
4. 验证:`requires.bins` 里的命令是否正确

## 改写已有技能

改写时重点检查:
- frontmatter 是否有 `metadata` 字段(旧技能可能缺失)
- `requires.bins` 是否列全了依赖
- 正文是否有指向不存在脚本的引用(如 `init_skill.py`)
- 安装命令是否适配当前系统(Linux 用 `uv`/`pacman`/`apt`,而非 `brew`)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。