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开发需求转化为具体技术规格，确定实现机制并映射到技能目录。适用于需求不明确或缺乏细节的场景，作为开发与业务意图间的桥梁。
收到模糊或不清的ERPNext/Frappe开发请求
需求缺乏具体技术细节如触发器或机制
存在多种可能的实现路径需澄清
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-interpreter -g -y
用于审查和验证Frappe/ERPNext代码，确保符合最佳实践并捕获部署前错误。支持检查生成的代码、排查故障及验证运维模式，覆盖v16特性及61项技能规范。
代码生成后需要审查
代码运行出错需排查
部署前的生产就绪验证
代码质量与最佳实践检查
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-validator -g -y
提供Frappe/ERPNext API集成模式，涵盖REST/RPC/Webhook及多种认证方式（Token/OAuth2/Session），支持v14/v15+版本，指导外部系统对接与数据交互。
构建ERPNext或Frappe API集成
实现REST或RPC端点调用
配置Webhook通知
处理API身份验证（如Token、OAuth2）
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-api -g -y
提供Frappe/ERPNext数据库操作指南，涵盖ORM、缓存及SQL用法。通过决策树和示例指导开发者规范数据读写，优化性能并避免常见错误。
执行数据库查询或写入
使用Frappe ORM获取或创建文档
处理数据库事务与权限过滤
优化数据库查询性能
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-database -g -y
提供Frappe/ERPNext五层权限系统的确定性实现模式，涵盖角色、用户权限、数据掩码及Hook，防止访问控制错误。
需要配置或检查Frappe文档类型权限
实现自定义行级数据访问控制逻辑
排查用户无法查看特定记录的问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-permissions -g -y
提供Frappe框架v14-v16工具函数速查，涵盖日期时间、数值转换、字符串处理及路径操作，辅助开发者正确调用内置方法。
使用frappe.utils工具函数
日期时间计算与格式化
安全类型转换
文件路径获取
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站点或Bench
使用Press API进行资源调配
选择托管策略（Cloud vs 自托管）
处理云环境中的部署和配置问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-cloud -g -y
提供Frappe/ERPNext客户端JavaScript语法参考，涵盖表单事件、字段操作、服务端调用及子表处理。用于编写前端交互逻辑和UI验证，确保在v14-v16版本中正确实现浏览器端功能。
编写Frappe客户端脚本
处理表单事件如validate或refresh
操作表单字段显示或属性
在前端调用服务器方法
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-clientscripts -g -y
提供ERPNext/Frappe DocType Python文档控制器的开发指南，涵盖生命周期钩子、命名规则及执行顺序。
编写Frappe DocType控制器
处理DocType生命周期事件
实现自定义验证或提交逻辑
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-controllers -g -y
提供 Frappe 自定义应用从零构建的语法参考，涵盖项目脚手架、pyproject.toml配置、模块组织、补丁及数据迁移。防止常见错误，指导新建或扩展ERPNext应用的结构与流程。
从零创建Frappe自定义应用
配置Frappe应用结构
处理Frappe模块和补丁
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-customapp -g -y
用于配置 Frappe/ERPNext 的 hooks.py，涵盖应用元数据、前端资源、调度任务、权限控制、方法重写及安装迁移等钩子，辅助开发者扩展系统行为。
配置 Frappe hooks.py
添加前端 JS/CSS 资源
设置定时调度任务
重写 DocType 控制器或 API 方法
自定义权限查询逻辑
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-hooks -g -y
提供Frappe/ERPNext中Jinja模板语法的确定性参考，涵盖打印格式、邮件通知及门户页面的上下文对象与语法细节，防止常见错误。
编写ERPNext打印格式模板
创建动态邮件或通知模板
开发Portal Pages前端页面
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-jinja -g -y
提供Frappe/ERPNext调度器事件与后台任务的确定性语法参考，涵盖hooks.py配置、异步任务提交、队列管理及Cron表达式用法。
配置定时任务或后台作业
设置Cron调度规则
处理异步任务执行
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-syntax-scheduler -g -y
提供Frappe框架中白名单方法的开发规范，涵盖装饰器参数、权限校验及客户端调用方式，用于构建安全的Python API接口。
创建Frappe白名单API方法
配置@frappe.whitelist装饰器
实现服务端与客户端通信
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 大版本升级
解决版本升级后的报错问题
检查自定义应用在新版本的兼容性
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-agent-migrator -g -y
提供Frappe框架中Redis缓存与分布式锁的使用指南，涵盖缓存读写、失效模式及加锁策略，旨在解决数据陈旧、并发冲突等问题。
实现Redis缓存功能
处理缓存失效逻辑
使用分布式锁防止竞态条件
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-cache -g -y
Frappe文件管理指南，涵盖上传、保存、读取及删除操作。提供API方法速查、决策树及权限模型说明，确保正确处理公开/私有文件访问与S3配置，防止链接失效或权限泄露。
处理文件上传或附件问题
配置S3存储或文件URL
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-files -g -y
指导在Frappe框架中实现日志记录、错误追踪和监控的最佳实践，涵盖frappe.logger()文件日志、log_error()数据库错误日志及Sentry集成，防止常见错误。
实现应用日志记录
追踪并记录错误到Error Log
集成Sentry进行外部错误监控
排查生产环境日志问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-logging -g -y
提供Frappe通知系统实现指南，涵盖邮件、实时提醒、短信及待办事项。支持通过Notification DocType配置无代码触发规则，或调用API编程发送。解决通知配置错误、模板失效及静默失败问题。
实现邮件通知或系统警报
配置Assignment Rules或Auto Repeat
创建或管理ToDo任务
调试通知不发送或模板错误
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-notifications -g -y
提供Frappe v14-v16搜索功能实现指南，涵盖链接字段、全局、全文及SQLite搜索子系统。包含配置search_fields、自定义查询Hook及决策树，防止常见搜索错误。
需要实现或优化Frappe应用的搜索功能
配置链接字段自动补全或全局搜索
解决搜索结果缺失或权限过滤问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-core-search -g -y
提供Frappe v14-16应用的多语言(i18n)实现指南，涵盖Python/JS翻译函数、CSV/PO文件处理、字符串提取及RTL支持，防止常见错误。
需要为Frappe应用添加多语言支持
查询翻译函数用法如_()或__()
处理本地化文件或提取未翻译字符串
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错误的调试指南，涵盖401至503状态码的成因与修复方案，重点解决认证格式混淆、权限缺失及CORS等问题。
API返回401/403/404/500等错误
排查REST接口认证或权限问题
处理CORS或CSRF相关异常
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-api -g -y
提供Frappe客户端脚本常见错误的诊断流程与修复方案，涵盖TypeError、frappe.call失败、异步处理及权限等问题。
调试Frappe客户端脚本错误
解决TypeError或frappe.call异常
排查前端表单交互问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-clientscripts -g -y
针对Frappe文档控制器在命名、验证、保存等生命周期阶段的错误诊断与修复指南，涵盖autoname、validate循环、权限及递归等问题。
调试Frappe控制器错误
解决autoname失败或验证循环
排查on_submit或权限问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-controllers -g -y
针对Frappe/ERPNext数据库异常的诊断与修复指南。涵盖常见错误映射、异常层级及SQL参数规范，用于快速解决数据一致性与连接问题。
处理Frappe数据库报错
排查DuplicateEntryError或TimestampMismatchError
修复frappe.db.sql参数格式错误
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-database -g -y
针对Frappe/ERPNext中hooks.py配置错误的诊断与修复指南。涵盖钩子未触发、循环导入、调度器异常、DocType事件及类覆盖冲突等问题，提供版本适配的错误排查清单与解决方案。
调试 hooks.py 错误
钩子未触发或失效
解决循环导入问题
scheduler_events 不运行
doc_events 处理失败
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-hooks -g -y
用于调试和解决Frappe/ERPNext系统中的权限错误，涵盖PermissionError、钩子失败及用户权限配置问题。
遇到403或PermissionError
文档访问被拒绝
列表视图无数据
Guest访问受限
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-permissions -g -y
针对Frappe Server Scripts的调试技能，涵盖沙箱限制、权限、调度及API脚本错误诊断与修复。
排查Frappe服务端脚本运行时错误
解决ImportError或NameError等沙箱违规问题
配置服务器脚本启用及权限设置
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-errors-serverscripts -g -y
提供Frappe/ERPNext客户端脚本实现工作流，涵盖字段可见性、级联过滤、计算字段及自定义按钮等UI逻辑开发。指导从创建到测试的完整步骤，强调UX与服务器验证结合的最佳实践。
需要实现表单字段的显示或隐藏逻辑
配置基于选择值的级联下拉过滤
添加自定义按钮或动态计算字段
调试客户端脚本事件触发问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-clientscripts -g -y
提供Frappe框架中Document Controller的开发工作流，涵盖文件创建、生命周期钩子选择（validate/on_update等）、验证逻辑及与Server Script的决策对比，辅助构建服务端业务逻辑。
实现自定义DocType控制器
选择正确的生命周期钩子
判断使用Controller还是Server Script
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-controllers -g -y
指导从零构建Frappe自定义应用，涵盖项目初始化、模块与DocType定义、依赖配置及部署打包。用于处理复杂业务逻辑或需引入外部库的场景。
需要创建新的Frappe应用
添加新DocType或复杂Python代码
需要导入外部包
配置pyproject.toml和hooks
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 Provider/Consumer、处理外部API调用及批量数据同步，确保集成安全与稳定。
实现OAuth认证流程
配置Webhook或Connected App
集成第三方支付网关
执行大规模数据导入导出
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-integrations -g -y
提供Frappe框架中Jinja模板（打印格式、邮件、通知、门户页）的创建与调试工作流，涵盖样式、多语言及防N+1查询优化。
构建Frappe打印格式或PDF模板
编写邮件或通知Jinja模板
开发Portal页面模板
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-jinja -g -y
指导在ERPNext中构建脚本报告、查询报告及仪表盘图表，涵盖文件结构、SQL优化及过滤器处理，防止数据为空或性能问题。
需要创建ERPNext自定义报告
构建Dashboard图表或Number Card
解决报告数据为空或SQL性能问题
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-reports -g -y
指导在Frappe框架中实现定时任务与后台作业，涵盖scheduler_events与enqueue的选择、队列配置、去重及监控。
需要实现定时执行的任务
需要处理异步或长时间运行的后台作业
配置Frappe调度器事件
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-scheduler -g -y
提供Frappe Server Script实施工作流，涵盖文档验证、自动填充、API端点及定时任务。强调沙箱限制与代码规范，指导选择脚本类型并迁移至Controller，实现服务端无代码自动化。
实现服务器端功能
配置文档事件
创建API端点
设置定时任务
处理沙箱导入限制
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-serverscripts -g -y
提供Frappe框架客户端UI组件（如Dialog、List View、Kanban、Calendar）及实时通信的实现工作流，指导开发者构建交互界面并处理异步与Socket事件。
构建自定义对话框或弹窗
定制列表视图或看板/日历视图
实现页面控制器逻辑
添加实时数据更新功能
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-ui-components -g -y
提供Frappe框架下网站、门户页面、Web表单及SEO配置的构建工作流。涵盖静态页、动态路由、外部数据提交及主题设置，防止404和SEO缺失问题。
构建门户网站或公共页面
配置Web Form表单
优化网站SEO和元标签
处理网站路由和URL解析
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-website -g -y
提供 Frappe 框架中 @frappe.whitelist() API 端点的构建工作流，涵盖权限设计、代码实现、前端调用及安全加固。
需要创建 Frappe REST API 端点
询问如何在前端调用 Python 方法
处理 API 权限验证与安全配置
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-whitelisted -g -y
提供Frappe文档工作流、审批链及状态转换的实现指南，涵盖设计、配置、测试及常见模式，防止流程卡死或权限错误。
实现文档工作流
配置审批链
处理状态转换
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-impl-workflow -g -y
提供Frappe v14-v16中Workspace页面的创建与定制工作流，涵盖结构、组件配置、JSON同步及权限控制，防止常见错误。
创建或自定义Frappe Workspace页面
配置Dashboard图表、快捷方式或数字卡片
处理Workspace DocType结构与Child Tables同步
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存储配置及自动化调度。
配置数据库或文件备份
执行站点数据恢复
设置自动定时备份任务
规划灾难恢复流程
npx skills add Impertio-Studio/Frappe_Claude_Skill_Package --skill frappe-ops-backup -g -y
用于 Frappe/ERPNext 生产环境部署，涵盖传统 Bench 或 Docker 方式。提供 Nginx、Supervisor、SSL 及安全加固配置指南，防止不安全部署和反向代理错误。
Frappe/ERPNext 生产部署
Nginx 反向代理配置
Docker Compose 部署
Let's Encrypt SSL 设置
Supervisor 进程管理
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
