司南系统：给你的 AI 编程助手装上「本地技能导航仪」

你是否试过让 Claude 或 Codex 帮你写脚本、查日志、部署服务，却总要反复解释上下文、重输项目结构、手动复制粘贴命令？COMPASS Skills（中文名“司南”）正是为解决这一痛点而生——它不是另一个大模型聊天界面，而是一套轻量、开源、完全本地运行的「AI 技能操作系统」，让你把日常开发任务沉淀为可复用、可审计、可组合的 Markdown 技能卡片（SKILL.md），让 AI 真正理解你的工作流，而不是只听懂单次提问。

核心功能

• 技能即文档：所有能力以纯文本 SKILL.md 形式编写，含清晰输入/输出定义、执行逻辑、安全约束与示例，人类可读、AI 可解析、Git 可版本化
• 本地优先，隐私可控：技能全部运行在你自己的机器上，无需上传代码或敏感数据；支持离线调用本地 LLM（如 Ollama 模型），也兼容 OpenAI/Claude/Codex 等远程 API
• 四合一基础能力：开箱即用提供「任务澄清」「环境感知」「代码生成」「执行反馈」四大原子技能，覆盖从需求对齐到结果验证的完整闭环
• 技能生态一键集成：通过 npx skills add 命令，30 秒即可引入他人开源的技能包（如 Git 自动化、Docker 调试、日志分析等），支持星标、筛选与权限审计
• 开发者友好工作流：内置技能模板生成器、本地预览调试器、技能依赖图可视化工具，配合 VS Code 插件可实现「边写技能边测试」
• 面向真实场景设计：不追求通用 AGI，专注解决程序员每日高频任务——比如「帮我把这 5 个 PR 的变更自动汇总成周报」或「检查当前项目是否符合 PEP8 + 安全扫描规则」

适合哪些人用

如果你是：经常和 AI 协作写代码的前端/后端/运维工程师；希望把重复性技术操作（如 CI 配置、日志排查、API 测试）标准化的团队技术负责人；正在探索「个人 AI 工作流」的独立开发者或技术博主；或者只是厌倦了每次提问都要重新描述项目背景的务实程序员——那么 COMPASS Skills 就是你需要的「AI 协作操作系统」。它不替代你思考，而是帮你把思考成果固化为可传承、可协作、可演进的数字资产。

快速上手

只需三步，5 分钟启动你的首个本地技能：

1. 安装 CLI 工具：npm install -g @compass-skills/cli（需 Node.js 18+）
2. 拉取官方技能包：npx skills add dongshuyan/compass-skills --skill '*' -a claude-code（自动适配 Claude 编程模式）
3. 运行并体验：进入项目目录，执行 skills run "帮我分析当前 git diff 并建议重构点" —— AI 将结合你本地代码、技能定义与模型能力，给出结构化响应

进阶用户可参考官方《[技能写作教程](https://dongshuyan.com/compass-skills/skill-writing-tutorial.html)》学习如何将自己常用的 Shell 脚本、Python 工具或团队 SOP 转化为可共享的 SKILL.md。

项目信息

编程语言：Python｜GitHub Star 数：379｜开源协议：MIT｜GitHub 项目地址

它让 AI 从「问答机器」变成你代码世界的「本地向导」——不靠更大参数，而靠更懂你。