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代码，在部署前检查最佳实践、常见陷阱及版本兼容性。覆盖Server/Client Script等类型，生成包含错误、警告和建议的修正报告。
代码生成后需要审查
代码出现错误需排查
部署前的生产就绪验证
代码最佳实践评审
运维部署配置验证
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-validator -g -y
提供ERPNext/Frappe系统API集成规范，涵盖REST/RPC接口、Webhook及多种认证方式（Token/OAuth2/Session），支持v14/v15+版本开发。
构建ERPNext API集成
设计REST或RPC端点
配置外部系统Webhook
实现Token或OAuth2认证
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-api -g -y
提供ERPNext/Frappe数据库操作指南，涵盖ORM、SQL及缓存模式，帮助开发者高效执行数据读写并避免常见错误。
执行Frappe数据库查询或写入
使用frappe.db或ORM方法处理文档
优化数据库性能或解决查询问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-database -g -y
提供Frappe/ERPNext权限系统的五层实现模式，涵盖角色、用户权限、字段级控制及数据脱敏。通过决策树和API参考指导安全访问控制开发，防止越权漏洞。
实现自定义权限逻辑
排查数据可见性问题
配置字段或记录级访问限制
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-permissions -g -y
提供Frappe框架v14-v16工具函数速查，涵盖日期时间处理、数值转换、字符串操作、数据验证及文件路径管理。旨在规范开发实践，避免重复造轮子导致时区或本地化问题。
需要处理日期、时间或计算日期间隔
进行安全的类型转换如flt、cint
格式化货币金额或相对时间
验证邮箱、URL或JSON格式
获取文件或站点物理路径
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-utils -g -y
提供Frappe Bench CLI完整参考，涵盖站点管理、应用生命周期、多租户配置及域名设置。防止环境误配和DNS不匹配，指导bench init、site创建等关键操作。
运行 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 API进行资源调配
配置Frappe Cloud的Bench和环境变量
选择托管方案（Cloud vs Self-hosted）
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-cloud -g -y
提供Frappe/ERPNext客户端JavaScript语法参考，涵盖表单事件、字段操作和服务端调用。用于编写浏览器端UI交互逻辑和验证规则。
编写Frappe客户端脚本
处理表单字段事件
实现前端数据验证
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-clientscripts -g -y
提供Frappe/ERPNext文档控制器开发的语法参考，涵盖生命周期钩子、命名规则及执行顺序。
编写Frappe DocType控制器
查询生命周期钩子用法
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-controllers -g -y
提供 Frappe 自定义应用从创建到配置的确定性语法参考，涵盖项目脚手架、模块组织、补丁及修复程序，防止常见错误。
从零开始构建 Frappe 自定义应用
配置 pyproject.toml 或 setup.py
初始化应用模块结构
设置数据迁移补丁
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-customapp -g -y
提供Frappe框架hooks.py配置参考，涵盖前端资源、定时任务、权限控制、DocType扩展及API重写等场景，辅助开发者正确注册和自定义应用行为。
配置Frappe hooks.py文件
实现定时调度任务
扩展或覆盖DocType类逻辑
自定义前端JS/CSS资源加载
修改API白名单方法
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-hooks -g -y
提供Frappe ERPNext v14-v16中Jinja模板语法的确定性参考，涵盖打印格式、邮件及通知模板、门户页面。指导上下文变量使用、过滤器、宏定义，并明确区分Jinja与JS模板语法，防止常见错误。
编写ERPNext打印格式
创建动态邮件或通知模板
开发Portal Pages
解决Jinja与JS模板混淆问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-jinja -g -y
提供Frappe/ERPNext后台任务与调度器的语法参考，涵盖hooks.py配置、RQ异步队列、Cron表达式及迁移注意事项。
配置定时任务或后台作业
处理异步任务队列
设置Cron调度
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-scheduler -g -y
提供 Frappe v14-v16 中 @frappe.whitelist 装饰器的使用指南，涵盖 API 端点创建、权限校验、输入验证及客户端调用方式。
创建 Frappe 白名单方法
配置 API 端点权限
处理 frappe.call 通信
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-whitelisted -g -y
用于设计Frappe/ERPNext多应用架构，分析业务需求以决定应用边界、拆分策略及跨应用通信模式。预防单体膨胀和循环依赖，生成实施路线图，确保模块化设计。
新项目多模块规划
决定扩展还是自定义
现有单体应用拆分
跨应用通信设计
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-architect -g -y
专为Frappe/ERPNext设计的系统化调试助手，通过分类错误类型、定位代码机制并应用诊断清单，消除试错调试。
Python或JavaScript报错
静默失败或行为异常
调度器或后台任务失败
构建或资源加载错误
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-debugger -g -y
用于 Frappe/ERPNext 大版本迁移的助手，检测破坏性 API 变更、扫描自定义代码兼容性并生成迁移计划，防止因废弃方法或签名变化导致的升级失败。
规划 Frappe/ERPNext 大版本升级
升级后出现错误需诊断
检查自定义应用在新版本的兼容性
迁移过程中遇到故障
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-migrator -g -y
提供Frappe框架中Redis缓存与分布式锁的使用指南，涵盖设置、获取、删除、Hash操作及文档缓存模式，防止数据陈旧和竞态条件。
实现Redis缓存逻辑
处理缓存失效策略
解决分布式锁需求
优化重复查询性能
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-cache -g -y
提供Frappe框架文件管理的核心参考，涵盖上传、存储、访问控制及S3集成。防止URL断裂、权限泄露和MIME错误，指导File DocType使用及公私文件处理。
处理文件上传或附件操作
配置S3存储或解决文件链接失效
管理私有/公共文件权限
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-files -g -y
提供Frappe框架日志、错误追踪与监控的最佳实践，涵盖frappe.logger()文件日志、log_error()数据库记录及Sentry集成，指导开发调试与生产环境规范。
实现Frappe应用的日志记录功能
排查和追踪运行时错误
配置生产环境监控与Sentry集成
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-logging -g -y
提供Frappe通知系统实现指南，涵盖邮件、实时提醒、短信及待办事项配置。包含Notification DocType用法、触发条件语法及代码API参考，防止通知配置错误与发送失败。
实现邮件或系统通知功能
配置自动化规则如分配或自动重复
调试通知模板或发送失败问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-notifications -g -y
提供Frappe框架搜索功能的实现指南，涵盖链接字段、全局搜索、全文检索及Awesomebar定制，包含决策树与代码示例。
实现或修复Frappe应用中的搜索功能
配置search_fields或自定义搜索查询
解决链接字段为空或搜索无结果的问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-search -g -y
提供Frappe v14-v16应用的多语言(i18n)实现指南，涵盖Python/JS翻译函数、文件结构、提取命令及版本差异，防止字符串拼接错误。
需要为Frappe应用添加多语言支持
处理翻译文件(CSV/PO/MO)或提取未翻译字符串
解决前端或后端文本未正确显示的问题
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调试的Skill，提供HTTP状态码与异常的映射及修复方案。覆盖401/403/404/500等常见错误，解决认证格式、权限、CSRF/CORS、限流等问题，防止静默失败。
API调试
处理REST端点错误
排查HTTP状态码异常
认证令牌问题
CORS或CSRF错误
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-api -g -y
用于诊断和修复Frappe客户端脚本中的常见错误，如TypeError、frappe.call失败及异步问题。提供错误排查流程图和具体解决方案，覆盖v14至v16版本，帮助开发者快速定位并解决前端脚本运行异常。
调试Frappe客户端脚本错误
处理TypeError或frm未定义问题
排查frappe.call调用失败原因
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-clientscripts -g -y
针对Frappe文档控制器错误的诊断与修复指南，覆盖命名、验证、保存等生命周期阶段。解决自增名失败、无限递归、权限错误及事务中断等问题，提供具体成因分析与修正方案。
调试Frappe控制器报错
预防文档提交或保存时的逻辑错误
排查autoname或validate循环问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-controllers -g -y
用于诊断和解决Frappe/ERPNext应用中的数据库错误。提供常见异常（如重复条目、死锁、连接超时）的成因分析与修复方案，涵盖SQL注入防护及参数格式化规范。
处理数据库相关报错
排查DuplicateEntryError等异常
解决MariaDB连接问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-database -g -y
用于诊断和修复Frappe/ERPNext中hooks.py相关的错误，如钩子未触发、循环导入、调度器异常及版本冲突等。
调试hooks.py错误
钩子未触发排查
解决循环导入问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-hooks -g -y
针对Frappe/ERPNext权限错误的调试指南，提供从错误信息到修复方案的快速诊断表、决策树及API端点配置建议，解决has_permission钩子、User Permission限制及Guest访问等问题。
调试PermissionError (403) 错误
排查文档或列表视图无访问权限
修复has_permission钩子逻辑
处理Guest访问被拒问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-permissions -g -y
用于诊断和修复Frappe Server Scripts中的常见错误，包括ImportError、NameError、沙箱限制、权限问题及脚本类型配置错误。提供错误映射表和解决流程。
调试Frappe服务端脚本错误
解决沙箱或导入限制问题
排查脚本未执行或无响应
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-serverscripts -g -y
提供Frappe/ERPNext客户端脚本实现工作流，涵盖字段可见性、级联过滤、计算字段、自定义按钮及表单验证等UI逻辑开发步骤。
实现动态UI交互
编写前端表单验证逻辑
配置级联过滤器
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-clientscripts -g -y
提供Frappe应用中文档控制器（Document Controllers）的Python实现工作流，涵盖生命周期钩子选择、验证逻辑、自动命名及与Server Script的决策对比。
需要为自定义DocType编写Python控制器逻辑
询问如何选择合适的文档生命周期钩子如validate或on_update
需要将逻辑从hooks.py迁移到Controller类
需要扩展标准ERPNext DocType
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-controllers -g -y
指导从零构建自定义Frappe应用的完整工作流，涵盖应用初始化、模块与DocType定义、依赖配置及部署打包。
从零开始创建新的Frappe应用
需要复杂的业务逻辑或新DocType
集成外部系统需导入Python包
配置Frappe应用的hooks和pyproject.toml
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-customapp -g -y
提供Frappe框架中hooks.py配置的标准化实现工作流，涵盖文档事件、调度任务、类重写及权限控制等场景，指导开发者正确集成自定义逻辑。
需要配置Frappe应用的hooks.py
实现文档生命周期事件处理
设置定时调度任务
重写或扩展DocType行为
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-hooks -g -y
提供Frappe框架中OAuth、Webhook、支付网关及数据导入导出的集成实现指南，防止认证失败和数据损坏。
配置OAuth提供者或客户端
设置Webhook回调
集成第三方支付网关
执行批量数据导入导出
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-integrations -g -y
提供Frappe框架中Jinja模板（打印格式、邮件、通知、门户页）的创建、编写与调试工作流，涵盖样式、多语言及性能优化。
需要创建或修改Frappe打印格式
构建邮件或通知模板
开发Portal页面
处理Jinja模板中的子表或条件逻辑
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-jinja -g -y
用于在ERPNext中构建脚本报告、查询报告、仪表板图表和数字卡片，涵盖SQL优化、过滤器配置及权限设置，防止数据输出错误。
构建ERPNext自定义报告
调试查询报告或脚本报告
配置仪表板图表或数字卡片
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-reports -g -y
指导在Frappe框架中实现定时任务和后台作业，涵盖scheduler_events与enqueue的选择、队列配置、去重及监控。
需要实现定时任务
配置后台异步处理
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-scheduler -g -y
提供Frappe平台Server Script的无代码开发工作流，涵盖文档事件、API端点及定时任务的实现。重点指导在RestrictedPython沙箱限制下编写安全脚本，并给出从脚本迁移至Controller的最佳实践建议。
需要实现服务端逻辑但避免创建自定义应用
在沙箱环境中进行数据验证或自动填充
配置REST API接口或定时任务
解决ImportError等沙箱限制问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-serverscripts -g -y
提供Frappe框架客户端UI组件实现指南，涵盖对话框、列表视图、看板、日历及实时通信等核心功能的开发工作流与最佳实践。
构建自定义对话框或弹窗
扩展或定制列表视图
创建页面控制器或看板/日历视图
实现前端实时更新和Socket通信
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-ui-components -g -y
提供Frappe框架下网站与门户页面的实现工作流，涵盖Web页面、Web表单、路由配置、主题及SEO优化。指导静态页、动态数据录入及自定义门户的开发，防止404和SEO缺失问题。
构建门户网站或公共页面
配置Web表单以接收外部用户提交
设置网站路由、主题或SEO元标签
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-website -g -y
提供Frappe框架中@frappe.whitelist() API端点的全流程实现指南，涵盖权限设计、安全校验、前后端集成及迁移策略，防止越权与注入风险。
构建Frappe REST API
配置接口权限与安全策略
前端JS调用后端Python方法
API迁移与测试
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-whitelisted -g -y
提供Frappe文档工作流实现的详细指南，涵盖状态设计、审批链配置及权限控制。指导如何正确设置Workflow State和Action，避免文档卡死或权限错误，确保多步审批流程的健壮性。
实现Frappe文档工作流
配置审批链
解决状态转换问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-workflow -g -y
用于在Frappe v14-v16中创建和自定义Workspace页面。涵盖DocType结构、组件配置（图表、快捷方式等）、JSON格式及角色权限控制，提供从决策到实现的完整工作流。
创建或自定义Frappe Workspace页面
配置仪表盘组件如数字卡片、图表和快捷方式
设置Workspace的角色访问控制和模块关联
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-workspace -g -y
用于 Frappe 应用全生命周期管理，涵盖新建、配置、构建、测试及发布。提供目录结构说明与常用命令参考，防止因脚手架错误或配置缺失导致的问题。
创建新的 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 Compose或Let's Encrypt SSL证书
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-deployment -g -y
Frappe前端构建系统参考，涵盖v14 build.json与v15+ esbuild配置、迁移及SCSS/CSS编译排错。提供命令速查与入口点规范，防止构建失败。
配置前端资源打包
从v14迁移到v15构建系统
排查SCSS/CSS编译错误
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-frontend-build -g -y
