Agent Skills
› fmaclen/canutin
fmaclen/canutin
GitHub描述 Canutin 项目的整体架构，涵盖 SvelteKit 前端、PocketBase 后端、i18n 配置及核心命令。
Install All Skills
npx skills add fmaclen/canutin --all -g -y
Skills in Collection (19)
描述 Canutin 项目的整体架构，涵盖 SvelteKit 前端、PocketBase 后端、i18n 配置及核心命令。
询问项目技术栈
查询代码目录结构
了解数据流与路由组织
npx skills add fmaclen/canutin --skill architecture -g -y
基于PocketBase的前端认证系统，涵盖用户登录注册、Token管理、路由守卫及会话状态同步，确保受保护页面的安全访问。
需要实现或修改用户登录注册功能
处理前端路由权限控制和鉴逻辑
配置PocketBase认证相关客户端代码
npx skills add fmaclen/canutin --skill auth-system -g -y
规范代码质量，涵盖类型定义、注释编写及代码结构优化。强调消除冗余、提升可读性，指导开发者在修改时同步清理旧规约偏差，确保代码长期可维护性。
需要遵循严格的代码风格指南
重构或审查代码以消除技术债务
添加复杂逻辑时需补充意图注释
npx skills add fmaclen/canutin --skill code-quality -g -y
用于在里程碑完成前审查代码，确保行为正确、状态管理及异常处理符合规范。根据文件路径动态加载对应约定技能（如代码质量、测试、Svelte5等），输出结构化发现项及残留风险，不重写代码。
用户请求进行代码审查
准备发布或标记里程碑完成前的代码验证
npx skills add fmaclen/canutin --skill code-review -g -y
说明基于Docker的部署流程，涵盖多阶段构建、semantic-release版本管理及CI工作流。指导如何发布镜像及主机端更新策略，确保环境变量兼容性与运行时配置规范。
询问项目如何构建和打包Docker镜像
了解自动化发布流程和语义化版本规则
查询生产环境部署与更新机制
npx skills add fmaclen/canutin --skill deployment -g -y
规范 CI 失败时的错误诊断与推送纪律，强调先读日志再修复、单次推送后验证、连续失败上报及避免浪费 CI 资源。
CI 运行失败
本地质量检查报错
需要提交代码前
npx skills add fmaclen/canutin --skill failure-discipline -g -y
定义全栈错误处理规范，区分异常、操作日志与持久化追踪。指导何时抛出异常或返回结构化结果，并规定前端Toast和Go钩子的具体实现细节，确保失败可观测且用户提示友好。
需要处理代码中的异常或错误时
需要记录操作日志或调试信息时
设计用户可见的错误提示界面时
npx skills add fmaclen/canutin --skill failures-and-logs -g -y
指导创建独特、非通用的前端界面，避免AI生成的平庸美学。通过设计思维确定大胆的美学方向，并实现生产级代码，注重排版、色彩、动效和空间构图等细节。
需要构建具有独特视觉风格的前端组件或页面
要求生成非通用、有创意且引人注目的UI设计
npx skills add fmaclen/canutin --skill frontend-design -g -y
用于创建或重写 GitHub Issue，聚焦描述问题及其影响而非解决方案。涵盖标题与正文规范、证据收集及 gh CLI 操作，确保 Issue 清晰且独立。
需要创建新的 GitHub Issue
需要重写现有的 GitHub Issue
npx skills add fmaclen/canutin --skill issue-writing -g -y
管理本地开发服务器（Vite、PocketBase）的启动、停止及端口配置。定义工作区内的所有权规则，处理端口冲突，并支持通过 dev-link 将本地服务发布到 tailnet 供其他设备访问。
需要启动或停止 Vite/PocketBase 等本地服务
需要配置或读取本地开发端口
需要将本地服务发布到远程网络进行调试
npx skills add fmaclen/canutin --skill local-servers -g -y
通过 PocketBase API 管理 Canutin 数据批量导入，支持多种金融数据类型导入、会话列表查看及回滚操作。
导入银行或金融数据
检查导入历史记录
撤销或回滚之前的导入
npx skills add fmaclen/canutin --skill pb-import -g -y
通过 PocketBase 集合 API 以编程方式创建或修改数据模型，自动生成 JS 迁移文件。适用于需动态调整数据库结构、添加字段或变更 API 规则的场景。
用户要求创建新的数据集合
用户要求修改现有集合的字段结构
用户要求更改 PocketBase 的 API 访问规则
npx skills add fmaclen/canutin --skill pb-migrate -g -y
PocketBase后端开发规范，涵盖Schema管理、Go自定义钩子、认证流程及集合API规则。指导开发者在canutin项目中正确使用PocketBase进行数据操作与扩展。
需要查询或修改PocketBase数据库结构
实现基于PocketBase的自定义业务逻辑或API
处理用户认证与权限控制
调试后端服务连接问题
npx skills add fmaclen/canutin --skill pocketbase -g -y
定义 PocketBase 实时订阅与上下文存储同步规范，确立‘失效即重取’模型，区分同步层与投影层职责，确保 UI 状态通过去抖动全量刷新保持最终一致性。
实现新的 Svelte 实时数据商店
重构现有实时订阅逻辑
排查前端数据不同步问题
npx skills add fmaclen/canutin --skill realtime -g -y
管理 Git worktrees 以支持多线程并行开发。提供创建、附着、列出、移除及自动清理功能，通过 .env 和 .worktree.json 配置端口与状态，确保 T3 工具链在多分支场景下的正确隔离与协作。
需要并行处理多个 Git 分支任务
T3 工具初始化或切换工作线程
手动创建或清理本地 Git worktree
npx skills add fmaclen/canutin --skill setup -g -y
定义Svelte 5代码库的前端编写规范，涵盖Runes状态管理、事件处理、内容传递及导航最佳实践。
前端开发
代码审查
npx skills add fmaclen/canutin --skill svelte5 -g -y
定义测试分层策略，优先使用 Playwright 进行 E2E 和 API 测试，仅在必要时补充单元测试。规范文件路径、执行命令及编写原则，强调真实系统验证与避免冗余覆盖。
询问如何编写或组织测试用例
需要运行特定文件或名称的测试
npx skills add fmaclen/canutin --skill testing -g -y
本地验证工作流，包含运行质量检查（Prettier/ESLint/svelte-check）和执行 Playwright E2E 测试。提供手动 QA 的用户数据种子生成及 PocketBase 数据库重置功能，确保提交前代码质量与功能正常。
需要运行本地质量检查或 E2E 测试
需要为手动 QA 准备测试用户数据
需要重置本地开发数据库
npx skills add fmaclen/canutin --skill verify -g -y
规范 Git 提交与 PR 流程，要求操作前获取用户明确授权并引用指令。定义语义化版本前缀（feat/fix/chore）以控制发布部署，强调提交卫生及 PR 格式一致性，确保代码变更安全可控。
执行 git commit, push 或 rebase 等写入历史的操作
创建 Pull Request 或编写 Commit Message
npx skills add fmaclen/canutin --skill commits-and-prs -g -y
