技能
- 作者仓库星标 277
- 作者仓库 akashic-agent
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @kachofugetsu09 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 需要 · Vendor-specific
- 兼容的系统
- Linux
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 读取环境变量
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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`)
章节与文件索引
按说明文件中的顺序排列。
技能目录结构
frontmatter 字段说明
写作原则
创建流程
改写已有技能
文件/命令 -> write_file · edit_file · name · description · metadata · always · true · false
内容校验值 -> de1748fa29da
当前原文的自动摘译,尚未人工审校。
技能目录结构
用
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)