# SkillAll

**Repository Path**: weedd/skill-all

## Basic Information

- **Project Name**: SkillAll
- **Description**: 会合所有的技能库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-05
- **Last Updated**: 2026-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# skill-all — 统一 Skill 汇聚仓

本仓库是 **AI Agent 技能（skill）的统一汇聚与管理入口**，采用 **git 子模块** 架构。

> 仓库地址：`https://gitee.com/weedd/skill-all.git`

## 组织方式

```
skill-all/
├── README.md              # 本文件：总索引（含每个子 skill 的功能）
├── manifest.json          # 机器可读清单：自有 + 子仓全部技能（agents 读取入口）
├── .gitmodules            # 子模块清单（git 自动维护）
├── skills/                # ① 主仓自有技能区（个人积累，含 36 个技能）
│   └── learning/          #   学习技能包（建设中：入口+上下文原子已落地，蓝图见 BLUEPRINT.zh.md；project/ 为参考项目存档不收录）
├── subrepos/              # ② 子仓挂载点（submodule，承载项目依赖的技能）
│   ├── anthropics/        # → https://gitee.com/weedd/anthropics.git（19 个 Claude 技能）
│   ├── huxishu/           # → https://gitee.com/weedd/huxishu.git（1 个胡希恕经方临床技能）
│   ├── larkcli-skill/     # → https://gitee.com/weedd/larkcli-skill.git（28 个 lark 技能）
│   ├── lattice/           # → https://gitee.com/weedd/lattice.git（27 个工程/架构技能）
│   ├── ljg-skills/        # → https://gitee.com/weedd/ljg-skills.git（22 个认知/思维技能）
│   ├── Nanford-skills/    # → https://gitee.com/weedd/Nanford-skills.git（16 个个人工作流技能）
│   ├── nature-skills/     # → https://gitee.com/weedd/nature-skills.git（20 个科研/学术技能）
│   ├── nihaixia/          # → https://gitee.com/weedd/nihaixia.git（1 个倪海厦经方中医技能）
│   ├── pm-skills/         # → https://gitee.com/weedd/pm-skills.git（68 个 PM 技能 / 9 插件）
│   └── ui-ux-pro-max-skill/  # → https://gitee.com/weedd/ui-ux-pro-max-skill.git（7 个 UI/UX 设计技能）
└── scripts/
    ├── generate-manifest.py   # 扫描 skills/ + subrepos/ 重新生成 manifest.json
    └── link-skills.sh         # 预留：按需把技能分发到指定 agent 目录
```

三个层次：

1. **自有技能（`skills/`）** — 主仓直接 git 管理的技能区，由你个人积累、手动放入。放入新技能后运行 `python scripts/generate-manifest.py` 即纳入清单。
2. **子仓技能（`subrepos/`）** — 每个子仓一个独立 git 仓库，通过 submodule 挂载，承载**项目依赖**的技能（如 larkcli-skill 的飞书全套技能）。子仓按需求添加，技能内容在子仓内维护。
3. **统一清单（`manifest.json`）** — 机器可读，列出全部技能的名称、相对路径、描述与来源（`self` / `subrepo`）。不同 agent / 项目读取该文件即可发现并按需调用技能。

> 具体项目的 skill 组合配置（按 agent、按项目挑选技能子集）将在后续场景积累中逐步加入，当前不做。

---

## ① 主仓自有技能（`skills/`，个人积累）

### lark-knowledge-card（1 个技能）

个人积累技能，直接 git 管理 · 依赖 `lark-cli` 工具 · 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 |
|------|------|
| lark-knowledge-card | 飞书画板知识卡片绘制与 Obsidian 反写：知识库建节点、SVG 画板硬约束、文档插入、导出预览自查迭代、附件导出与 md 反写格式、系列卡片统一版式；含子代理上下文预算（坐标级规范派单）、PowerShell `@` 参数、导出字节为 JPEG 等实战坑位速查。 |

> 新技能放入 `skills/<name>/SKILL.md` 后，运行 `python scripts/generate-manifest.py` 并同步本节索引。

### learning 学习技能包（35 个技能 · 全量落地：1 入口 + 1 初始化 + 9 场景 + 21 原子 + 3 精炼器）

自研学习技能包：原子/分子/精炼器三层架构（借鉴 lattice），9 大学习场景全覆盖。**使用入口：[skills/learning/README.md](./skills/learning/README.md)**（什么是/三层级/学习生命周期/快速开始）；实战 FAQ 见 [docs/practical-guide.zh.md](./skills/learning/docs/practical-guide.zh.md)，`.learning/` 上下文层与配置参考见 [docs/context-layer.zh.md](./skills/learning/docs/context-layer.zh.md)。设计蓝图与完整技能清单（35 个：1 入口 + 1 初始化 + 9 场景 + 21 原子 + 3 精炼器）见 [skills/learning/BLUEPRINT.zh.md](./skills/learning/BLUEPRINT.zh.md)，21 个原子的设计初衷与学习科学原理见 [docs/atoms-rationale.zh.md](./skills/learning/docs/atoms-rationale.zh.md)；`skills/learning/project/` 为参考项目存档，**不作为技能收录**（manifest 已排除）。

**入口 + 上下文四原子（M1，自循环底座）：**

| 技能 | 功能 |
|------|------|
| learning-hub | 学习意图总入口：分流判定（9 场景决策树）→ 定位 `.learning/` 上下文层落点（跟随学习对象，fallback 当前目录）→ 路由移交场景技能；含目标技能缺失时的原子组合降级。 |
| learning-init | 显式初始化入口（对标 lattice-init）：`.learning/` 落点确认 → 已有则健康检查出摘要（绝不覆盖），没有则建骨架 → 按优先级推荐精炼器 → 命令速查。 |
| learning-atom-priming | 开场加载协议：读学习者画像/教学风格/场景规则 + **双向邻居检索**（出向 related + 入向反查，spontaneous 行为证据优先，预算 ≤9 篇裁剪），让教学从已理解的边缘开始。 |
| learning-atom-anchor | 主题活文档：Create/Load/Enrich 三行为；"已讲解"≠"已完成"两态登记；执行留痕 trace.md；术语前置登记；金句落盘需确认。 |
| learning-atom-harvest | 收尾收割：四类候选（三层笔记/跨主题经验/复习账本/仪表盘）逐条过确认门后写入；三层笔记只允许③观察→②模式单向晋升，永不从一次观察升级成画像。 |
| learning-atom-rule-iterate | 规则版本迭代：四触发器（同类错误≥2 次/方法失灵/明确纠偏/卡点≥3 轮）→ 最小 diff 提案 → 确认后写入 `.learning/standards/` 并升版本号（小调 v0.N/大调 vN.0）；只改个人规则，永不改技能文件。 |

