navi_agent

Navi Agent 设计参考库。当用户询问 navi agent 的架构设计、功能方案、技术选型、或某个具体实现应该如何做时，自动参考 Claude Code (cc_src/)、KIMI-CLI (kimi-cli/)、Hermes (hermes-agent/) 三个成熟项目的源码来提供建议。触发场景包括：讨论 agent loop 设计、工具系统、审批机制、会话管理、UI/CLI 交互、技能系统、插件机制、subagent、MCP 集成等任何 navi 的功能设计问题。也适用于：添加新工具、修改工具行为、集成外部 API。也适用于：多智能体系统设计、Worker 模式、sub_agent 委派模式、Interactive SubAgent 模式、Human-in-the-Loop 模式。也适用于：LangGraph 功能评估、工具调用兼容性分析、模型适配方案选型。

CLI agent 工具输出架构设计与调试。当排查工具输出重复、输出丢失、输出乱序、实时流与结果渲染冲突、输出截断策略等问题时使用。也适用于为新的 CLI agent 工具设计输出通道。触发词：工具输出重复、output twice、双份输出、流式输出、tool result rendering、输出截断、truncat。

Navi Agent 工具开发指南。当需要为 Navi 添加新工具（tool）、修改已有工具、或理解工具注册机制时使用。触发场景：用户说"写一个 XX 工具"、"添加工具"、"tool 怎么写"、"注册工具"、涉及 tool.py 或 runtime.py 中工具注册部分的修改。也适用于：集成外部工具协议（MCP 等）、添加工具子系统、批量注册动态发现的工具。也适用于：添加或修改斜杠命令（/xxx）、斜杠命令子命令。

演示文稿创建、编辑和分析。当用户需要处理 PowerPoint 演示文稿（.pptx 文件）时使用，包括创建新演示文稿、修改内容、处理布局、添加批注或演讲者备注等。也适用于将 guizang-ppt HTML 转换为 PPTX。也适用于基于 Word/文本文档生成学术汇报 PPT（docx→PPT），包含中文学术 PPT 配色方案、卡片布局、条形图、表格等常用模式。触发词：做PPT、做个PPT、演示文稿、slides、presentation、汇报PPT。

Discover agent-native CLIs for professional software. Access the live catalog to find tools for creative workflows, productivity, AI, and more.

深入分析复杂项目的架构设计、核心机制和实现原理。当用户询问"为什么 X 能做到 Y"、"系统是怎么工作的"、"分析一下这个项目的架构"时使用。也适用于主动分析开源项目的技术栈、模块划分、数据流、配置体系。覆盖 LangChain/LangGraph Agent、前后端分离 Web 应用、CLI 工具等常见项目类型。也适用于：代码缺陷审查（安全漏洞、架构问题、设计反模式）、两个或多个项目的全面对比分析。触发词："缺陷"、"有什么问题"、"对比"、"区别"、"哪个更好"、"review"、"审计"。

全面处理文档创建、编辑和分析，支持修订、批注、格式保留和文本提取。当需要处理专业 Word 文档（.docx 或 .doc 文件）时使用，包括：创建新文档、修改或编辑内容、处理修订、添加批注、提取文本内容或其他文档任务。也适用于中文学术报告、课程设计说明书等格式化文档的生成，以及将matplotlib图表插入到Word文档中。也适用于填写表单模板（中期验收表、申请书、评审表等），从多个参考文档（xlsx、docx、用户记忆）提取数据后填写到 .doc/.docx 表单中。

解决git克隆过程中的常见问题，包括网络超时、目录非空、RPC失败、curl错误等。当用户遇到git clone失败、网络连接问题、目录冲突时使用。触发词：git clone失败、网络超时、RPC failed、curl error、目录非空、clone问题。

[已废弃] 此技能已合并到 local-llm-gguf。请使用 local-llm-gguf 替代。

[已废弃] 此技能已合并到 local-llm-gguf。请使用 local-llm-gguf 替代。

