# linght-skills **Repository Path**: linght/linght-skills ## Basic Information - **Project Name**: linght-skills - **Description**: linght-skills - **Primary Language**: C++ - **License**: AFL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-05-15 - **Last Updated**: 2026-06-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # linght-skills Marketplace v2.5.1 linght-skills 是 linght 团队的 Claude Code marketplace,采用 **bundle + standalone 两根**结构:`bundles/` 提供 4 个整组装容器(common/software/open-source/superpowers),`standalone/` 收纳 14 个 loose skill signpost(指路牌),统一引导 LLM 安装和使用外部 CLI 工具。配套 `sync-skills` 工具支持 Claude Code 与 Kimi Code 跨平台同步。 ## 设计理念(v2.5.1 bundle + standalone 两根) - **bundle 入口**:4 个 `bundles//` 整组装,适合无外部依赖、整组加载即用的 skill 集合 - **standalone 入口**:`standalone//` 单装,收纳 **loose skill signpost**(指路牌),纯 SKILL.md 指导 LLM 安装和使用外部 CLI 工具,无 hooks/commands - **4 个 bundle**: - `bundles/common/` — 通用规则(global-rules、karpathy-guidelines、prompt-audit) - `bundles/open-source/` — 3 个**纯 prompt** skill(context-mode、sync-skills、last30days),无外部运行时依赖 - `bundles/software/` — 软件研发部门(C/C++ 编码规范、QML 规范) - `bundles/superpowers/` — Workflow 工具集(14 个去前缀子技能,必须整组) - **14 个 standalone loose skill signpost**: - `standalone/help-find-skills/` — 技能发现(依赖 `npx skills`) - `standalone/help-graphify/` — 文档可视化(依赖 `pip install graphifyy`) - `standalone/help-scrapling-skill/` — 网页抓取(依赖 `pip install scrapling`) - `standalone/help-open-code-review/` — 辅助安装和配置 open-code-review (`ocr`) CLI 工具 - `standalone/help-headroom/` — tool output/log 压缩(依赖 `pip install headroom-ai`) - `standalone/help-markitdown/` — 文档转 Markdown(依赖 `pip install 'markitdown[all]'`) - `standalone/help-pm-skills/` — PM skills marketplace 指路牌(指向 `claude plugin marketplace add phuryn/pm-skills`) - `standalone/help-understand-anything/` — 交互式知识图谱 marketplace 指路牌(指向 `claude plugin marketplace add Egonex-AI/Understand-Anything`) - `standalone/help-caveman/` — 极简压缩通信模式(节省约75% token,保持技术准确性) - `standalone/help-claude-hud/` — Claude Code 状态栏插件 - `standalone/help-code-review-graph/` — 本地代码知识图谱(SessionStart hook 自动安装依赖) - `standalone/help-codegraph/` — 预索引代码知识图谱 (MCP 协议,减少 token 和工具调用) - `standalone/help-prompt-optimizer/` — 双引擎提示词优化器(3300+ 模板库) - `standalone/help-skill-creator/` — 创建和优化 AI 技能的纯 prompt 级工具 - **跨平台同步**:sync-skills 工具支持 Claude Code(`~/.claude/`)与 Kimi Code(`~/.config/agents/`)双目标路径;区分 bundle(落 `skills/`)与 loose skill signpost(落 `skills//`)。 ## 本版更新(v2.5.1) > v2.3.0 将 4 个 skill(prompt-optimizer、skill-creator、code-review-graph、open-code-review)从 bundle 迁至 `optional/`,使其成为独立可装的全功能插件(含 SessionStart hook 自动安装验证)。 > v2.3.1 将 `open-code-review` 从 full plugin 改为 loose skill(`help-open-code-review`),仅提供安装方法和使用指南 — 不再内置 hook 和运行时脚本。 > v2.3.2 将 `help-open-code-review/` 从 `optional/` 提升至仓库根目录,作为 standalone loose skill。 > v2.4.0 统一收口:创建 `standalone/` 顶层目录收纳全部 4 个 loose skill signpost(help-find-skills、help-graphify、help-scrapling-skill、help-open-code-review),形成 bundle + optional + standalone 三根架构。 > v2.5.0 重构:将 6 个 optional full plugin 迁移为 standalone loose skill signpost,简化架构为 bundle + standalone 两根。 - **optional/ 目录清空**:6 个 full plugin(caveman、claude-hud、codegraph、code-review-graph、prompt-optimizer、skill-creator)迁移至 standalone/ 目录 - **standalone/ 扩展至 14 个 signpost**:新增 help-caveman、help-claude-hud、help-codegraph、help-code-review-graph、help-prompt-optimizer、help-skill-creator - **marketplace.json entry 数**:**14 条**(4 bundle + 10 standalone) - **版本号递增**:marketplace.json → v2.5.1 - **上游技能同步**:更新 superpowers、context-mode、graphify、open-code-review 等 SKILL.md ## 安装姿势(v2.5.1) ### Claude Code(推荐) ```bash # 1. 添加 marketplace /plugin marketplace add https://gitee.com/linght/linght-skills.git # 2a. 整组装一个 bundle(详见下方「Bundle 详解」章节) /plugin install common # 通用规则(3 skill) /plugin install open-source # 纯 prompt 工具(3 skill) /plugin install software # 软件研发规范(2 skill) /plugin install superpowers # 工作流套装(14 skill,必须整组) # 2b. 单装一个 standalone signpost(纯 SKILL.md 指路牌,无 hooks/commands) /plugin install help-find-skills # 指路牌;指导 AI 使用 npx skills /plugin install help-graphify # 指路牌;指导 AI 使用 pip install graphifyy /plugin install help-scrapling-skill # 指路牌;指导 AI 使用 uv tool install 'scrapling[shell]' /plugin install help-open-code-review # 指路牌;指导 AI 安装 ocr + 配置 LLM + 执行审查 /plugin install help-headroom # 指路牌;指导 AI 用 headroom-ai 压缩 tool output/log /plugin install help-markitdown # 指路牌;指导 AI 用 markitdown 把文档转成 Markdown /plugin install help-caveman # 指路牌;指导 AI 使用 caveman 压缩通信模式 /plugin install help-claude-hud # 指路牌;指导 AI 安装 claude-hud 状态栏插件 /plugin install help-codegraph # 指路牌;指导 AI 安装 codegraph 代码知识图谱 /plugin install help-code-review-graph # 指路牌;指导 AI 安装 code-review-graph 本地代码图谱 /plugin install help-prompt-optimizer # 指路牌;指导 AI 使用 prompt-optimizer 优化提示词 /plugin install help-skill-creator # 指路牌;指导 AI 使用 skill-creator 创建技能 ``` ### 跨平台(Kimi Code 等) 通过 sync-skills 工具按需同步: ```bash # 列出所有可装项让你选(默认) /sync-skills # 整仓全装 /sync-skills all # 装一个 bundle /sync-skills superpowers /sync-skills open-source /sync-skills common /sync-skills software # 装一个 standalone signpost(落 skills/) /sync-skills claude-hud /sync-skills help-graphify # 多选 /sync-skills common,claude-hud ``` > 注意:standalone signpost 通过 sync-skills 落盘到 `~/.claude/skills//` 后,Claude Code 会自动识别为已安装 skill。 详细协议见 [`bundles/open-source/skills/sync-skills/SKILL.md`](./bundles/open-source/skills/sync-skills/SKILL.md)。 ## Bundle 详解(4 个整组装) 4 个 bundle 都是**无外部运行时依赖**的纯 prompt skill 集合,整组加载即用。各 bundle 定位与成员如下。 ### common — 通用规则(3 skill) 团队级工程规范与 AI 协作准则,适合所有项目。 | skill | 作用 | |-------|------| | `global-rules` | CRTE 全局工程规则:可追溯的 AI 改动、最小 diff、测试与 review 期望 | | `karpathy-guidelines` | 降低 LLM 编码失误:显式假设、权衡、测试、风险检查 | | `prompt-audit` | 改动后写最小审计记录到 `.ai/prompt-audit/` | ```bash /plugin install common ``` ### open-source — 纯 prompt 工具(3 skill) 开源社区移植的通用工具,无外部运行时依赖(依赖外部上游的工具已迁至 `optional/` 或 `standalone/`)。 | skill | 作用 | |-------|------| | `context-mode` | 大输出用 `ctx_execute` 替代 Bash/cat(分析日志、汇总数据) | | `sync-skills` | 跨平台同步本仓库 skill 到本地(Claude Code + Kimi Code) | | `last30days` | 跨 Reddit/X/YouTube/HN/Polymarket/Web 研究 30 天趋势,输出带源链接的综述 | ```bash /plugin install open-source ``` ### software — 软件研发规范(2 skill) 软件部门的编码规范。 | skill | 作用 | |-------|------| | `c-cpp-coding-rules` | C/C++/Qt C++ 命名、文件组织、布局、中文注释规范 | | `qml-coding-style` | Qt/QML 文件结构、命名、属性顺序、Repeater/Timer 模式规范 | ```bash /plugin install software ``` ### superpowers — 工作流套装(14 skill) TDD、调试、计划、review 等 14 个工作流子技能,去 `superpowers-` 前缀,**必须整组安装**。 | 类别 | skill | |------|-------| | 创意 / 计划 | `brainstorming`、`writing-plans`、`executing-plans` | | 实现质量 | `test-driven-development`、`systematic-debugging`、`verification-before-completion` | | 协作 | `subagent-driven-development`、`dispatching-parallel-agents`、`using-git-worktrees` | | Review | `requesting-code-review`、`receiving-code-review`、`finishing-a-development-branch` | | 元技能 | `using-superpowers`(入口)、`writing-skills`(创建技能) | ```bash /plugin install superpowers ``` > superpowers 子技能不能单装(必须整组)。如需单装某个,用 `/sync-skills superpowers` 同步后手动挑取,或参考 `bundles/superpowers/skills/` 目录结构。 ## 仓库结构(v2.5.1) ```text linght-skills/ ├── .claude-plugin/ │ ├── marketplace.json ← Claude Code marketplace 索引(14 条 entry:4 bundle + 10 standalone) │ ├── third-party-sources.toml ← 上游技能追踪配置 │ └── wxpusher-config.txt ← WxPusher 推送配置(已 gitignore) ├── bundles/ ← 整组装入口(无外部依赖的 skill 集合) │ ├── common/ │ │ ├── .claude-plugin/plugin.json │ │ └── skills/ (3 个 skill: global-rules, karpathy-guidelines, prompt-audit) │ ├── open-source/ │ │ ├── .claude-plugin/plugin.json │ │ └── skills/ (3 个纯 prompt skill: context-mode, sync-skills, last30days) │ ├── software/ │ │ ├── .claude-plugin/plugin.json │ │ └── skills/ (2 个 skill: c-cpp-coding-rules, qml-coding-style) │ └── superpowers/ │ ├── .claude-plugin/plugin.json │ └── skills/ (14 个 workflow 子技能,去 superpowers- 前缀) ├── standalone/ ← signpost 指路牌入库存 (纯 SKILL.md,指导 LLM 安装和使用外部 CLI) │ ├── help-find-skills/ (loose skill 指路牌 — npx skills) │ ├── help-graphify/ (loose skill 指路牌 — pip graphifyy) │ ├── help-scrapling-skill/ (loose skill 指路牌 — pip scrapling) │ ├── help-open-code-review/ (loose skill 指路牌 — ocr CLI) │ ├── help-headroom/ (loose skill 指路牌 — headroom-ai 压缩) │ ├── help-markitdown/ (loose skill 指路牌 — Microsoft markitdown) │ ├── help-pm-skills/ (loose skill 指路牌 — phuryn/pm-skills marketplace) │ ├── help-understand-anything/ (loose skill 指路牌 — Egonex-AI/Understand-Anything) │ ├── help-caveman/ (loose skill 指路牌 — caveman 压缩通信) │ ├── help-claude-hud/ (loose skill 指路牌 — claude-hud 状态栏) │ ├── help-codegraph/ (loose skill 指路牌 — codegraph 代码知识图谱) │ ├── help-code-review-graph/ (loose skill 指路牌 — code-review-graph 本地代码图谱) │ ├── help-prompt-optimizer/ (loose skill 指路牌 — prompt-optimizer 提示词优化) │ └── help-skill-creator/ (loose skill 指路牌 — skill-creator 技能创建) ├── optional/ ← 已清空(历史 full plugin 已迁移至 standalone/) │ ├── .gitkeep │ └── README.md (optional/ 历史记录与迁移说明) ├── reports/ ← 自动化同步报告 │ ├── sync-report-YYYY-MM-DD.md │ └── wxpusher_notify.py ← WxPusher 推送脚本 ├── scripts/ ← 项目内部工具 │ ├── check-skill-names.sh ← SKILL.md name 字段校验 │ ├── update-skills-lock.sh ← 镜像完整性哈希更新 │ └── _inspect_mirrors.py ← 镜像元数据检查 ├── docs/ ← 设计文档与迁移指南 │ ├── migration-plugin-to-bundle.md (v1 → v2.0 迁移) │ ├── migration-v2.0-to-v2.1.md (v2.0 → v2.1 迁移) │ ├── migration-v2.1-to-v2.2.md (v2.1 → v2.2 迁移) │ └── superpowers/ ← specs/ + plans/ ├── openspec/ ← 规格驱动开发产物(changes/ + specs/) └── skills-lock.json ← sync-skills 上游同步基线 ``` ## 功能分组与推荐 14 个 skill/plugin 按用途分组如下,每组末尾给出推荐。所有命令均为 Claude Code 的 `/plugin install`。 > ⚠️ **standalone signpost 是"指路牌"**:安装它只装一个 SKILL.md(指导 AI 如何用外部工具),**外部工具本身(pip/npm 包或上游 marketplace)仍需按 SKILL.md 单独安装**。下文标注「signpost」者均为指路牌。 ### 🧠 工程规范与协作 让 AI 改动可追溯、写代码更严谨、留审计痕迹。 | 选项 | 形态 | 说明 | 安装命令 | 上游 | |------|------|------|---------|------| | **common bundle**(3 skill) | bundle | global-rules + karpathy-guidelines + prompt-audit | `/plugin install common` | 本仓库自研 | | `help-skill-creator` | standalone signpost | 创建/优化 AI 技能(纯 prompt) | `/plugin install help-skill-creator` | [anthropics/claude-plugins-official](https://github.com/anthropics/claude-plugins-official) | **推荐**:`/plugin install common`(团队所有项目必备);经常写技能再加 `help-skill-creator`。 ### 🛠️ 工作流方法论 系统化的开发流程纪律(TDD、调试、计划、review)。 | 选项 | 形态 | 说明 | 安装命令 | 上游 | |------|------|------|---------|------| | **superpowers bundle**(14 skill) | bundle | brainstorming/writing-plans/executing-plans/TDD/debugging/review 等,整组 | `/plugin install superpowers` | [obra/superpowers](https://github.com/obra/superpowers) | | `help-open-code-review` | standalone signpost | 指导用外部 ocr CLI 做行级 AI review | `/plugin install help-open-code-review` | [alibaba/open-code-review](https://github.com/alibaba/open-code-review) | **推荐**:`/plugin install superpowers`(工程师标准包);要外部 AI 行级评论加 `help-open-code-review`。 ### 📊 Token 压缩 / 上下文优化 减少喂给模型的 token,省成本、扩窗口。 | 选项 | 手段 | 适用 | 安装命令 | 上游 | |------|------|------|---------|------| | `context-mode`(在 open-source bundle) | 大输出改走 `ctx_execute` | 日志分析、数据汇总 | `/plugin install open-source` | [mksglu/claude-context-mode](https://github.com/mksglu/claude-context-mode) | | `help-caveman` | standalone signpost→极简压缩通信 | 全程压缩对话 | `/plugin install help-caveman` | [JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman) | | `help-headroom` | standalone signpost→`pip headroom-ai` | 一次性压大文件/日志 | `/plugin install help-headroom` | [chopratejas/headroom](https://github.com/chopratejas/headroom) | | `help-codegraph` | standalone signpost→MCP 预索引图谱 | 大代码库理解 | `/plugin install help-codegraph` | [colbymchenry/codegraph](https://github.com/colbymchenry/codegraph) | **推荐**:日常 `/plugin install open-source`(含 context-mode);想全程自动压缩加 `/plugin install help-caveman`;压单个大文件加 `help-headroom`。 ### 🗺️ 代码知识图谱 / 可视化 把代码库变成可探索、可问答的图谱。 | 选项 | 形态 | 侧重 | 安装命令 | 上游 | |------|------|------|---------|------| | `help-graphify` | standalone signpost→`pip graphifyy` | 文档/代码可视化 | `/plugin install help-graphify` | [safishamsi/graphify](https://github.com/safishamsi/graphify) | | `help-codegraph` | standalone signpost | MCP 预索引图谱,token 优化 | `/plugin install help-codegraph` | [colbymchenry/codegraph](https://github.com/colbymchenry/codegraph) | | `help-code-review-graph` | standalone signpost | review 聚焦图谱 | `/plugin install help-code-review-graph` | [tirth8205/code-review-graph](https://github.com/tirth8205/code-review-graph) | | `help-understand-anything` | standalone signpost→上游 marketplace | 交互式探索 + web dashboard | `/plugin install help-understand-anything` | [Egonex-AI/Understand-Anything](https://github.com/Egonex-AI/Understand-Anything) | **推荐(4 选 1/2 即可)**:要 token 效率用 `help-codegraph`;要交互探索装 `help-understand-anything` 指路牌。 ### 📄 文档转换 / 抓取 把外部内容变成模型能读的 Markdown。 | 选项 | 输入 | 形态 | 安装命令 | 上游 | |------|------|------|---------|------| | `help-markitdown` | PDF/Word/Excel/PPT/图片/音频 → MD | standalone signpost→`pip markitdown` | `/plugin install help-markitdown` | [microsoft/markitdown](https://github.com/microsoft/markitdown) | | `help-scrapling-skill` | 网页(含微信公众号)→ 数据 | standalone signpost→`pip scrapling` | `/plugin install help-scrapling-skill` | [daymade/claude-code-skills](https://github.com/daymade/claude-code-skills) | **推荐**:处理文档 `/plugin install help-markitdown`;抓网页 `/plugin install help-scrapling-skill`。 ### 🔍 代码审查 | 选项 | 形态 | 特点 | 安装命令 | 上游 | |------|------|------|---------|------| | superpowers 内 review skills | bundle 内纯 prompt | 流程型(请求/接收/收尾) | `/plugin install superpowers` | [obra/superpowers](https://github.com/obra/superpowers) | | `help-open-code-review` | standalone signpost | 外部 ocr 行级 AI review | `/plugin install help-open-code-review` | [alibaba/open-code-review](https://github.com/alibaba/open-code-review) | | `help-code-review-graph` | standalone signpost | 图谱辅助 review | `/plugin install help-code-review-graph` | [tirth8205/code-review-graph](https://github.com/tirth8205/code-review-graph) | **推荐**:流程纪律用 superpowers;要外部 AI 行级评论加 `help-open-code-review`。 ### 📈 产品 / 研究 | 选项 | 形态 | 说明 | 安装命令 | 上游 | |------|------|------|---------|------| | `last30days`(在 open-source bundle) | bundle 内纯 prompt | 跨多源 30 天趋势综述 | `/plugin install open-source` | [mvanhorn/last30days-skill](https://github.com/mvanhorn/last30days-skill) | | `help-pm-skills` | standalone signpost→上游 marketplace | 68 PM skill(PRD/OKR/路线图等) | `/plugin install help-pm-skills` | [phuryn/pm-skills](https://github.com/phuryn/pm-skills) | **推荐**:快速趋势综述 `/plugin install open-source`(含 last30days);重度 PM 工作流加 `help-pm-skills` 指路牌。 ### 🎛️ 增强体验 | 选项 | 形态 | 说明 | 安装命令 | 上游 | |------|------|------|---------|------| | `help-claude-hud` | standalone signpost | 状态栏 HUD(上下文/工具活动) | `/plugin install help-claude-hud` | [jarrodwatts/claude-hud](https://github.com/jarrodwatts/claude-hud) | | `help-prompt-optimizer` | standalone signpost | 3300+ 模板优化提示词 | `/plugin install help-prompt-optimizer` | [Thomaszhou22/prompt-optimizer-skill](https://github.com/Thomaszhou22/prompt-optimizer-skill) | **推荐**:要可视化状态 `/plugin install help-claude-hud`;常写提示词 `/plugin install help-prompt-optimizer`。 ### 🧭 技能发现 | 选项 | 说明 | 安装命令 | 上游 | |------|------|---------|------| | `help-find-skills` | standalone signpost→`npx skills` 搜社区技能 | `/plugin install help-find-skills` | [vercel-labs/skills](https://github.com/vercel-labs/skills) | 用于发现并安装更多社区 skill。 ## 推荐安装组合 | 场景 | 推荐安装 | |------|---------| | 个人开发者最小集 | `/plugin install common` | | 日常开发标准包 | `/plugin install common` + `/plugin install superpowers` | | + 工具增强 | 上面 + `/plugin install open-source` | | 软件部门(Qt/C++) | 上面 + `/plugin install software` | | 省 token | + `/plugin install help-caveman` 或 `help-headroom` | | 大代码库理解 | + `/plugin install help-codegraph`(token 优化)或 `help-understand-anything`(交互探索) | | 文档/网页处理 | + `help-markitdown` + `help-scrapling-skill` | | 状态栏监控 | + `/plugin install help-claude-hud` | | PM / 趋势研究 | + `/plugin install open-source`(含 last30days)+ `help-pm-skills` | | 全家桶 | 4 bundle 全装 + 按需单装 standalone signpost | | 跨平台同步 | 通过 `/sync-skills open-source` 整组同步(含 sync-skills 工具本身) | ## 从 v2.1.0 迁移 详见 [`docs/migration-v2.1-to-v2.2.md`](./docs/migration-v2.1-to-v2.2.md)。简要步骤: 1. `/plugin marketplace update linght-skills`(拉取 v2.2.0 marketplace.json) 2. 旧 open-source bundle(v2.1.0 含 10 skill)与新 open-source bundle(v2.2.0 含 4 skill)共存期间,建议卸载旧版重装:`/plugin uninstall open-source` → `/plugin install open-source` 3. 按需 `/plugin install ` 单装迁出的 skill(如 `/plugin install help-claude-hud`) ## 从 v2.0.0 迁移 先看 [`docs/migration-v2.0-to-v2.1.md`](./docs/migration-v2.0-to-v2.1.md),再看 v2.1→v2.2。 ## 从 v1.x 迁移 详见 [`docs/migration-plugin-to-bundle.md`](./docs/migration-plugin-to-bundle.md)。简要步骤: 1. 卸载旧 plugin(可选,不强制):`/plugin uninstall common`、`/plugin uninstall open-source` 等 2. 重新添加新 marketplace:`/plugin marketplace add https://gitee.com/linght/linght-skills.git` 3. 按需 `/plugin install ` 装所需的 bundle,或 `/plugin install ` 单装 ## 工程 - **lint**:`bash scripts/check-skill-names.sh` 校验所有 SKILL.md frontmatter `name` 与目录名一致(项目内部工具,不接 git pre-commit hook)。 - **OpenSpec 流程**:本仓库使用 OpenSpec + Comet 双星流程,所有变更都有 `openspec/changes//` 跟踪,归档后入 `openspec/changes/archive/`。 - **设计文档**:见 `docs/superpowers/specs/` 与 `docs/superpowers/plans/`。 - **本地校验**:`claude plugin validate ./linght-skills`(仅本地修改 marketplace 时使用)。 ## 历史 详见 `git log` 与 `openspec/changes/archive/` 归档目录。v1.x → v2.0.0 重构记录在 `feature/20260614/plugin-to-bundle-restructure` 分支;v2.0.0 → v2.1.0 迁移见 [`docs/migration-v2.0-to-v2.1.md`](./docs/migration-v2.0-to-v2.1.md);v2.1.0 → v2.2.0 迁移见 [`docs/migration-v2.1-to-v2.2.md`](./docs/migration-v2.1-to-v2.2.md)。v1.x 历史修正备忘已迁移至 [`docs/migration-plugin-to-bundle.md`](./docs/migration-plugin-to-bundle.md) 附录。 ## License 见 [LICENSE](./LICENSE)。