**学习科学原子库（M2，17 个，可独立 `/` 调用）：**

| 类别 | 技能 | 功能 |
|------|------|------|
| 诊断 | learning-atom-diagnose | 选项化 5 问 + 场景直觉题摸底，一次一问不重复问，结果跨会话复用 |
| 诊断 | learning-atom-backcast | 从最终交付物倒推路线：产物定义 → 可检验验收标准 → 能力清单 → 模块序列 |
| 规划 | learning-atom-domain-map | 知识地图 10 节法：费曼解释/Top20 概念/依赖图/易混对/20-60-20/暂不学清单，活文档随学修订 |
| 规划 | learning-atom-min-viable | 最小可用知识集 ≤8 条，判据"少了它交付物做不出来"，暂不学带触发条件 |
| 讲解 | learning-atom-feynman | 动机→类比→直觉→定义四拍；类比纪律（代码/实物不类比，只类比抽象概念） |
| 讲解 | learning-atom-nonlinear | 反直觉核心切入：认知冲突勾住动机再回头补地基；零基础慎用 |
| 讲解 | learning-atom-multi-view | 三表征（文字/图例/反例）+ 概念五件套，防单一表征假懂 |
| 巩固 | learning-atom-recall | 两题制主动回忆（核心思想+场景应用），三档评分，0 对不推进 |
| 巩固 | learning-atom-spacing | 1/3/7/14/30 天账本调度，记对顺延记错回退，每日推送封顶 |
| 巩固 | learning-atom-interleave | 已学≥2 类后混合组卷（新:旧≈1:2）+ 辨析题，破分块假熟练 |
| 巩固 | learning-atom-elaborate | 精加工四型提问（机理/关联/迁移/对照），带降级阶梯不打审讯 |
| 实践 | learning-atom-scaffold | 支架四档旋钮（全示范→引导→教练→独立），成功降档卡壳升档；缺事实直接给事实 |
| 实践 | learning-atom-deliberate | 刻意练习：单靶小目标+逐题即时反馈+自动提速，结果回写账本 |
| 实践 | learning-atom-artifact | 每单元一件 ≤60 分钟产物 + 可勾选验收，非技术主题换形式 |
| 实践 | learning-atom-environment | 环境红线：禁猜环境信息 + 学习者动手不代劳 + 一次一命令四要素 |
| 反馈 | learning-atom-error-taxonomy | 错误四分类（概念缺失/不会应用/表达不清/知识混淆）对症补法，先归因再讲解 |
| 反馈 | learning-atom-confirm | 讲完≠学会：确认三式 + 三档判定 + 防自旋 + 金句落盘 |

**场景技能（M3，9 个，组合原子 + 场景专属机制）：**

| 场景 | 技能 | 功能 |
|------|------|------|
| S1 入门 | learning-new-domain | 诊断→反推→地图→最小集→逐单元「讲→验→练→测」循环，含时间少模式与跨场景移交 |
| S2 资料驱动 | learning-from-materials | 材料接地五步（登记/提取/索引/coverage/gap 三处置），材料为准不造页码，Supplemental 全标注 |
| S3 备考 | learning-exam-sprint | 考点树（权重×掌握率选点）+ 每日 5 题错因循环 + 考官模式模拟考 + 考试日倒排调度 |
| S4 做出来 | learning-build-thing | 单一项目载体 + 里程碑模块池（不确认不教学）+ 六步循环每模块必实跑 + 环境红线全程 |
| S5 面试 | learning-interview-sprint | 连环追问引擎（3-5 层不打断，轮末统一归因复盘）+ 项目场景化防背书 + 模拟面报告 |
| S6 速通 | learning-quick-concept | 无状态轻流程：钩子→四拍→三表征→一题回忆→三行速记，第 3 追问触发升级移交 |
| S7 长期 | learning-long-term | 多主题仪表盘 + 无缝续接（优先 needs_review）+ 跨主题连接（spontaneous 证据）+ 节奏画像 |
| S8 探索 | learning-explore | 情绪支持→兴趣三问（一次一个）→ 线索推方向（主选+备选）→ 试学手感后移交 S1 |
| S9 复习 | learning-review | 账本到期推送（封顶排序）→ 先回忆再对账 → 升档回退结算 + 错题变式重练 |

**精炼器（M4，3 个，产出个人标准 overlay 到原子默认）：**

| 精炼器 | 功能 |
|--------|------|
| learning-refiner-profile | 学习者画像访谈（预填+逐条核实）→ `standards/learner-profile.md`：背景/时间/目标风格/环境备注 |
| learning-refiner-scenario | 场景规则（先跑默认攒信号再校准）→ `standards/scenario-rules/<场景>.md`：按"原子.节"定位的个人覆盖 |
| learning-refiner-style | 教学风格（对比选样法，最多三组）→ `standards/teaching-style.md`：深度/类比密度/喂食量/纠错方式；①层约定优先 |

**质量保障（P0）**：`evals/`（hub 触发正反例 12 条 + 9 个场景行为契约各 2-3 条，跑法见 `evals/README.md`）+ `_shared/scripts/`（`validate_pack.py` 结构校验器：清单完整性/frontmatter/行数/内部引用；`learning_init.py` 一键初始化 `.learning/`，幂等不覆盖）。

**自循环闭环**：`priming`（开场读画像与规则）→ 场景技能教学（anchor 全程登记）→ `harvest`（收尾四类收割，确认后写入）→ `rule-iterate`（四触发器提议规则修订升版本）→ 下次 `priming` 读到新规则生效。技能文件是基座永不改，`.learning/` 上下文层越用越懂你。

## ② 子模块技能（`subrepos/`，项目依赖）

### larkcli-skill（28 个技能）

