Skip to content
Skills Library
AI & agents · Building & coding

develop-akashic-plugin

/develop-akashic-plugin

给自己扩展新能力时使用:编写一个 Akashic 插件(新工具、WebUI 页面、随插件发布的 Skill、后台服务),安装到当前运行实例并验收。用户说做个插件、加个工具/功能/页面、扩展你的能力、改某个插件时使用。

Licence
MIT
Last repository change
27.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
7
Scripts
3
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 3 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: templates/page/plugin.py, templates/page/web_module.js, templates/tool/plugin.py

What it does and when to use it

给自己扩展新能力时使用:编写一个 Akashic 插件(新工具、WebUI 页面、随插件发布的 Skill、后台服务),安装到当前运行实例并验收。用户说做个插件、加个工具/功能/页面、扩展你的能力、改某个插件时使用。

Original author description

给自己扩展新能力时使用:编写一个 Akashic 插件(新工具、WebUI 页面、随插件发布的 Skill、后台服务),安装到当前运行实例并验收。用户说做个插件、加个工具/功能/页面、扩展你的能力、改某个插件时使用。

How it works

  1. 流程
  2. 知识来源,按顺序
  3. 省步数
  4. 硬规则
Original SKILL.md headings · 50 lines, 181 words
SKILL.md preview
---
name: develop-akashic-plugin
description: 给自己扩展新能力时使用:编写一个 Akashic 插件(新工具、WebUI 页面、随插件发布的 Skill、后台服务),安装到当前运行实例并验收。用户说做个插件、加个工具/功能/页面、扩展你的能力、改某个插件时使用。
---

# 开发 Akashic 插件

插件是给自己加能力的唯一正式方式:写源码 → git commit → 安装到当前实例 → 实际用一次验收。
不要改安装 cache、`plugin-home`、`runtime/` 下的指针或别的插件的 `plugin-data`,也不要手写 manifest。

## 流程

1. **定目标和形态**:要的是模型可调用的工具、WebUI 页面、Skill,还是后台服务?只做能交付的最小版本。
2. **建源码仓库**:在 `$AKASHIC_WORKSPACE/plugin-src/<name>/` 新建目录并 `git init`。一个插件一个仓库,插件根目录必须有 `plugin.py`。
3. **从模板起步**:按下表用文件读取工具读模板,写一份到源码目录,改名字和逻辑。`name` 在当前实例里必须唯一。
4. **只查需要的接口**:按下面的知识来源顺序读真实代码,不凭记忆写 API。
5. **提交并安装**:`git add -A && git commit`,然后加载 `verify-akashic-plugin`,按它安装并验收。
6. **修到能用为止**:失败就改同一个插件,重新 commit、重新安装新的 commit。能用后汇报插件 ID、commit、验收证据和没验证到的部分,不追加没被要求的功能。

## 知识来源,按顺序

1. 本 skill 的模板和 `references/extension-points.md`:先确定用哪个扩展点。
2. 真实合同:先确认当前执行环境可读的 Core 和插件源码目录,再读 `agent/plugin_composition/context.py` 与提供方的 `<插件名>/contract.py`。
   开发实例通常提供 `$AKASHIC_CORE_ROOT`、`$AKASHIC_PLUGIN_DISTRIBUTION/sources/`;Host Bridge 宿主可能没有这两个变量,
   此时从 `$PYTHONPATH` 列出的目录核对 `agent/plugin_composition/context.py`,同一运行 checkout 的 `plugins/` 可读内置合同。
   容器内路径不能直接当宿主路径;目录必须实际存在,找不到就报告缺少源码入口,不猜路径或复制过期合同。
3. 同类的真实插件:找一个用同一 ServiceKey 的内置插件读它的 `plugin.py`。
4. 当前源码仓库的 `docs/INDEX.md` 是需求与设计入口;分发产物可能不带 `docs/`。签名以真实合同为准,语义冲突要指出,不能用实现覆盖已确认需求。

`load_skill` 返回的 `base_directory` 就是本 skill 目录,下表路径都相对它:

| 用途 | 文件 |
|---|---|
| 扩展点速查:工具、Skill、页面、提示词材料、后台任务、配置与数据 | `references/extension-points.md` |
| WebUI 模块的硬性限制、挂载点、主题 token、亮暗主题 | `references/web-ui.md` |
| 工具插件模板(一个文件) | `templates/tool/plugin.py` |
| 页面插件模板(三个文件) | `templates/page/plugin.py`、`templates/page/web_module.js`、`templates/page/web_module.css` |

## 省步数

一轮最多约 40 次模型输出,开发控制在 15 次以内,留足验收和汇报。只读模板和真正要用的那一两个合同文件,不通读插件源码;
WebUI 页面读 `references/web-ui.md` 和 `templates/page/` 就够了,不再去找 ui 合同、类型定义或别的页面插件。不要用单独的 python 去 import 插件做自测:
插件模块只有宿主加载器能导入,安装本身就是加载检查,失败原因看 `plugin-status` 的 `error`。

## 硬规则

- 唯一入口是 `async def apply(ctx)`;`api_version = 3`、`name`、`version` 写成顶层字面量。
- 依赖的服务写进 `inject`,用 `ctx.require(KEY)` 取。资源、监听、后台任务都交给 `ctx.effect` / `ctx.spawn` 管理,
  不在 import 时启动进程、开端口或发消息。
- 配置读 `ctx.config`(没有配置时是空对象),自己校验;插件自己的持久数据只写 `ctx.data_root`。
- 外部 Python 依赖写 `requirements.txt`,没有时不要假设第三方包已装。
- 不恢复已删除的旧协议:`class Plugin`、`apply(ctx, config)`、`is_active`、`skill_roots`、TOML MCP 声明、
  `plugin_latest`、stable/latest 候选晋升都已退役。
Files in this package (7)
  • SKILL.md 4 KB
  • references/extension-points.md 3 KB
  • references/web-ui.md 3 KB
  • templates/page/plugin.py 1 KB
  • templates/page/web_module.css 1 KB
  • templates/page/web_module.js 1 KB
  • templates/tool/plugin.py 2 KB

Versions

The database has no other skills named develop-akashic-plugin.

Database snapshot: 13.11.2026 · package version 32e0d6041ee3 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96plugin-system
    当用户要求安装、更新、卸载 Akashic 插件,改变 agent 能力,或询问插件何时生效、如何检查结果时使用。说明正式入口、局部换代、状态核对与数据保留。
  • 96verify-akashic-plugin
    把自己写好的插件安装到当前运行实例并验收:提交、安装、核对状态、实际用一次、如实汇报。写完或改完插件、要确认插件是否生效时使用。
  • 90skill-pilot-webui
    Open and operate the local Skill Pilot WebUI through the browser for demos, walkthroughs, settings changes, task execution, and terminal-based education flows. Use when the user wants the agent to drive Skill Pilot as a human would in the browser, open a specific WebUI feature,…
  • 82webui-reference
    Use when writing or reviewing WebUI application or framework code. Load the application's installed reference or the WebUI source checkout's canonical reference.
  • 100open-webui
    Open WebUI is a self-hosted web chat interface for local and cloud language models that connects to Ollama and any OpenAI-compatible API. Use when a user asks to install or deploy Open WebUI with Docker or pip, connect Open WebUI to Ollama, llama.cpp, vLLM or OpenAI, configure…
  • 100install-openwebui
    Installs and wires up Open WebUI end to end, so a non-technical user gets a working local AI chat in the browser instead of setup instructions. Use when the user says "install Open WebUI", "set up Open WebUI", "get Open WebUI running", "connect Open WebUI to Ollama", "Open WebUI…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.