pi-agent-template

Pi Agent 全栈调试指南。从前端到 RPC 通信到后端的完整调试链路。 当用户遇到"接口调用失败"、"WebSocket 断连"、"功能不工作"、"数据不对"、 "页面白屏"、"组件不渲染"、"报错了"等调试场景时使用此 Skill。 也适用于排查性能问题、内存泄漏、连接超时等问题。

新增 RPC 模块的完整开发流程。当用户需要给 AI Agent 模板添加新功能（如新的工具、服务、面板）时， 使用此 Skill 引导完成类型定义 → Handler 实现 → 注册编排 → 前端调用 → 测试的完整流程。 当用户提到"新增功能"、"添加模块"、"新 RPC 方法"、"新增 handler"、"添加 XXX 功能"时， 都应该使用此 Skill，即使用户没有明确提到 "RPC" 或 "模块"。

Pi Agent 模板的开发和维护规范。涵盖主题系统（CSS 变量）、i18n 国际化、组件开发、 Zustand Store 管理、测试编写等完整规范。 当用户需要修改模板 UI、添加新组件、修改样式、添加新语言、创建新 Store、 或维护现有模板功能时，使用此 Skill。 当用户提到"组件"、"样式"、"主题"、"语言"、"Store"、"模板"时触发。

从零创建一个新的 pi-agent 模板类型（像 general/chat/agent/browser-agent 那样）。 当用户说"新建一个模板"、"加一种模板类型"、"照着 browser-agent 再做一个"、"我想加个 xxx 模板"时使用此 Skill。 本 Skill 覆盖：目录脚手架 → 端口规划 → 双模式配置 → CLI 注册 → 同步脚本 → 测试 → 发布校验的完整链路。 注意：与 pi-template-dev（模板内部写代码的规范）不同，本 Skill 是"造模板本身"。