来源：`https://gitee.com/weedd/larkcli-skill.git` · 依赖 `lark-cli` 工具 · 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 |
|------|------|
| lark-approval | 飞书审批：查询/处理审批待办、已办、实例；搜索并发起审批定义、查看详情、发起原生审批实例。 |
| lark-apps | 妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地/云端全栈开发、创意设计（mockup/原型/线框/落地页/仪表盘/PPT）、AI 与外部能力集成、日志/监控、环境变量、权限与自动化触发器。 |
| lark-attendance | 飞书考勤打卡：查询自己的考勤打卡记录。 |
| lark-base | 飞书多维表格（Base）：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式、Workflow、角色权限、模板中心。 |
| lark-calendar | 飞书日历：查看/搜索/创建/更新日程、管理参会人、查询忙闲与推荐时段、预定会议室。 |
| lark-contact | 飞书通讯录：按姓名/邮箱解析 open_id 或反查信息，按关键词搜索可见机器人/智能体。 |
| lark-doc | 飞书云文档（Docx/Wiki）：读取、创建、编辑文档，插入/下载图片，操作思维笔记。 |
| lark-drive | 飞书云空间：文件/文件夹管理（上传下载、创建、复制移动删除、元数据、权限、版本），导入 Word/Markdown/Excel/CSV/PPTX 等。 |
| lark-event | Lark 实时事件监听/订阅/消费：以 NDJSON 流式消费 IM/审批/任务/会议等事件，用于机器人、长驻订阅、流式回调。 |
| lark-im | 飞书即时通讯：收发消息、管理群聊、搜索记录、上传下载文件、表情回复、加急、交互卡片及卡片回调。 |
| lark-mail | 飞书邮箱：起草、发送/回复/转发、搜索、文件夹/标签/联系人、监听新邮件、收信规则。 |
| lark-markdown | 飞书原生 Markdown 文件：查看、创建、上传、编辑、比较远端与本地草稿。 |
| lark-meeting | 飞书视频会议：会议记录/纪要/逐字稿/妙记的搜索上传下载编辑、机器人参会、实时会议内容问答与会中互动。 |
| lark-minutes | 委托技能：仅当显式指定时使用，请求统一转交 lark-meeting。 |
| lark-note | 委托技能：仅当显式指定时使用，请求统一转交 lark-meeting。 |
| lark-okr | 飞书 OKR：管理周期、目标、关键结果、对齐关系、量化指标与进展记录。 |
| lark-openapi-explorer | 飞书原生 OpenAPI 探索：从官方文档挖掘未被 CLI 封装的原生接口并调用。 |
| lark-shared | lark-cli 设置/鉴权：auth login/status/logout、用户与机器人身份、业务域权限、缺失 scope 处理。 |
| lark-sheets | 飞书电子表格：建表、工作表/行列管理、单元格读写、查找替换、批量更新、图表、透视表、公式计算、财务建模。 |
| lark-skill-maker | 创建 lark-cli 自定义 Skill：把飞书 API 操作封装成可复用技能（包装原子 API 或编排多步流程）。 |
| lark-slides | 飞书幻灯片：创建/编辑演示文稿、读取内容、管理页面（创建删除读取局部替换）。 |
| lark-task | 飞书任务：创建/查看/更新待办、拆分子任务、组织清单、分配成员、上传附件、注册注销任务智能体。 |
| lark-vc | 委托技能：仅当显式指定时使用，请求统一转交 lark-meeting。 |
| lark-vc-agent | 委托技能：仅当显式指定时使用，请求统一转交 lark-meeting。 |
| lark-whiteboard | 飞书画板对象操作（云文档内的独立画板）。 |
| lark-wiki | 飞书知识库：管理知识空间、成员、节点层级、组织文档与快捷方式。 |
| lark-workflow-meeting-summary | 会议纪要整理工作流：汇总指定时间范围会议纪要并生成结构化报告。 |
| lark-workflow-standup-report | 日程待办摘要：编排 calendar + task 生成指定日期的日程与未完成任务摘要。 |

### lattice（27 个技能）

来源：`https://gitee.com/weedd/lattice.git`（工程/架构研发技能体系：需求、设计、编码、评审、重构、测试全链路）· 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 |
|------|------|
| architecture | 软件架构设计与权衡：组件边界、模块划分、架构风格选型与演进。 |
| architecture-compass | 架构方向引导：澄清目标、约束与取舍，输出架构决策。 |
| architecture-refiner | 架构方案精化：把粗粒度架构方案打磨成可落地设计。 |
| bug-fix | 缺陷定位与修复：复现、根因分析、最小化修复、回归验证。 |
| clean-code | 整洁代码实践：命名、函数、注释、代码结构与可读性。 |
| clean-code-refiner | 代码整洁度精化：对现有代码做可读性/结构打磨。 |
| code-forge | 编码实施：按设计产出实现代码，覆盖常见语言的工程化写法。 |
| collaborative-judgment | 协作判断：复杂取舍下的多方权衡与决策记录。 |
| context-anchoring | 上下文锚定：长对话/长任务中的上下文管理与关键信息钉扎。 |
| ddd-refiner | DDD 设计精化：领域模型、限界上下文、聚合与领域服务。 |
| design-blueprint | 设计蓝图：把需求/方案转成可实施的实现蓝图。 |
| design-first | 设计先行：动手编码前先完成设计并固化。 |
| domain-driven-design | 领域驱动设计：战术/战略建模、事件风暴与演进。 |
| knowledge-priming | 知识预热：任务开始前补齐/对齐相关领域知识。 |
| knowledge-priming-refiner | 知识预热精化：把已有资料整理成可用任务上下文。 |
| language-idioms-refiner | 语言惯用法精化：让代码符合目标语言的惯用风格。 |
| lattice-init | Lattice 工作台初始化：仓库/项目/技能栈的启动引导。 |
| learning-harvest | 学习收割：从一次任务/会话中提炼可复用经验。 |
| refactor-safely | 安全重构：小步重构、行为不变、测试护航。 |
| refiners-update | 精化器更新：对 refiner 系列技能的迭代维护。 |
| requirement-forge | 需求锻造：把模糊诉求打磨成清晰、可验收的需求。 |
| requirement-forge-refiner | 需求精化：拆分、澄清、去歧义并形成需求文档。 |
| requirement-quality | 需求质量检查：完整性、可测性、优先级与边界。 |
| review | 代码评审：变更审查、缺陷识别与改进建议。 |
| review-refiner | 评审精化：把评审意见整理成可执行修改清单。 |
| secure-coding | 安全编码：输入校验、注入防护、敏感信息处理等。 |
| test-quality | 测试质量：用例设计、覆盖率导向与测试维护。 |

### anthropics（19 个技能）