从 HuggingFace 下载 GGUF 模型并在本地运行（llama.cpp 或 Ollama）。 当用户问"怎么本地跑模型"、"部署 GGUF"、"llama.cpp 安装"、"本地跑 LLM"、 "下载 HuggingFace 模型"、"量化模型怎么选"时使用。 也适用于：检查本地 LLM 环境（ollama/llama.cpp 版本、安装路径、模型路径）、 迁移 Ollama 模型到其他磁盘、配置 OLLAMA_MODELS 环境变量。 覆盖：llama.cpp 安装（Windows）、GGUF 下载、量化版本选择、 llama-server/llama-cli 启动参数、Ollama 替代方案、常见问题排查。 也适用于：计算显存与上下文长度关系、估算模型显存需求、优化显存使用。 触发词：GGUF、llama.cpp、本地部署、本地运行、量化、Q4_K_M、Q8_0、gguf download、local LLM、 ollama 版本、ollama 路径、模型迁移、OLLAMA_MODELS、显存、上下文长度、VRAM、GPU内存、8GB显存。

[已废弃] 此技能已合并到 local-llm-gguf。请使用 local-llm-gguf 替代。

管理 uv、npm、pip 等包管理工具，包括安装、配置、检查版本、管理已安装包、环境隔离等。当用户询问"uv tool 怎么用"、"npm global 装了什么"、"pip 包管理"、"工具链管理"、"环境隔离"时使用。也适用于：检查包管理工具版本、列出已安装包、安装新包、配置缓存目录、迁移包存储位置。触发词：uv、npm、pip、包管理、工具链、环境隔离、全局安装、global install。

系统性研究GitHub项目信息的方法论。当用户询问某个开源项目的兼容性、安装方式、平台支持、架构设计、功能特性等问题时使用。适用于：(1) 项目是否支持某个平台/环境 (2) 安装和配置方式 (3) 与上游项目/分支的差异 (4) 项目的实际能力和限制。触发词："能不能用"、"支持XX吗"、"怎么装"、"和XX有什么区别"。

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Navi's capabilities with specialized knowledge, workflows, or tool integrations.

MUST USE when user wants to research/search/look up/find anything on the internet — e.g. "research this topic", "do a deep dive on X", "search the web for X", "see what people say about X", "look this up". Also MUST USE when user mentions any platform or shares any URL/link: Twitter/X, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu, Xiaoyuzhou Podcast, LinkedIn/jobs/recruiting, V2EX, Xueqiu (stocks), RSS. 13 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs). Zero config for 6 channels. Run `agent-reach doctor --json` to see which backend serves each platform right now. NOT for: writing reports/analysis/translation (this skill only FETCHES internet content); posting/commenting/liking (write operations); platforms that already have a dedicated skill installed (prefer that skill).

CLI agent 大文本粘贴处理机制。当用户询问"粘贴大量文本怎么处理"、"输入框粘贴"、"paste handling"、"large text input"、"多行输入折叠"、"bracketed paste"时使用。也适用于实现粘贴折叠、引用展开、终端兼容性处理等功能。触发词：粘贴、paste、大文本、折叠、collapse、bracketed paste、终端兼容。

CLI agent 大段粘贴处理模式。当用户在输入框粘贴大量文本（代码、日志、配置等）时，将内容折叠为文件引用以保持输入框清晰，提交时再展开为原始内容。适用于：实现 CLI agent 输入框、处理用户粘贴、优化大段文本输入体验。触发词：粘贴折叠、paste collapsing、大段输入、输入框优化、paste handling。

Use the ctx7 CLI to fetch library documentation, manage AI coding skills, and configure Context7 MCP. Activate when the user mentions "ctx7" or "context7", needs current docs for any library, wants to install/search/generate skills, or needs to set up Context7 for their AI coding agent.

使用 Python 进行数据分析的完整工作流：数据加载、探索性分析、统计检验、机器学习建模、特征工程、超参数调优、可视化。当用户要求分析数据集（CSV/Excel）、做统计分析、建预测模型、画图表时使用。也适用于审查/修复用户提供的数据分析脚本、将现有脚本适配到非交互式环境运行。触发词：数据分析、统计分析、预测模型、机器学习、pandas、sklearn、相关性分析、卡方检验、方差分析、数据可视化、EDA。

