Maafw

What it does

When your agent uses it

• Development work in your project

Example prompts

• “/maafw”

Requirements

• Python 3
• Node.js

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1先完整读取仓库根目录的 dev/docs/社区参考项目索引.md，按其中的“按任务选择参考项目”确定项目，并从索引解析本地路径；不要凭记忆猜测目录。
2. 2优先使用索引中的本地仓库进行 rg、文件读取、git log、git blame 和版本对比。开始引用前记录其当前 commit；需要判断新旧时再检查本地分支和远端跟踪信息。
3. 3本地仓库缺失或明确需要更新时，不要在系统临时目录或其他位置另行 git clone。用户要求同步或更新时使用 sync-reference-projects skill 的统一流程；只读任务中若版本新旧会实质性影响结论，则说明本地状态并取得同步授权。
4. 4仅当索引未收录所需项目，或本地仓库确实无法提供任务所需内容时，才访问 GitHub、Raw URL 或远端 API；访问前说明原因。远端查询不得替代对现有本地参考仓库的检查。

What it can do on your machine

Read from SKILL.md and the folder at commit bff320d. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • git

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Maafw loads about 1.1k tokens when it runs, and up to ~59k if it reads all its reference files. Until then it costs about 41 tokens; SKILL.md has 267 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~41

When it runs · the whole SKILL.md, loaded when a task matches

~1.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~59k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kqcoxn/MaaPipelineEditor at commit bff320d, republished under its MIT licence (© kqcoxn). 267 words, ~1,103 tokens.

name

maafw

description

MaaFramework 开发与集成指南。当任务涉及 MaaFramework 项目结构、Pipeline 协议、ProjectInterface V2 协议、自定义识别/动作（Custom/Agent）、Python/NodeJS/CSharp 等语言 Binding 集成、控制器配置、回调协议或运行时行为时使用。

project/
├── interface.json          # ProjectInterface V2 声明
├── assets/
│   ├── resource/           # Bundle：pipeline/、image/、model/
│   │   ├── pipeline/
│   │   ├── image/
│   │   ├── model/ocr/
│   │   └── default_pipeline.json
│   └── interface_zh.json   # 多语言翻译（可选）
└── agent/                  # Agent 自定义扩展（可选）

© kqcoxn, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 13 other files (references) in .agents/skills/maafw of kqcoxn/MaaPipelineEditor.

• SKILL.md
• references/1.1-快速开始.md
• references/1.2-术语解释.md
• references/1.3-Custom&Agent.md
• references/2.1-集成文档.md
• references/2.2-集成接口一览.md
• references/2.3-回调协议.md
• references/2.4-控制方式说明.md
• references/3.1-任务流水线协议.md
• references/3.2-ProjectInterface协议.md
• references/3.3-ProjectInterfaceV2协议.md
• references/4.1-构建指南.md
• references/4.2-标准化接口设计.md
• references/5.1-问题反馈.md

Open the folder on GitHubat commit bff320d