来源：`https://gitee.com/weedd/anthropics.git`（Anthropic 官方 Skills 仓库）· 覆盖创意/设计、开发/技术、企业沟通与文档处理 · 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 |
|------|------|
| academy-guide | Claude Academy 学习路径推荐：回答 Claude 产品使用方法类问题时，匹配并推荐官网课程、教程与用例。 |
| algorithmic-art | 用 p5.js + 种子随机数生成算法艺术：流场、粒子系统等生成式/创意编码，注重原创避免照搬他人作品。 |
| brand-guidelines | 应用 Anthropic 官方品牌色板与字体，为需要企业视觉风格的产物套用规范外观。 |
| canvas-design | 用设计理念创作 .png/.pdf 静态视觉作品（海报、插画、设计稿），坚持原创设计避免侵权。 |
| claude-api | Claude API / Anthropic SDK 参考：模型 id、定价、参数、流式、工具调用、MCP、缓存、token 计数与模型迁移。 |
| discernment-nudge | 在给出可被采纳的答复或草稿后，追加 2-3 个针对关键事实、推理与缺失上下文的追问，帮助用户核实判断。 |
| doc-coauthoring | 文档协作写作工作流：提案、技术规格、决策文档等结构化内容的上下文迁移、迭代打磨与校验。 |
| docx | 创建/读取/编辑/操作 Word 文档（.docx/.dotx）：目录、表格、专业排版等。 |
| frontend-design | 新 UI 或改版 UI 的视觉设计指导：美学方向、排版，避免千篇一律的模板化默认样式。 |
| internal-comms | 撰写内部通讯（状态报告、管理层更新、公司通讯、FAQ、事故报告等），按公司惯用格式输出。 |
| mcp-builder | 高质量 MCP Server 开发指南：Python(FastMCP) / Node(TypeScript SDK)，连接外部服务、设计良好工具。 |
| pdf | PDF 全能处理：读取/提取文本表格、合并拆分、旋转、水印、创建、表单填写、加解密、抽取内容。 |
| pptx | PowerPoint 全套操作：创建/读取/提取幻灯片、制作 Pitch/演示文稿（.pptx/.potx）。 |
| skill-creator | 创建、修改与评估 skill：从零建技能、优化描述、跑 eval 评测并做方差分析。 |
| slack-gif-creator | 面向 Slack 的动图（GIF）制作：约束校验、验证工具与动画设计概念。 |
| theme-factory | 产物主题样式工具包：10 套预设主题（配色/字体）可套用到幻灯片、文档、报告、HTML 落地页等，也可即时生成新主题。 |
| web-artifacts-builder | 用 React/Tailwind/shadcn 构建复杂的 claude.ai HTML 产物：状态管理、路由、多组件。 |
| webapp-testing | 基于 Playwright 的本地 Web 应用测试：验证前端功能、调试 UI 行为、截图、查看浏览器日志。 |
| xlsx | 电子表格操作：打开/读取/编辑/修复 .xlsx/.xlsm/.xltx/.csv/.tsv，列增删、公式计算、格式化、图表、清理脏数据。 |

### pm-skills（68 个技能）

来源：`https://gitee.com/weedd/pm-skills.git`（PM Skills Marketplace：产品经理技能市场，9 个插件覆盖发现/策略/执行/上市/增长/数据分析/交付）· 完整清单见 [manifest.json](./manifest.json)

#### pm-ai-shipping（2 个技能）

| 技能 | 功能 |
|------|------|
| intended-vs-implemented | 意图-实现差距分析：找出系统应做与代码实际行为之间的差异，捕捉通用扫描器遗漏的意图类缺陷。 |
| shipping-artifacts | AI 构建（vibe-code）应用交付前文档集：架构、用户/权限流、变量/密钥、测试覆盖地图等可审查文档。 |

#### pm-data-analytics（3 个技能）

| 技能 | 功能 |
|------|------|
| ab-test-analysis | A/B 测试结果分析：统计显著性、样本量校验、置信区间与上线/扩展/停止建议。 |
| cohort-analysis | 队列分析：留存曲线、功能采用趋势与分群洞察。 |
| sql-queries | 自然语言生成 SQL：支持 BigQuery/PostgreSQL/MySQL 等方言，读取数据库 schema。 |

#### pm-execution（16 个技能）

| 技能 | 功能 |
|------|------|
| brainstorm-okrs | 头脑风暴团队 OKR：定性目标+可量化关键结果，与公司目标对齐。 |
| create-prd | 撰写 PRD：8 段式模板覆盖问题、目标、客群、价值主张、方案与发布规划。 |
| dummy-dataset | 生成仿真假数据集：可定制列、约束与输出格式（CSV/JSON/SQL/Python）。 |
| job-stories | 撰写 Job Story："当…我想…以便…"格式+验收标准（JTBD 风格）。 |
| outcome-roadmap | 输出导向路线图转成果导向：把功能清单改写为反映用户/业务影响的成果陈述。 |
| pre-mortem | 事前验尸：对 PRD/发布计划做风险分析（老虎/纸老虎/大象三类风险分类）。 |
| prioritization-frameworks | 9 种优先级框架参考：RICE、ICE、Kano、MoSCoW、机会评分等公式与适用场景。 |
| release-notes | 从工单/PRD/变更日志生成用户向发布说明，按新功能/改进/修复分类。 |
| retro | 结构化迭代回顾：做得好的/不足的+带负责人与期限的优先行动项。 |
| sprint-plan | 冲刺规划：容量估算、故事选择、依赖映射与风险识别。 |
| stakeholder-map | 干系人地图：权力/利益四象限、各象限沟通策略与沟通计划。 |
| strategy-red-team | 策略红队：攻击 PRD/路线图/策略的承重假设，按影响×可能性×验证成本排序并给出最便宜测试与终止标准。 |
| summarize-meeting | 会议纪要：从转写生成含日期、参会人、主题、关键决策、摘要与行动项的结构化记录。 |
| test-scenarios | 从用户故事生成测试场景：测试目标、前置条件、角色、步骤与预期结果。 |
| user-stories | 用户故事：3C（卡片/对话/确认）+INVEST 标准，含描述、设计链接与验收标准。 |
| wwas | Why-What-Acceptance 格式的待办项：独立、有价值、可测试并带战略背景。 |

#### pm-go-to-market（6 个技能）

| 技能 | 功能 |
|------|------|
| beachhead-segment | 滩头市场选择：按痛点强度、支付意愿、可赢份额与推荐潜力评估首个目标细分。 |
| competitive-battlecard | 销售竞争战斗卡：与指定竞品对比的定位、功能对比、异议处理与胜负模式。 |
| growth-loops | 增长飞轮识别：病毒、使用、协作、UGC、推荐 5 类循环评估。 |
| gtm-motions | GTM 打法选择：Inbound/Outbound/付费/社区/伙伴/ABM/PLG 7 种打法与工具。 |
| gtm-strategy | 制定上市策略：营销渠道、信息传达、成功指标与发布时间线。 |
| ideal-customer-profile | 理想客户画像（ICP）：人口学、行为、JTBD 与需求分析。 |

