Skip to main content
ClaudeWave
EN, English
Skill29.9k repo starsupdated 4d ago

add-permission

The add-permission Claude Code skill provides a structured workflow for integrating permission management into FastGPT's new resources such as AgentSkill and Plugin. It guides developers through a decision tree to determine whether resources require simple or hierarchical permission inheritance, then directs them to appropriate guides, implementation checklists, and reference documentation for completing the integration across key files in the permission system.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/labring/FastGPT /tmp/add-permission && cp -r /tmp/add-permission/.agents/skills/support/permission/add-permission ~/.claude/skills/add-permission
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 新资源权限接入

## 你的资源是哪种类型?

```
资源有父子/文件夹结构吗?
     │
     ├─ 否 ──► 简单资源 ──► [快速入门](./guides/quick-start.md)
     │
     └─ 是 ──► 资源支持权限继承吗?
                    │
                    ├─ 否 ──► 简单资源 ──► [快速入门](./guides/quick-start.md)
                    │
                    └─ 是 ──► 继承型资源 ──► [完整接入](./guides/full-integration.md)
```

## 快速链接

| 我想... | 去看... |
|---------|---------|
| 5 步完成最小接入 | [快速入门](./guides/quick-start.md) |
| 接入继承型资源 | [完整接入](./guides/full-integration.md) |
| 检查遗漏项 | [实施清单](./checklist.md) |
| 理解权限系统原理 | [参考文档](./reference/README.md) |

## 关键代码位置

| 文件 | 用途 |
|------|------|
| `packages/global/support/permission/constant.ts` | 添加 `PerResourceTypeEnum` |
| `packages/global/support/permission/{resource}/` | 权限常量 + Permission 类 |
| `packages/service/support/permission/{resource}/auth.ts` | 鉴权函数 |
api-developmentSkill

FastGPT API 开发规范。重点强调使用 zod schema 定义入参和出参,在 API 文档中声明路由信息,编写对应的 OpenAPI 文档,以及在 API 路由中使用 schema.parse 进行验证。

ci-workflow-syncSkill

FastGPT CI workflow 双轨同步。当用户修改或新增 .github/workflows/ 下的 GitHub Actions workflow 时必须触发:同步更新 .forgejo/workflows/ 对应文件保持功能一致,或判断是否需要新建 Forgejo 版本。涉及 CI、GitHub Actions、Forgejo Actions、镜像构建、container registry、artifact、workflow yaml 改动、build-* workflow、test-* workflow 时也使用此技能。即使用户只提到"改一下 CI"或"加个 workflow"也应触发。

deprecate-workflow-nodeSkill

当用户需要弃用一个工作流节点(保留向后兼容、隐藏出模板面板)时触发该 skill。FastGPT 工作流节点的弃用流程标准化封装,覆盖模板、Dispatcher、UI 引用等所有需要改动的位置。

doc-i18nSkill

将 FastGPT 文档从中文翻译为面向北美用户的英文。当用户提到翻译文档、i18n、国际化、translate docs、新增/修改了中文文档需要同步英文版时,使用此 skill。也适用于用户要求检查文档翻译缺失、批量翻译、或对比中英文文档差异的场景。

fastgpt-docker-deploySkill

FastGPT Docker Compose self-hosting deployment workflow. Use when a user asks an AI agent to deploy FastGPT with Docker by referencing /deploy/SKILL.md, including creating an empty fastgpt directory, running the install script in non-interactive mode, starting Docker Compose, monitoring service health, troubleshooting compose issues, and returning the access URL plus root credentials and next steps.

i18n-translateSkill

Translate one, multiple, or all explicitly requested FastGPT i18next namespace JSON files from the completed Simplified Chinese source into every supported target locale, with product-language research and structural validation. Use only when the user explicitly invokes `$i18n-translate` and identifies namespace names, files under `packages/web/i18n/zh-CN/`, or all namespaces; never trigger implicitly for ordinary i18n, copywriting, or documentation work.

pr-change-analysisSkill

手动触发的 FastGPT PR 或本地分支变更梳理技能。仅当用户显式调用 $pr-change-analysis 时使用;用于 reviewer 分析一个 GitHub PR 或当前本地分支相对 upstream/main 的需求变更、影响范围、代码质量与代码风格,不用于自动审查触发。

pr-reviewSkill

仅当用户明确手动指定使用 pr-review skill 时触发;不要因为用户传入 PR 链接、要求 review 或要求代码审查而自动触发。