Hand-drawn Excalidraw JSON diagrams (arch, flow, seq).

创建有辨识度、生产级、高设计质量的前端界面。当用户要求构建 Web 组件、页面或应用时使用。生成有创意、精致的代码，避免通用的 AI 风格审美。

Initialize a local directory as a Git repo and push it to a new GitHub repository. Use when the user asks to "push to GitHub", "create a repo and push", "init and publish", or similar. Handles .gitignore, missing git config, and one-command gh repo create.

生成横向翻页网页 PPT（单 HTML 文件），含 WebGL 背景、章节幕封、数据大字报、图片网格等模板。提供两种风格：① "电子杂志 × 电子墨水"（衬线 + 流体背景 + 暖色） ② "瑞士国际主义"（无衬线 + 网格点阵 + IKB/柠檬黄/柠檬绿/安全橙高亮）。当用户需要制作分享 / 演讲 / 发布会风格的网页 PPT，或提到"杂志风 PPT"、"瑞士风 PPT"、"Swiss Style"、"horizontal swipe deck"时使用。

在LangGraph中使用ToolNode时保留自定义工具调用构造方式。当模型不支持标准bind_tools()、需要手动解析流式响应中的tool_calls、或要从手写工具执行逻辑迁移到ToolNode时使用。

Create Mermaid diagrams (flowchart, mindmap, sequence, class, etc.) as HTML files. Use when the user asks for a diagram, flowchart, mind map, sequence diagram, architecture diagram, or any visual chart. Covers syntax rules, common pitfalls, and delivery workflow.

Use OpenCLI to access authenticated web platforms by reusing Chrome browser login state. Activate when user wants to: search/read content from platforms like XiaoHongShu, Twitter/X, Reddit, Bilibili, LinkedIn, or any website that requires login. OpenCLI connects to Chrome via a browser extension and reuses existing login sessions — no cookies or API keys needed. NOT for: form filling, browser automation (use playwright-form-filler instead), platforms with dedicated skills already installed.

Automate browser interactions, test web pages and work with Playwright tests.

Use playwright-cli to automate browser form filling in headed (visible) mode. Activate when user wants to: fill online forms, submit surveys, complete questionnaires, automate repetitive web form tasks, or interact with authenticated web pages. Covers: opening visible browser, navigating to pages, selecting dropdowns, filling text inputs, clicking buttons, saving/loading login state, multi-tab management, dialog handling, iframe navigation, screenshot verification. NOT for: web scraping at scale, headless automation, API testing.

Create math explanation videos using Remotion + KaTeX + SVG. Use when the user asks for a math video, tutorial video, animated math explanation, or any video that needs mathematical formulas and animated graphs. Covers project setup, KaTeX rendering, SVG coordinate mapping, animation patterns, and rendering to MP4.

审计基于正则的 shell 命令安全模式，发现绕过路径，设计更健壮的命令审批机制。当用户问"这个正则能不能绕过"、"命令安全检测有没有漏洞"、"怎么防止 shell 命令注入"时使用。也适用于：设计命令审批系统、实现命令白名单/黑名单、按逻辑连词分割命令做细粒度检查。触发词：绕过、bypass、命令审计、shell 安全、正则匹配、命令审批、approval、危险命令、硬阻断。

Install Navi skills into $NAVI_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

SQLite FTS5 全文搜索实现指南。当需要为 SQLite 数据库添加全文搜索功能时使用，包括：CJK（中日韩）子串搜索、倒排索引设计、触发器自动同步、查询清洗。适用于：会话历史搜索、文档检索、日志搜索、任何需要文本搜索的场景。触发词：FTS5、全文搜索、full text search、会话搜索、历史搜索、trigram、CJK 搜索。

让 Windows 上的 CLI 工具在任意路径下直接输入命令启动。 当用户问"如何让 XX 命令全局可用"、"在任意目录输入 XX 启动"、"添加到 PATH"、 "文件资源管理器地址栏输入命令"时使用。 适用于 Python venv 中的 CLI 工具、npm 全局工具、uv tool、任何需要全局访问的命令行程序。 触发词：全局可用、PATH、任意路径、地址栏、环境变量、where、which。