#### pm-market-research（7 个技能）

| 技能 | 功能 |
|------|------|
| competitor-analysis | 竞品分析：优劣势与差异化机会，识别直接竞品并绘制竞争格局。 |
| customer-journey-map | 端到端客户旅程图：阶段、触点、情绪、痛点与机会点。 |
| market-segments | 识别 3-5 个潜在客群：人口学、JTBD 与产品契合度分析。 |
| market-sizing | 市场规模估算：TAM/SAM/SOM，自顶向下与自底向上两种方法。 |
| sentiment-analysis | 用户反馈情感分析：分群情感分、JTBD 与满意度洞察。 |
| user-personas | 用户画像：基于调研数据产出 3 个含 JTBD、痛点、收益与意外洞察的画像。 |
| user-segmentation | 用户分群：按行为、JTBD 与需求从反馈数据中切分至少 3 个不同客群。 |

#### pm-marketing-growth（5 个技能）

| 技能 | 功能 |
|------|------|
| marketing-ideas | 生成 5 个有创意、低成本的营销点子：渠道、信息与互动逻辑。 |
| north-star-metric | 北极星指标：定义北极星+3-5 个输入指标星座，按 7 条标准校验并分类业务游戏类型。 |
| positioning-ideas | 差异化定位头脑风暴：识别头部竞品并生成带理由的定位陈述。 |
| product-name | 产品命名：5 个独特易记的名字，对齐品牌价值与目标受众。 |
| value-prop-statements | 价值主张陈述：为营销、销售与 onboarding 生成价值主张文案。 |

#### pm-product-discovery（13 个技能）

| 技能 | 功能 |
|------|------|
| analyze-feature-requests | 功能请求分析与排序：按主题、战略对齐、影响、成本与风险梳理。 |
| brainstorm-experiments-existing | 存量产品假设实验设计：原型、A/B 测试、spike 等低成本验证方法。 |
| brainstorm-experiments-new | 新产品精益实验（pretotype）：XYZ 假设+落地页、讲解视频、预售等低成本验证。 |
| brainstorm-ideas-existing | 存量产品创意头脑风暴：PM/设计师/工程师多视角发散。 |
| brainstorm-ideas-new | 新产品发现期创意头脑风暴：三个视角探索功能想法。 |
| identify-assumptions-existing | 存量功能高风险假设识别：价值/可用性/可行性/生存能力四维+多视角魔鬼代言人。 |
| identify-assumptions-new | 新产品高风险假设识别：含 GTM、战略、团队在内 8 类风险。 |
| interview-script | 用户访谈脚本：JTBD 探询问题，遵循 The Mom Test 原则（不引导、不推销、聚焦过去行为）。 |
| metrics-dashboard | 指标看板设计：关键指标、数据源、可视化类型与告警阈值。 |
| opportunity-solution-tree | 机会-方案树（OST）：把期望成果映射到机会、方案与实验（Teresa Torres 持续发现习惯）。 |
| prioritize-assumptions | 假设排序：影响×风险矩阵+每项建议实验。 |
| prioritize-features | 功能优先级：按影响、成本、风险与战略对齐排序并给 Top5 建议。 |
| summarize-interview | 访谈纪要：结构化模板含 JTBD、满意度信号与行动项。 |

#### pm-product-strategy（12 个技能）

| 技能 | 功能 |
|------|------|
| ansoff-matrix | 安索夫矩阵：市场渗透/市场开发/产品开发/多元化四象限增长战略。 |
| business-model | 商业模型画布：9 大模块完整生成。 |
| lean-canvas | 精益画布：问题、方案、指标、成本结构、UVP、不公平优势、渠道、客群与收入。 |
| monetization-strategy | 变现策略：3-5 个方案含受众契合度、风险与验证实验。 |
| pestle-analysis | PESTLE 分析：政治、经济、社会、技术、法律、环境六维宏观环境评估。 |
| porters-five-forces | 波特五力：竞争对抗、供应商/买方议价力、替代品威胁与新进入者威胁。 |
| pricing-strategy | 定价策略：定价模型、竞品定价分析、支付意愿估算与价格弹性。 |
| product-strategy | 产品战略画布：9 段式覆盖愿景、客群、成本、价值主张、取舍、指标、增长、能力与防御性。 |
| product-vision | 产品愿景：激发团队、对齐干系人的鼓舞人心且可实现的情感化愿景。 |
| startup-canvas | 创业画布：产品战略（9 段）+商业模式（成本+收入）合一，替代 BMC/Lean Canvas。 |
| swot-analysis | SWOT 分析：优势、劣势、机会、威胁+可执行建议。 |
| value-proposition | 价值主张设计：6 部分 JTBD 模板（谁/为什么/之前做什么/怎么做/之后怎样/替代方案）。 |

#### pm-toolkit（4 个技能）

| 技能 | 功能 |
|------|------|
| draft-nda | 起草 NDA 保密协议：信息类型、管辖地与需法务审核的条款。 |
| grammar-check | 语法/逻辑/行文检查：定位错误并给出针对性修改建议。 |
| privacy-policy | 起草隐私政策：数据类型、管辖地、GDPR 与合规考量、需法务审核条款。 |
| review-resume | PM 简历评审与定制：10 项最佳实践（XYZ+S 公式、关键词优化、按岗位定制、结构）。 |

### ui-ux-pro-max-skill（7 个技能）

来源：`https://gitee.com/weedd/ui-ux-pro-max-skill.git`（UI/UX Pro Max：跨平台/框架的 UI/UX 设计智能，含 79 种 UI 风格、192 配色、74 字体配对、119 UX 指南、25 图表类型，覆盖 22 技术栈）· 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 |
|------|------|
| ui-ux-pro-max | UI/UX 设计智能总入口：设计/构建/审查/修复界面（页面、组件、设计系统、可访问性、交互、响应式、排版、配色、图表、栈特定 UI 实现）。 |
| design | 综合设计技能：品牌识别、设计令牌、UI 样式、Logo 生成（55 风格）、企业形象计划（CIP 50 交付物）、HTML 演示文稿（Chart.js）、Banner 设计（22 风格）、图标设计（15 风格）。 |
| design-system | 设计系统：三层令牌架构（primitive→semantic→component）、CSS 变量、间距/排版刻度、组件规格、品牌合规演示文稿。 |
| ui-styling | 用 shadcn/ui（Radix UI + Tailwind）、Tailwind 工具类、Canvas 视觉设计构建美观且可访问的界面。 |
| brand | 品牌：品牌声音、视觉识别、信息传达框架、资产管理与一致性；品牌内容/语气/营销资产/合规/风格指南时启用。 |
| slides | 战略型 HTML 演示文稿：Chart.js、设计令牌、响应式布局、文案公式与上下文化幻灯片策略。 |
| banner-design | 多场景 Banner 设计：社媒/广告/网站 Hero/印刷；多艺术方向，支持生成或提供视觉素材。 |

