Agent Skills
› ai-shifu/ai-shifu
ai-shifu/ai-shifu
GitHub用于规范后端 Shifu 内容创作流程的修改，涵盖草稿、发布、历史及导入导出行为。确保状态分离、结构变更通过辅助模块处理，并同步更新权限与测试，保障大纲完整性。
Install All Skills
npx skills add ai-shifu/ai-shifu --all -g -y
Skills in Collection (17)
用于规范后端 Shifu 内容创作流程的修改，涵盖草稿、发布、历史及导入导出行为。确保状态分离、结构变更通过辅助模块处理，并同步更新权限与测试，保障大纲完整性。
修改后端 Shifu 创作逻辑
调整草稿或发布流程
变更大纲结构或导入导出功能
npx skills add ai-shifu/ai-shifu --skill shifu-authoring-flow -g -y
处理后端用户认证、验证码、Token持久化及临时用户逻辑变更，确保凭证状态与提供者调度集中管理，同步更新前后端载荷。
修改后端用户认证逻辑
调整验证码或Token持久化策略
集成新的认证提供者
npx skills add ai-shifu/ai-shifu --skill user-auth-flows -g -y
规范 Next.js App Router 全局及路由级错误兜底页实现，统一错误信息展示、复制及样式，确保兼容 SSR 与客户端环境。
需要配置或修改 Next.js error.tsx 和 global-error.tsx
调整前端应用的全局错误处理逻辑
npx skills add ai-shifu/ai-shifu --skill app-error-boundary-display -g -y
规范异步确认弹窗的请求态管理，确保按钮防重复点击、loading状态与请求完成同步，并拦截非正常关闭。
实现带异步操作的确认弹窗
优化弹窗的防重复提交和加载状态
修复弹窗关闭时机与请求不同步的问题
npx skills add ai-shifu/ai-shifu --skill async-confirm-dialog-loading -g -y
规范聊天操作栏、追问入口及 AskBlock 锚点的插入时机与样式，解决双输入框、错位及状态不同步问题，确保多端交互一致。
调整聊天操作栏布局
处理追问入口显示时机
修复 AskBlock 锚点展示异常
npx skills add ai-shifu/ai-shifu --skill chat-actionbar-ask-placement -g -y
规范 AI 聊天流从 block 到 element 粒度的渲染逻辑，统一 key 管理、兼容旧字段并处理 SSE 流式一致性、超时及打字机效果等边界问题。
AI 聊天流渲染粒度演进
SSE 流式数据与历史记录不一致
调试预览链路状态异常
npx skills add ai-shifu/ai-shifu --skill chat-element-streaming -g -y
修复ai-shifu聊天页移动端与桌面端布局判定不一致问题。通过多源DOM宽度计算真实视口，同步resize事件并纠正状态，增加SSR防护及测试覆盖。
修复聊天页响应式布局误判
优化移动端WebView下的视口检测逻辑
npx skills add ai-shifu/ai-shifu --skill chat-layout-width-detection -g -y
规范学习端与后台端深链定位课节的路由逻辑，统一使用lessonid参数及解析链路，覆盖登录、付费及无效兜底场景。
实现课程深链跳转功能
修复前后端路由行为不一致问题
npx skills add ai-shifu/ai-shifu --skill deep-link-lessonid-routing -g -y
解决浏览器全屏模式下 Dialog 弹窗因 Portal 挂载到 body 导致不可见的问题，通过通用封装层监听全屏状态并动态调整容器，确保弹层正确渲染。
浏览器全屏下弹窗不可见
全屏切换时弹窗位置异常
全屏宿主节点被卸载导致全屏退出
npx skills add ai-shifu/ai-shifu --skill fullscreen-dialog-portal -g -y
规范交互输入状态的持久化与传递，将解析逻辑下沉至markdown-flow-ui以统一默认值渲染，避免业务代码重复实现。
需要同步交互式Markdown状态
需统一处理按钮或输入框默认值
npx skills add ai-shifu/ai-shifu --skill interaction-user-input-defaults -g -y
处理听课模式下流式音频的缓冲、TTS门禁及播放连续性，统一音频源选择与分段合并策略，确保字幕透传与状态同步。
处理听课模式下的流式音频请求
解决TTS请求门禁与播放连续性问题
处理音频缓冲与分段合并逻辑
npx skills add ai-shifu/ai-shifu --skill listen-mode-audio-streaming -g -y
指导 Learner 端接入 markdown-flow-ui 移动端播放器能力，涵盖横竖屏透传、自定义 Header、国际化及共享组件复用，确保状态管理与样式统一。
需要为移动端听课模式集成新的播放器功能
涉及横竖屏状态处理或播放器文案国际化
npx skills add ai-shifu/ai-shifu --skill listen-mode-slide-mobile-integration -g -y
解决MarkdownFlowEditor在受控模式下因本地输入与外部同步冲突导致的中间态残留问题，通过隔离回显逻辑确保数据一致性。
编辑器出现临时变量或中间态错误保留
本地输入与远端草稿同步冲突
章节切换时上下文残留
npx skills add ai-shifu/ai-shifu --skill markdownflow-controlled-sync -g -y
解决 TypeScript 子路径导出类型丢失或冲突，通过规范模块增强写法避免覆盖上游导出，确保类型声明正确生效。
TypeScript 子路径导出类型丢失
类型声明冲突
模块增强需避免覆盖上游
npx skills add ai-shifu/ai-shifu --skill module-augmentation-guardrails -g -y
用于排查 Next.js 构建时因 Node 版本不兼容导致的语法错误。通过检查运行时版本、对照引擎要求并修复环境，解决 Unexpected token 报错，确保构建顺利进行。
npm run build 报 SyntaxError Unexpected token '?'
next/dist/compiled 内部文件报语法错误
npx skills add ai-shifu/ai-shifu --skill next-build-node-runtime -g -y
用于安全重构 Hook 契约，确保返回字段或参数变更时，所有调用方的解构与对象同步更新，避免 TS 类型错误。
重构 Hook 返回字段
修改 Hook 参数
npx skills add ai-shifu/ai-shifu --skill hook-contract-refactor-safety -g -y
