# 斜杠指令 (Commands)

> 👈 **[返回技能中心主页](../README.md)** | **[阅读详细斜杠指令开发指南](../../../../docs/slash-commands.md)**

这里包含 Undefined 系统所有的运行时业务斜杠命令实现。该底层引擎架构支持动态自动发现与注册。

## 目录结构
每一个具体的指令功能均表现为一个独立的文件夹。例如：

```text
commands/
├── admin/          # 管理员管理：列表/添加/移除（支持子命令，自动推断）
├── bugfix/         # 一键读取群上下文帮你诊断并回复 bug 发作原因的娱乐工具
├── copyright/      # 输出版权信息、开源协议与风险免责声明
├── faq/            # FAQ 管理：列表/查看/搜索/删除（支持自动推断子命令）
├── feedback/       # 意见反馈：提交/查看/删除公开反馈（支持自动推断子命令）
├── help/           # 打印基础指令集列表
├── ...
└── my_cmd/         # 开发你的新指令所放置的位置
```

## 创建与接入示例

要在系统里跑通一个斜杠指令，你需要新建目录并放入：

- `config.json`：命令元信息（名称、权限、限流、子命令、自动推断、帮助摘要等）
- `handler.py`：命令执行逻辑
- `README.md`：详细帮助文档（会被 `/help <command>` 自动读取并作为 Markdown 渲染到帮助图片中；需要纯文本时使用 `/help <command> -t`）

关于 `config.json` 的具体参数格式（包括子命令声明、自动推断配置、限流规则）以及 `handler.py` 的执行上下文和逻辑编写，请前往 **[斜杠指令开发指南](../../../../docs/slash-commands.md#🛠️-第二部分如何自定义扩展新的斜杠命令)** 查阅最新的开发说明。
