Agent Skills
› Impertio-Studio/Frappe_Claude_Skill_Package
Impertio-Studio/Frappe_Claude_Skill_Package
GitHub将模糊的ERPNext/Frappe开发需求转化为具体技术规格，确定实现机制并映射至技能目录。
Install All Skills
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --all -g -y
Skills in Collection (61)
Showing top 50 of 61 by quality score. Use the install list command or open individual skills for the rest.
将模糊的ERPNext/Frappe开发需求转化为具体技术规格，确定实现机制并映射至技能目录。
收到模糊或不完整的需求
缺乏技术细节的业务请求
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-interpreter -g -y
用于在部署前验证 Frappe/ERPNext 代码，检查最佳实践、常见陷阱及版本兼容性。涵盖服务器脚本、客户端脚本、控制器等类型，通过系统化流程生成包含错误、警告和建议的修正报告，确保代码质量与安全性。
生成的代码需要审查
代码运行出现错误
部署前的最终验证
代码最佳实践评审
运维或部署配置校验
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-validator -g -y
提供Frappe/ERPNext系统API集成规范，涵盖REST/RPC端点设计、文档CRUD操作、Webhook配置及Token/OAuth2认证模式，指导外部系统集成与客户端调用。
构建ERPNext或Frappe API集成
实现REST或RPC接口调用
配置身份验证如Token或OAuth2
处理Webhook通知
解决API连接或鉴权错误
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-api -g -y
提供Frappe/ERPNext数据库操作指南，涵盖ORM、SQL及性能优化，辅助开发者正确进行增删改查。
执行数据库查询或读写
使用Frappe ORM方法
构建复杂SQL查询
优化数据库性能
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-database -g -y
提供Frappe/ERPNext五层权限系统的实现模式，涵盖角色、用户权限、字段级别及数据掩码。防止访问控制错误，指导安全地检查和管理文档读写权限。
实现Frappe权限控制逻辑
解决用户无法查看或编辑特定记录的问题
配置角色与字段级访问限制
处理数据掩码需求
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-permissions -g -y
提供Frappe v14-v16工具函数参考，涵盖日期时间、数字货币格式化、字符串处理及路径操作，防止重复造轮子并确保时区和本地化兼容。
需要处理日期或时间计算
需要格式化货币或数字
需要验证邮箱或URL
需要获取文件或站点路径
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-utils -g -y
提供Frappe Bench CLI完整参考，涵盖环境初始化、站点管理、多租户配置及域名路由。防止环境配置错误和DNS不匹配，辅助开发运维人员高效执行bench命令。
运行bench命令
管理Frappe站点
配置多租户环境
设置域名路由
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-bench -g -y
提供Frappe Cloud托管平台及Press自托管方案的完整参考，涵盖概念、决策树、核心功能及仪表盘操作。旨在指导用户进行站点配置、Bench管理、API调用及云基础设施运维，避免部署错误。
使用Frappe Cloud或Press进行网站托管和部署
管理Frappe站点、Bench环境或服务器资源
查询云主机架构、备份策略或API接口用法
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-cloud -g -y
提供ERPNext/Frappe客户端JavaScript语法参考，涵盖表单事件、字段操作、服务端调用及子表处理。指导开发者在v14-v16版本中编写浏览器端脚本，确保UI交互与数据验证的正确实现。
编写Frappe客户端脚本
处理表单事件逻辑
前端字段值修改或验证
调用服务端方法
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-clientscripts -g -y
提供ERPNext/Frappe框架中Python文档控制器的开发规范，涵盖生命周期钩子、命名规则及版本特性，辅助编写服务端业务逻辑。
编写Frappe DocType控制器
实现validate或on_submit等生命周期钩子
配置autoname命名策略
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-controllers -g -y
提供 Frappe 自定义应用开发的确定性语法参考，涵盖从 v14/v15/v16 版本的应用脚手架创建、目录结构配置、模块注册到补丁和固定装置的规范，防止常见错误。
从零开始构建 Frappe 自定义应用
配置应用结构和 pyproject.toml
处理 Frappe 应用的模块、补丁或数据迁移
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-customapp -g -y
提供Frappe框架hooks.py配置指南，涵盖应用元数据、前端资源、定时任务、会话认证、权限控制及DocType覆盖等。辅助开发者快速定位并实现各类非文档事件钩子，支持v14/v15/v16版本。
配置Frappe hooks.py文件
设置定时调度任务
重写或扩展DocType类
自定义API端点行为
管理前端JS/CSS资源加载
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-hooks -g -y
提供Frappe v14-16中Jinja模板语法的确定性参考，覆盖打印格式、邮件通知及门户页面。详解上下文对象、过滤器及宏用法，明确区分Jinja与JS模板差异，防止文档上下文和子表迭代等常见错误。
编写ERPNext打印格式
创建动态邮件或通知模板
构建Portal Pages
处理Frappe模板上下文变量
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-jinja -g -y
提供Frappe/ERPNext后台任务与定时调用的语法参考，涵盖hooks.py调度配置、异步enqueue用法及Cron表达式。
配置后台定时任务
设置异步执行逻辑
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-scheduler -g -y
提供Frappe框架中Whitelisted方法的开发指南，涵盖装饰器参数、权限校验、HTTP方法限制及客户端调用方式，用于构建安全的Python API端点。
创建Frappe Whitelisted Method
配置@frappe.whitelist装饰器
设置API权限和输入验证
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-whitelisted -g -y
用于设计Frappe/ERPNext多应用架构，决策应用边界、拆分策略及跨应用通信模式，防止单体膨胀和循环依赖。
新项目多模块架构规划
决定扩展ERPNext还是构建自定义应用
现有单体应用拆分
多团队协作同一实例
需要跨应用数据交互
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-architect -g -y
专为Frappe/ERPNext设计的调试助手，通过系统化流程诊断Python、JS及数据库错误。提供错误分类、机制识别、代码定位及修复建议，消除试错调试，提升排查效率。
收到Python或JavaScript报错信息
遭遇静默失败或行为异常
后台任务或调度器执行失败
构建或资产加载出错
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-debugger -g -y
专用于Frappe/ERPNext大版本迁移的助手，通过检测破坏性API变更、扫描自定义代码兼容性并生成迁移计划，预防升级失败。适用于规划升级、解决后迁移错误及检查应用兼容性的场景。
规划Frappe或ERPNext版本升级
执行bench update后出现错误需诊断
检查自定义应用对新版本的兼容性
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-migrator -g -y
提供Frappe框架中Redis缓存、分布式锁及文档缓存的使用指南。涵盖核心API参考、决策树选择模式，以及字符串/Hash操作示例，用于解决数据过期、并发冲突等问题。
实现Redis缓存功能
处理缓存失效逻辑
使用分布式锁防止竞态条件
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-cache -g -y
提供Frappe框架文件管理的核心操作指南，涵盖文件上传、读取、存储及S3配置。解决文件URL失效、私有权限泄露及MIME处理错误等问题，确保附件功能稳定可靠。
处理文件上传或附件逻辑
配置私有/公共文件访问权限
排查文件下载或链接失效问题
集成S3存储方案
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-files -g -y
指导在Frappe框架中正确实施日志记录、错误追踪和监控。涵盖frappe.logger()文件日志、log_error()数据库记录及Sentry集成，提供决策树与最佳实践，防止常见错误。
需要实现应用日志或调试信息记录
需要捕获并持久化错误到Error Log DocType
配置Sentry或其他外部错误追踪服务
排查生产环境日志缺失或打印语句问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-logging -g -y
提供Frappe通知系统实现指南，涵盖邮件、实时警报、分配规则及待办事项。防止配置错误与发送失败，支持代码与无代码方案。
需要发送系统邮件或警报
配置文档事件触发的自动通知
设置任务分配或重复生成规则
调试通知模板或发送故障
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-notifications -g -y
针对Frappe v14-v16搜索功能的开发指南，涵盖链接字段、全局搜索、全文检索及SQLite FTS5等子系统配置与自定义查询实现。
实现Frappe应用中的搜索功能
解决搜索字段缺失或权限过滤问题
自定义链接字段自动完成逻辑
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-search -g -y
提供Frappe v14-v16应用的多语言翻译与i18n实施指南，涵盖Python/JS函数用法、文件提取规则及版本差异。
实现应用多语言支持
处理字符串翻译问题
配置RTL布局
提取未翻译文本
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-translation -g -y
用于在Frappe框架中创建、修改和调试工作流，包括状态定义、转换规则、权限配置及条件表达式。解决文档卡住、状态无法流转等常见问题，确保审批流程正确运行。
创建或修改Frappe工作流
定义工作流状态和转换
添加动作条件或权限
排查工作流权限错误
解决文档状态卡住问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-workflow -g -y
针对Frappe/ERPNext API调试，提供HTTP状态码映射及修复方案。涵盖401认证、403权限、404路由、429限流等错误处理，防止静默失败与错误状态码。
API接口报错排查
HTTP状态码异常分析
Token格式或权限配置错误
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-api -g -y
用于诊断和修复Frappe客户端脚本中的常见错误，如TypeError、frappe.call失败及异步问题。提供错误排查流程图、原因与修复对照表，帮助开发者解决字段访问、权限及生命周期相关bug。
调试Frappe客户端脚本错误
解决TypeError或frappe.call失败
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-clientscripts -g -y
用于诊断和修复 Frappe Document Controller 中的各类错误，涵盖命名、验证、保存、提交及权限阶段。提供生命周期错误排查树与常见错误修复方案，防止自动命名失败、递归死循环等问题。
调试 Frappe 控制器报错
解决 autoname 或 validate 错误
排查 on_submit 或 get_list 问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-controllers -g -y
针对Frappe/ERPNext数据库错误的诊断与修复指南，涵盖异常映射、层级结构及SQL参数规范。
处理Frappe数据库报错
查询DuplicateEntryError等异常修复方案
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-database -g -y
用于诊断和解决 Frappe/ERPNext 中 hooks.py 的各类错误，包括钩子未触发、导入错误、调度器问题及版本冲突等。
Frappe 钩子未触发
hooks.py 导入或执行报错
scheduler_events 不运行
doc_events 处理异常
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-hooks -g -y
用于调试和处理Frappe/ERPNext中的权限错误，涵盖403、钩子失败及用户权限限制等问题，提供快速诊断和决策树。
调试PermissionError或403响应
排查has_permission钩子失败
解决User Permission或perm_level导致的访问受限
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-permissions -g -y
用于诊断和修复Frappe Server Scripts中的常见错误，涵盖ImportError、NameError、沙箱限制及权限问题。提供v15配置要点、错误排查流程图及错误-原因-修复对照表，帮助开发者快速定位并解决脚本执行异常。
调试Frappe服务器脚本错误
排查ImportError或NameError
处理沙箱限制导致的语法错误
解决权限拒绝或数据未保存问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-serverscripts -g -y
提供Frappe/ERPNext客户端表单功能的实现工作流，涵盖字段可见性、级联过滤、计算字段、自定义按钮及验证等。指导从UI创建到JS逻辑编写的步骤，强调UX与服务器端校验的结合。
实现Frappe表单动态UI逻辑
配置字段显示隐藏或联动过滤
添加自定义按钮或计算字段
调试客户端脚本行为
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-clientscripts -g -y
提供Frappe应用中文档控制器实现的完整工作流，涵盖创建、生命周期钩子选择（validate/on_update等）、验证逻辑及与Server Script的决策对比。
实现Frappe文档控制器
选择正确的生命周期钩子
区分Controller与Server Script
处理数据验证和自动命名
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-controllers -g -y
指导从零创建Frappe自定义应用，涵盖项目结构、pyproject配置、模块与DocType定义、hooks设置及部署打包。用于处理复杂业务逻辑和外部集成场景。
需要从零构建Frappe应用
涉及复杂业务逻辑或新DocType开发
需要集成外部系统或Python库
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-customapp -g -y
提供Frappe框架hooks.py配置的标准化实现工作流，涵盖文档事件、定时任务、权限控制及前端注入等场景，指导开发者正确扩展行为并避免冲突。
配置Frapp hooks.py
实现doc_events回调
设置scheduler_events
扩展或覆盖DocType类
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-hooks -g -y
提供Frappe平台集成工作流，涵盖OAuth2、Webhook、支付网关及数据导入导出。指导配置外部服务交互与API调用，防止认证失败和数据损坏。
实现OAuth提供商或客户端
配置Webhook接收或发送
集成第三方支付网关
执行批量数据导入或导出
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-integrations -g -y
提供Frappe框架中Jinja模板（打印格式、邮件、通知、门户页）的创建、编写与调试工作流，涵盖样式、多语言及性能优化。
需要创建或修改Frappe打印格式
构建动态邮件或通知模板
开发门户页面模板
处理Jinja模板中的子表数据
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-jinja -g -y
用于在ERPNext中构建脚本报告、查询报告、仪表板图表和数字卡片。提供文件结构、Python执行函数及SQL查询的最佳实践，防止数据为空或性能问题，涵盖Report Builder等类型选择。
创建ERPNext自定义报告
编写Script Report的Python逻辑
配置Query Report SQL语句
构建Dashboard Chart或Number Card
优化大数据量报表性能
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-reports -g -y
提供 Frappe v14-v16 中定时任务与后台作业的实现指南。涵盖 scheduler_events 与 frappe.enqueue 的决策逻辑、队列选择、参数传递、去重及监控，辅助开发者高效构建异步处理流程。
实现 Frappe 定时任务
配置后台异步作业
处理长耗时数据处理
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-scheduler -g -y
提供Frappe Server Script实现工作流，涵盖文档事件、API端点、定时任务及权限查询。指导选择脚本类型、处理沙箱限制（如禁用import）、编写验证与自动计算逻辑，并建议复杂场景迁移至Controller。
需要实现服务器端文档验证或自动填充
创建REST API端点或定时任务
配置基于角色或用户的权限查询
解决Server Script中的沙箱导入限制问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-serverscripts -g -y
提供Frappe框架客户端UI组件与实时通信的实现工作流，涵盖Dialog、List View、Kanban等界面构建及Socket.IO实时更新，防止UI阻塞与逻辑错误。
需要创建自定义对话框或弹窗
需要定制列表视图或看板视图
实现页面控制器或日历视图
添加实时数据更新功能
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-ui-components -g -y
指导在Frappe框架中构建门户网站、Web表单及网站路由。涵盖页面类型决策、Portal Page创建流程、Web Form配置及SEO优化，旨在解决404错误和表单提交问题。
构建门户页面或公共表单
配置网站路由与SEO元标签
排查Frappe网站404或表单提交失败
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-website -g -y
提供 Frappe 框架中 @frappe.whitelist() API 端点构建的完整工作流，涵盖权限设计、位置选择、认证模型及前后端集成，确保接口安全与规范。
创建 Frappe 自定义 API 端点
实现 frappe.whitelist 装饰器方法
前端调用后端 Python 逻辑
配置 API 权限与访问控制
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-whitelisted -g -y
提供Frappe框架中文档工作流实现的详细指南，涵盖状态设计、审批链配置及状态转换规则，防止流程卡死或权限错误。
实现Frappe文档工作流
配置审批链和状态转换
解决工作流卡死问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-workflow -g -y
指导在Frappe v14-v16中创建和定制Workspace页面，涵盖DocType结构、组件配置、JSON格式及角色权限，防止数据不同步。
创建或自定义Frappe工作区页面
配置仪表盘图表、快捷方式或数字卡片
处理工作区模块关联与角色访问控制
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-workspace -g -y
管理Frappe应用全生命周期，涵盖脚手架创建、目录结构配置、构建编译、测试运行及发布部署。提供bench命令速查与核心文件说明，防止因错误配置导致的应用结构损坏或构建失败。
初始化新的Frappe应用项目
配置应用设置与目录结构
执行资产构建与测试
部署或发布应用到市场
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-app-lifecycle -g -y
提供Frappe系统的备份与灾难恢复操作指南，涵盖bench命令使用、全量/增量备份、S3远程存储配置及自动化定时任务设置，确保数据安全。
需要执行数据库或文件备份
从备份恢复站点数据
配置S3或远程存储备份
设置自动化定时备份任务
规划灾难恢复流程
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-backup -g -y
用于 Frappe/ERPNext 生产环境部署，涵盖传统模式与 Docker 配置，包括 Nginx、Supervisor、SSL 及安全加固。
部署 Frappe/ERPNext 到生产环境
配置 Nginx 反向代理或 Supervisor 进程管理
设置 Docker 容器化部署
启用 SSL 证书或进行服务器安全加固
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-deployment -g -y
提供Frappe前端构建系统参考，涵盖v14 build.json与v15+ esbuild配置、迁移指南及故障排查。支持多应用构建、生产优化和SCSS编译，防止构建失败。
配置前端资源打包
从v14迁移到v15构建系统
排查SCSS/CSS编译错误
解决资产管道配置问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-frontend-build -g -y