### ljg-skills（22 个技能）

来源：`https://gitee.com/weedd/ljg-skills.git`（ljigang 个人 Codex 自定义技能集：认知/思维/写作/阅读工具，`ljg-*` 前缀）· 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 | 适用场景（触发词/时机） |
|------|------|------|
| ljg-blind | 盲区扫描：读昨天与 AI 的对话照出思维盲区，从微信读书选一章精准补上，落成分析笔记。 | 说「扫盲区/盲区/照盲区/我昨天想漏了什么」；想复盘与 AI 的对话找思维盲区 |
| ljg-think | 追本：纵向深钻一个观点/现象到不可再分的本质。 | 说「想透/追本/本质是什么/为什么会这样/深挖/钻到底」；想要深度而非广度 |
| ljg-is | 概念理解：把名词/概念写成可用的理解——是什么、与相邻概念差在哪、如何运作、行动抓手。 | 问 X 是什么/怎么理解/意味着什么/以后怎样判断；理解技术概念、制度、方法 |
| ljg-learn | 概念解剖：8 维深挖（历史/辩证/现象学/语言学/形式化/存在主义/美学/元哲学）压缩成洞察。 | 要求解释/解剖/彻底理解一个概念；概念很难且想榨出洞见 |
| ljg-constraint | 约束分析：找出真正框住领域/专业/角色/产品的几条约束（世界/规则/自设），解释行为与方案分歧。 | 说「约束/找约束/本质约束/硬约束还是自设约束/边界在哪/这行为什么这么做」 |
| ljg-rank | 降秩：找出领域背后真正撑着它的几根独立"力"，砍到不可再少的生成器。 | 说「降秩/找秩/秩是什么/这个领域靠什么撑着/背后是什么」 |
| ljg-structure | 结构风洞：找信息母题级结构，抽象关系展开回具体现象，风洞检验因果与边界。 | 说「找结构/母题是什么/结构风洞/背后的结构」；想看穿问题底下的生成机制 |
| ljg-roundtable | 圆桌讨论：3-5 位真实人物多视角交锋，每轮 ASCII 结构图，用户控节奏，散场存 org 笔记。 | 说「圆桌讨论/圆桌/辩论」；想通过多视角结构化辩论探索议题 |
| ljg-qa | 信息提问：把文章/论文/书的核心观点抽成 Q-A 对，Q 切要害、A 简洁有形式化收口。 | 说「问答/QA/提问/抽取问题」；读完后想验证自己是否真读懂 |
| ljg-plain | 白话改写：把任意内容改写成聪明 12 岁孩子能懂的话，无结构框架，形式随内容。 | 说「白话说/说人话/解释一下/plain/grok」；内容太绕要降维 |
| ljg-book | 整本讲书：无需专业背景地讲透一本书——脉络、主线关联、落点、证据如何改变认知。 | 给书名/PDF/EPUB/摘录；想把整本书讲透（有具体内容才算，泛泛道理不算） |
| ljg-paper | 论文讲解：无专业背景地讲透论文——研究什么、贡献什么、结论如何得出、证据没证明什么。 | 给 arXiv 链接/论文 URL/PDF/标题；想读懂一篇学术论文 |
| ljg-read | 伴读：陪伴读任何文本，翻译（英译中信达雅）、结构注解、深度提问与跨域洞察。 | 给任意文本（书/文章/论文/新闻）；想有人陪读+翻译+注解+深问 |
| ljg-writes | 写作引擎：把一个观点写成可理解、可迁移、经得住反例的 1000-1500 字中文文章。 | 写文章/优化思想内容/展开观点/改写成逻辑递进的中文 |
| ljg-card | 内容铸卡：把文字经精确 HTML 排版铸成 PNG 卡片，四种模具（长读卡/原文全文/漫画/白板）。 | 说「铸/做成图/做成卡片/做成海报/原文排版/全文卡片」 |
| ljg-classic | 古文注解：文言文逐字注、组合排版、章节意旨图与全章解读，排成可读长 PNG。 | 文言文/古诗文/经史子集逐字注解、章节解读、古文讲义图、章节配图 |
| ljg-present | 演讲铸造：把 outline 1:1 铸成单文件离线 HTML 演讲，一页一语义动作、多种主题。 | 说「讲这个/present/做成演讲/slides/标语流/按 outline 美化」；不做内容提炼或企业 PPT |
| ljg-teach | 情境教学：用体验而非定义教授——给局面→选择→意外显化认知缺口→结构化命名→迁移复测。 | 说「用情境教我/别先讲答案/通过案例让我学会」；想通过选择与反馈学会 |
| ljg-word | 单词深挖：单个英文单词的核心语义解构与洞察。 | 要求解释/掌握某个英文单词 |
| ljg-invest | 投资分析：给项目写深度投资报告，核心判断=是不是一台「秩序创造机器」。 | 说「投资报告/投资分析/分析这个项目」；给 BP/创始人对话要投资评估 |
| ljg-relationship | 关系分析：5 层结构诊断 + 精神分析深度（移情、无意识模式、阻抗）看穿关系结构。 | 说「关系分析/分析关系/人际关系」；想通过对话看清关系结构 |
| ljg-push | 技能同步：把 ~/.agents/skills/ljg-* 更新过的技能同步推送（master org 风格 + md 分支 markdown 化）。 | 说「/ljg-push/push skills/同步 skills」；ljg-* 技能更新后要发布 |

### huxishu（1 个技能）

来源：`https://gitee.com/weedd/huxishu.git`（胡希恕·经方临床：将胡希恕的经方思维体系注入 AI Agent——六经来自八纲、方证是辨证的尖端、正邪交争、胃气为本；伤寒论 398 条全 + 金匮要略 22 篇 + 六经辨证诊断公式 16 个 + 方证鉴别速查 + 饮食调理思维模型 8 个 + 胡老核心讲稿 38 万字，基于《伤寒论》《金匮要略》讲座完整讲稿）· 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 | 适用场景（触发词/时机） |
|------|------|------|
| huxishu | 胡希恕经方临床思维技能：以六经八纲辨证、方证对应、正邪交争为主的决策启发式（发热恶寒辨阴阳、有汗桂麻、但见一证便是柴胡证、承气三阶、排除法辨半表半里）；回答以胡老口语风格开场（「咱们讲……」「你看啊」+ 设问 + 断言收束），禁忌八股腔/五行玄谈。 | 说「胡希恕/胡老/经方胡希恕/六经八纲/胡希恕怎么看/方证对应/伤寒论胡希恕」；经方辨证、方证鉴别、经方选药 |

### nihaixia（1 个技能）

来源：`https://gitee.com/weedd/nihaixia.git`（倪海厦经方中医 AI：将倪海厦的中医思维体系注入 AI Agent——129 条伤寒论、23 篇金匮、72 篇黄帝内经、神农本草经 374 种本草、1257 例结构化医案 + 243 例叙事医案、2452 页讲义、3.5M 字精萃；以六经辨证/经方为主的心智模型）· 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 | 适用场景（触发词/时机） |
|------|------|------|
| nihaixia | 倪海厦经方中医思维技能：以六经辨证、阳气论、经方为主的决策启发式（先辨六经再选方、阳气不足先扶阳、经典原方最可靠），含六经辨证诊断公式、快速诊断流程图、脉舌速查、合病并病速查、真寒假热鉴别、七步走思维模式；回答以倪师口语风格开场。 | 说「倪海厦/海厦视角/倪师/经方思维/倪海厦会怎么看」；中医六经辨证、经方选药、解读症状 |

### Nanford-skills（16 个技能）

来源：`https://gitee.com/weedd/Nanford-skills.git`（Nanford 个人高频工作流 Skill 资产仓：将日常可复用、可交付的工作流整理为结构化 Skill，覆盖内容创作/办公效率/业务实战/工业自动化）· 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 | 适用场景（触发词/时机） |
|------|------|------|
| ai-news-scout | AI 领域信息差日报：3 批并行搜索采集全网 AI 新闻，筛选去重后输出精炼日报。 | 说「搜集AI新闻/AI信息差/今日AI动态/AI日报/AI周报/信息差选题」 |
| viral-article-analyzer | 公众号爆款文章深度拆解：爆款逻辑、写作结构、情绪技巧、金句与说服策略、标题公式、互动钩子。 | 说「拆解文章/分析爆款/公众号爆款/为什么这篇文章火/学习写法」；给文章链接或粘贴内容 |
| wechat-article-operator | 公众号内容生产全流程：选题评估、读者锚定、结构选型、正文写作、传播元素植入、排版发布衔接。 | 说「公众号爆文/帮我写篇公众号/把这篇稿子改爆/写得更有传播力/加互动钩子」 |
| article-to-ppt-outline | 长文档/教材/文章 → 带视觉排版建议 + 讲师口语化逐字稿的结构化 PPT 大纲。 | 快速备课、制作汇报演示文稿；给长文本要 PPT/大纲 |
| hootoolai-ppt | 生成高可读、强叙事、网页化展示的 HTML 演示文稿（index.html + assets，可直接浏览器演示）。 | 说「生成PPT/做演示文稿/创建幻灯片/presentation/汇报材料/slides」 |
| text-to-ppt-pro | 专业 PPT 执行层：结构化大纲 → 可编辑 .pptx（13 种标准页型、4 套主题、备注区写入、自动质检）。 | 说「帮我做PPT/把这段内容转成幻灯片/做培训课件/做方案PPT」 |
| svg-architecture-diagram | 架构文字描述 → 专业 SVG 信息架构图（架构图/流程图/数据流图/业务流程图）。 | 说「画架构图/生成系统图/可视化架构/画流程图/组织结构图」；主动替代 Mermaid |
| prototype-orchestrator-pro | 口语化需求/会议纪要/聊天记录 → 可交互单文件 HTML 产品原型（先归一需求，再出 ProductSpec+页面方案）。 | 说「帮我做原型/把需求变成界面/根据会议纪要出后台页面/做个低保真中保真页面」 |
| bid-document-builder | 招标文件智能编排：复制 Word 母文件原位改编（保留章节表格/封面/页眉页脚），Excel 数据映射复算，变量标红+全域审计。 | 编制/重制/套版招标文件、标书、采购文件、磋商文件 |
| bid-preparation | 标书响应文件制作：解析招标文件、匹配公司资料、生成商务+技术响应并组装成品 DOCX。 | 说「投标/标书/响应文件/应标/招标文件分析/制作标书/解标/偏离表」 |
| ecom-listing | 商品事实整理 → 平台/本地化文案 + 7 张以上套图规划（Amazon/eBay/Temu）。 | 分析商品、提炼卖点、生成电商文案、套图规划 |
| ecom-image | 批量生成无文字电商底图 + 确定性文字图层合成套图（Codex ImageGen/Qwen Image/Nano Banana/Seedream）。 | 正式出图、切换图片 API、继续套图生成、批量渲染、替换文案复用底图 |
| ecom-publish | 发布前质检：站点字符限制、禁用词、事实泄漏、图文一致性、图片尺寸、套图完整性；导出平台刊登 CSV。 | 检查 Listing 合规、验收套图、修复阻断问题、导出刊登文件 |
| hubei-subsidy-tracker | 湖北/武汉惠企政策采集 → 按企业档案匹配申报机会 → 核对草稿 + 飞书/钉钉协作（不自动提交申报）。 | 企业补贴查询、企业档案匹配、通知接入、运行故障恢复 |
| plc-station-db-mapper | 西门子 PLC 站台化点位映射：4 种输入（DB 截图/PDF/Excel/手动）→ 统一 Excel → 批量生成目标站台点位表。 | Task/Alarm/State 等点位扩展、补表、续表 |
| minimal_narrative_sketch_scenes_skill | 极简手绘叙事场景插画：松散动作小场景、强留白、俏皮手势、多样叙事结构。 | 围绕任意主题生成手绘风叙事插画 |

### nature-skills（20 个技能）

来源：`https://gitee.com/weedd/nature-skills.git`（Nature Skills：面向全球学者的科研 Skill 库——文献检索/论文写作/润色翻译/审稿返修/科研绘图/PPT 汇报全流程，Apache-2.0）· 完整清单见 [manifest.json](./manifest.json)

| 技能 | 功能 | 适用场景（触发词/时机） |
|------|------|------|
| nature-academic-search | 跨来源文献检索、引文核对/管理、MeSH 策略与引文影响审计（严格他引/citer profiles）。 | 文献检索、引文核对、参考文献管理、严格他引 |
| nature-citation | 查找并验证 Nature/CNS 系列支撑文献：声明→来源映射 + 文献管理工具导出。 | Nature 系列引用、CNS 支撑文献、分段补引用 |
| nature-literature-pipeline | 全自动文献发现流水线：多源检索→六维评分→精读→格式化交付→归档；可配置引擎 + 定时任务（飞书/Telegram）。 | 周期性文献追踪、自动文献推送 |
| nature-paper-card | 单篇论文结构化精读卡：方法拆解、实验→结论证据链分析、局限与研究想法。 | 论文精读卡、方法拆解、证据链分析 |
| nature-reader | 生成带来源对照的中英对照论文精读（对齐文本/图/表/公式）。 | 全文翻译、中英文对照、论文精读、来源溯源提问 |
| nature-writing | 论文写作/论证重构：章节起草、论证组织、首次投稿材料。 | 论文写作、章节起草、论证重构、正文压缩、首次投稿 |
| nature-polishing | 润色/翻译/精简现有学术文字，保留事实、术语与证据边界；含 LaTeX 排版修正。 | 论文润色、学术翻译、正文精简 |
| nature-reviewer | 基于证据的模拟同行评审：显著性、有效性、主要/次要问题。 | 模拟审稿、投稿前自审、审稿人视角评估 |
| nature-response | 审稿意见逐点回复、返修信、带标注稿件/LaTeX 返修包。 | 审稿意见回复、逐点回复、返修信、rebuttal |
| nature-statistics | 稿件统计报告审计：实验单元、重复、不确定性、检验、图注统计。 | 统计审查、统计方法小节、图注统计 |
| nature-data | 数据/代码可用性声明起草与审计、数据仓库选择、FAIR 元数据。 | 数据可用性声明、数据共享、数据仓库选择 |
| nature-figure | 用 Python/R 创建/修订/审计/导出稿件科学配图（多面板图、投稿级图）。 | 论文配图、科研绘图、多面板图、AI 图解摘要 |
| nature-downloader | 合法学术全文获取：CNKI 机构访问、英文 OA 检索、出版社 API、机构浏览器回退、补充材料下载。 | 学术全文获取、CNKI、OA 下载、补充材料 |
| nature-ref-verifier | 参考文献多源交叉验证：逐字段对比作者/标题/年份/卷期/页码，标记冲突与异常，输出结构化报告，可批量 + Zotero 同步。 | 参考文献校验、卷年/DOI 冲突、Zotero 修正 |
| nature-paper2ppt | 论文/精读笔记 → 中文学术 PPTX（带原图与演讲备注）。 | 论文做PPT、文献汇报、组会PPT、答辩PPT |
| nature-image2ppt | 幻灯片图/截图/扫描 PDF/纯图 PPTX → 对象级可编辑 PowerPoint。 | 图片转可编辑PPT、截图还原PPT、图示重建 |
| nature-proposal-writer | 研究计划/开题报告/科研项目申请书撰写、修订与审计。 | 研究计划、开题报告、科研项目申请书 |
| nature-paper-to-patent | 论文/发明人材料 → 证据支撑的中国发明专利稿 + 技术交底书 + DOCX 专利包。 | 技术交底书、专利撰写、现有技术对比 |
| nature-experiment-log | 标准化实验日志：直接上传/读取图片、语音、文字 → 带 YAML frontmatter 的 Markdown，可选集成飞书 CLI 与 Obsidian。 | 实验记录、语音转日志、实验笔记 |
| nature-shared | 内部共享参考支持包（nature-writing/polishing/response/reader/paper2ppt 共用），不作为独立用户工作流调用。 | 仅由其他 Nature 技能按需加载 |

---

## 常用操作

```bash
# 克隆主仓并递归拉取所有子仓
git clone --recurse-submodules https://gitee.com/weedd/skill-all.git

# 已克隆的主仓补拉全部子仓
git submodule update --init --recursive

# 更新所有子仓到其远端最新
git submodule update --remote --recursive

# 修改 skills/（个人积累）或挂载新子仓后，重新生成 manifest
python scripts/generate-manifest.py
```

## 新增子仓（按需添加）

1. 在 Gitee 创建子仓（可用 [`docs/adding-subrepo.md`](./docs/adding-subrepo.md) 中的 API 模板，需私人令牌）。
2. 将技能实体推入该子仓。
3. 挂载：`git submodule add https://gitee.com/weedd/skill-<name>.git subrepos/<name>`
4. 重新生成 manifest：`python scripts/generate-manifest.py`
5. 更新本 README 索引并提交推送。

## 分发到 agent（预留，暂不执行）

`scripts/link-skills.sh` 支持把 manifest 中的技能以 junction（Windows）/ symlink（Unix）方式挂到指定 agent 的 skills 目录，实现「主仓单一事实源、agent 侧视图」：

```bash
sh scripts/link-skills.sh "$HOME/.claude/skills"
sh scripts/link-skills.sh "$HOME/.omp/agent/skills"
```

---

## 维护规范

本次搭建沉淀的约定，后续持续遵守：

1. **职责分离**：`skills/`（个人积累，手动放入）与 `subrepos/`（项目依赖，submodule）不混用。
2. **自有技能区**：主仓 `skills/` 只放你个人积累、觉得不错的技能，直接 git 管理，不走子仓。
3. **任何技能增删后必须同步**：修改 `skills/` 或新增/移除 `subrepos/` 子仓后，依次执行
   `python scripts/generate-manifest.py` → 更新本 README 索引 → 提交推送。
4. **manifest 是各 agent 的读取入口**：不同 agent / 项目通过 `manifest.json` 发现技能（名称、路径、描述、来源 `self` / `subrepo`），按需调用。
5. **项目级 skill 配置暂不实现**：按 agent / 按项目挑选技能子集的配置，后续场景积累中逐步加入。
6. **分发机制预留**：`scripts/link-skills.sh` 支持把技能以 junction（Windows）/ symlink（Unix）挂到指定 agent 目录，实现「主仓单一事实源、agent 侧视图」；当前阶段不执行。
7. **Windows 脚本用 `sh` 运行**：本机 `bash` 解析到 WSL，运行脚本请用 `sh`（`C:\Program Files\Git\bin\sh.exe`）。
8. **子仓命名**：`skill-<name>`；挂载路径一律 `subrepos/<name>`。
9. **子仓技能布局兼容**：manifest 扫描支持三种布局（根即技能 / `skills/` 子目录 / 顶层子目录即技能），聚合器目录递归展开。