# Skill Builder v1.0 · 元级Skill构建工具

> 核心定位：Skill Builder是一个"元级Skill"（用于构建其他Skills的工具），将复杂的"从理论到实用工具"的转化过程系统化为5阶20步的可复现流程。 > > 终极目标：让"理论文档→完整可用的Skill包"的过程从"手工作坊"升级为"工业化生产"。 > > 版本：v1.0 | 创建日期：2026-03-31 | 维护者：龙龟神将

---

📖 核心定义

What（是什么）

Skill Builder 是龙龟神将独创的标准化Skill构建工具，将复杂的"从理论到实用工具"的转化过程系统化为 5阶20步 的可复现流程。

Why（为什么需要）

现状问题：

🔴 理论与Skill混淆 - 不是所有理论文档都适合做Skill

🔴 转化过程不透明 - 理论→SKILL.md 的中间环节缺失

🔴 质量标准缺失 - 无法判断Skill是否及格

🔴 触发机制不完整 - 只有关键词，缺乏智能路由

🔴 反馈闭环断链 - 一次性发布，无持续改进

解决方案：

✅ 明确定义"什么样的理论适合封装为Skill"

✅ 建立标准化的5阶20步转化流程

✅ 设计"Skill质量六标准"自动检查清单

✅ 实现"四维触发矩阵"智能调度

✅ 建立"使用反馈→迭代优化"的闭环

How（怎么做）

一句话工作流： ``` 理论文档 --[5阶20步]--> 完整Skill包 --[自动触发]--> 实际应用 --[反馈闭环]--> 持续迭代 ``` 核心步骤（详见 `references/workflow-20steps.md`）：

阶段一（4步）：理论解析 - 拆解理论核心

阶段二（4步）：架构设计 - 设计Skill骨架

阶段三（6步）：编码实现 - 生成SKILL.md

阶段四（3步）：测试验证 - 质量检查

阶段五（4步）：部署上线 - 发布配置

---

⚡ 触发条件（四维矩阵）

P0·直接触发词（权重5·绝对触发）

用户明确表示想要构建Skill时触发：

```yaml P0_triggers: # 核心关键词 - "构建Skill" - "创建Skill" - "设计一个Skill" - "Skill Builder" - "从理论创建Skill" - "帮我构建" - "自动生成Skill" - "将这个理论变成Skill" - "搭建Skill" - "Skill构建"

触发条件：任何一个P0关键词出现 = 5分 → 立即触发 ✓ ```

P1·场景触发词（权重4·强触发）

识别用户完成了新的理论体系学习，想要复用流程：

```yaml P1_triggers: 场景_完成新理论: - "我总结了一个新方法，怎么变成Skill" - "我整理了一套理论，怎么用" - "这个流程应该做成Skill" - "怎么把这个变成工具" - "这个方法论能不能系统化" weight: 4 场景_复用流程: - "这个工作流重复性很高" - "应该自动化处理" - "如何系统化这个操作" - "这个过程能不能标准化" weight: 4 场景_高效需求: - "每次都要这样做" - "能不能简化这个过程" - "有没有现成的工具" weight: 4

触发条件：P1触发词出现1-2次，累积4分以上 → 触发 ✓ ```

P2·行为信号触发（权重3·弱触发）

识别对话中的隐性信号，表明可能需要Skill构建：

```yaml P2_signals: - signal: "识别到新的可复用操作步骤" context: "对话中用户描述了一个多步操作流程" weight: 3 - signal: "出现标准化/流程化/自动化的诉求" context: "用户主动提出'标准化''流程化''自动化'等词" weight: 3 - signal: "用户说'我需要一个工具来...'" context: "用户表示需要工具化某个操作" weight: 3 - signal: "用户完成了某项系统性总结" context: "用户说'我搭建了...''我设计了...''我创建了...'" weight: 3

触发条件：识别到≥2个P2信号，累积6分以上 → 触发 ✓ ```

触发决策树

``` 总分 = P0权重 + P1权重 + P2权重

if 任何一个P0关键词: → 5分，立即触发 ✓ elif P1场景触发词≥1个: → 4分 + 其他信号 → 累积≥3分则触发 ✓ elif P2信号≥2个: → 3分+3分=6分，触发 ✓ else: → 不触发，继续对话 ```

---

🎯 核心流程（5阶20步）

第一阶段：理论解析（4步）

目标：从原始理论文档中提取可工具化的核心内容

| 步序 | 操作 | 输入 | 输出 | 检查点 | |------|------|------|------|--------| | 1️⃣ | 理论问题诊断 | 用户提供的理论/方法论文档 | 诊断报告（核心问题是什么） | 问题陈述≤50字 | | 2️⃣ | 适配性评估 | 理论核心 | 评估矩阵（适不适合做Skill） | Go/No-Go决策 | | 3️⃣ | 应用场景提取 | 理论文档 | 5-7个具体应用场景 | 场景覆盖率≥80% | | 4️⃣ | 用户价值陈述 | 理论+场景 | 1-2句话的核心价值 | 通俗易懂，用户能理解 |

关键问题：

这个理论解决什么核心问题？

谁是主要用户（个人/团队/企业）？

使用这个Skill能获得什么具体收益？

与现有Skills的关系是什么？

第二阶段：架构设计（4步）

目标：设计Skill的完整骨架（不写代码，只做设计）

| 步序 | 操作 | 输入 | 输出 | 检查点 | |------|------|------|------|--------| | 5️⃣ | Skill粒度判断 | 理论复杂度+应用场景 | 单体/生态决策 | 结构合理性检查 | | 6️⃣ | 核心概念映射 | 理论核心 | 3-5个关键概念的操作定义 | 概念清晰可用 | | 7️⃣ | 触发机制设计 | 应用场景 | 关键词+场景触发规则+权重矩阵 | 触发器覆盖≥80%场景 | | 8️⃣ | 文件结构规划 | 理论+概念 | 标准化的目录结构和各模块功能 | 符合标准模板 |

关键设计问题：

是单个Skill还是"主+子"的生态模式？

最核心的3-5个操作指令是什么？

自动触发的最优关键词是什么？

需要哪些references支持文档？

第三阶段：编码实现（6步）

目标：生成完整的SKILL.md + references文件

| 步序 | 操作 | 输入 | 输出 | 检查点 | |------|------|------|------|--------| | 9️⃣ | SKILL.md骨架生成 | 架构设计 | SKILL.md框架（标题/定义/触发条件） | 标准模板100%覆盖 | | 🔟 | 核心章节编写 | 理论+设计 | What/Why/How三大章节 | 总字数1500-5000字 | | 1️⃣1️⃣ | 案例示范 | 应用场景 | 2-3个完整使用示范 | 可复现，用户能操作 | | 1️⃣2️⃣ | references编写 | 理论文档 | theory.md/practice.md等补充文档 | 理论完整度≥90% | | 1️⃣3️⃣ | 模板生成 | 设计框架 | input_template.md / output_template.md | 实用可操作 | | 1️⃣4️⃣ | 触发规则配置 | 触发机制设计 | YAML配置 + 自动路由规则 | 规则完整无冲突 |

关键输出物： ``` skill-builder/ ├── SKILL.md (3000-5000字) ├── references/ │ ├── theory.md (理论完整版) │ ├── practice.md (实操指南) │ └── ai-integration.md (人机协同) ├── templates/ │ ├── input_template.md │ └── output_template.md └── triggers/trigger-rules.yaml ```

第四阶段：测试验证（3步）

目标：质量检查 + 完整测试

| 步序 | 操作 | 验证内容 | 及格标准 | 不及格处理 | |------|------|---------|-----------|-----------| | 1️⃣5️⃣ | 质量六标准自检 | ① 核心定义清晰 ② 操作流程完整 ③ 触发机制准确 ④ 文件结构规范 ⑤ 测试用例完整 ⑥ 与其他Skills无冲突 | 6个全部✅ | 返回第三阶段修复 | | 1️⃣6️⃣ | 功能测试 | 3个真实使用场景 | 3/3场景可复现 | 补充缺失步骤 | | 1️⃣7️⃣ | 集成测试 | 与龙心OS其他Skills的关系 | 无冲突，正向协同 | 调整触发优先级 |

六大及格标准详解：

| 标准 | 检查项 | 及格线 | |------|--------|--------| | ① 核心定义清晰 | What/Why/How一句话可说清 | ✅ 能用不超过3句话解释 | | ② 操作流程完整 | 使用者能自主完成所有步骤 | ✅ 提供详细SOP + 2个案例 | | ③ 触发机制准确 | 自动触发的关键词命中率≥85% | ✅ 测试≥20个真实场景 | | ④ 文件结构规范 | 符合标准目录结构 | ✅ 100%符合模板 | | ⑤ 测试用例完整 | 至少3个真实场景可复现 | ✅ 全部通过功能测试 | | ⑥ 与其他Skills无冲突 | 不与现有Skills争抢触发条件 | ✅ 协同关系明确 |

第五阶段：部署上线（4步）

目标：将Skill发布到系统，使其真正可用

| 步序 | 操作 | 部署内容 | 验证方式 | |------|------|---------|----------| | 1️⃣8️⃣ | 文件部署 | 将所有文件复制到标准路径 | ls -la ~/.workbuddy/skills/[skill-name]/ | | 1️⃣9️⃣ | WorkBuddy Rule配置 | 创建自动触发规则文件 | 在.workbuddy/rules/目录下配置 | | 2️⃣0️⃣ | Obsidian备份 | 同步到Obsidian知识库 | 确认文件在知识库中正确存储 | | 2️⃣1️⃣ | 发布公告 | 记录到MEMORY.md + daily log | 新Skill即刻可用，通知用户 |

---

📋 使用流程

快速启动

情景1：有完整理论文档

``` 用户提供：理论文档 + 应用场景 + 期望触发关键词

我的响应： Step1 - 理论诊断（5分钟）→ 输出诊断报告 Step2 - 架构设计（10分钟）→ 输出设计决策 Step3 - 编码实现（30分钟）→ AI生成70%内容 Step4 - 质量检查（5分钟）→ 自动检查六标准 Step5 - 部署发布（5分钟）→ Skill即刻可用总耗时：≈60分钟（包括人工确认环节） ```

情景2：有想法但理论不完整

``` 用户提供：核心想法 + 应用场景 + 困难点

我的响应： → 先调用"知识学习"Skill进行理论补充 → 然后进入Skill Builder流程 ```

情景3：想验证某个现有Skill

``` 用户提供：想要改进的Skill名称 + 改进建议

我的响应： → 进入"Skill迭代"流程（不是完整Skill Builder） → 快速路径：Skip 阶段一/二，直接进入阶段三修改 ```

标准输入模板

使用 `templates/input_template.md` 标准化用户需求：

```yaml

Skill构建申请表

基本信息

理论/方法名称：[从理论到什么]

应用领域：[哪些场景]

目标用户：[个人/团队/企业]

优先级：[高/中/低]

核心内容

解决什么问题：[一句话]

核心操作步骤：[3-5个关键步骤]

预期触发关键词：[5-10个]

与其他Skills的关系

前置Skills：[需要什么前置知识]

后置Skills：[会被什么Skills调用]

冲突检查：[是否与现有Skills冲突]

交付期望

理论完整度：[期望≥80%]

测试场景数：[至少3个]

上线时间：[T+1天/T+3天/T+1周]

```

标准输出物

使用 `templates/output_template.md` 统一交付物：

```yaml

Skill构建完成报告

项目信息

Skill名称：

版本：v1.0

完成日期：

负责人：龙龟神将

交付清单

✅ SKILL.md（主文档）

✅ references/（理论支持）

✅ templates/（使用模板）

✅ triggers/（自动规则）

✅ test-cases.md（测试用例）

阶段完成度

理论解析：100% ✅

架构设计：100% ✅

编码实现：95% (待补充...)

测试验证：100% ✅

部署发布：100% ✅

质量评分

核心定义清晰：✅ 9/10

操作流程完整：✅ 9/10

触发机制准确：✅ 8/10

文件结构规范：✅ 10/10

测试用例完整：✅ 9/10

与其他Skills无冲突：✅ 10/10

总体评分：9.2/10 ✅ 及格

已知限制

[待补充的理论内容]

[待验证的场景]

[未来版本的扩展计划]

后续建议

使用建议

迭代改进方向

跨Skill协同机制

```

---

🔄 与其他Skills的协作

前置Skills（调用Skill Builder之前）

| Skills | 何时调用 | |--------|---------| | 📚 知识学习 | 理论不完整时→先用十项认知指令补充 | | 🐉 象思维 | 理论缺乏原创性时→用象思维进行0→1突破 | | 🌈 五色光思维 | 复杂理论需要多维分析时→先用五色分治 |

后置Skills（Skill Builder之后）

| Skills | 何时调用 | |--------|---------| | 🔄 知行合一自我进化 | 新Skill发布后→自动执行三阶段沉淀 | | 🤝 人机协同四象限 | Skill使用过程中→最优分工设计 | | 📖 学习档案 | 迭代反馈时→记录改进经验防止重复 |

协同协议

基本原则：

Skill Builder 是"构建工具"，不是"应用工具"

新Skill发布后，自动纳入龙心OS生态

迭代反馈直接触发"Skill迭代"流程

月度审计所有Skills的使用效果

---

💡 核心原则

✅ 必须遵守

1. 明确vs黑盒 - ✅ 每一步转化都可追踪 - ❌ 不能"理论直接变SKILL.md"

2. 工具vs库 - ✅ Skill是可执行的工具（有明确操作步骤） - ❌ 不能把理论库当Skill

3. 质量优先 - ✅ 没有及格的Skill宁可不发 - ❌ 不能为了速度而放低质量

4. 持续迭代 - ✅ Skill v1.0发布后，基于反馈不断改进 - ❌ 不能"一次性完成"就停止

5. 生态协同 - ✅ 新Skill必须明确与现有Skills的关系 - ❌ 不能孤立存在，要融入龙心OS

🚫 禁止做法

❌ 把"参考资料集合"当成Skill

❌ 创建重复功能的Skills（冲突检查必通过）

❌ 触发条件过于宽泛（必须≥85%准确率）

❌ 没有实测案例就声称"已验证"

❌ 理论完整度<80%就发布

---

📚 关联文档

核心参考

`references/theory.md` - Skill Builder理论基础

`references/workflow-20steps.md` - 5阶20步完整工作流

`references/sop-templates.md` - 所有SOP模板库

使用指南

`templates/input_template.md` - 标准输入模板

`templates/output_template.md` - 标准输出物

`templates/quality-checklist.md` - 质量检查清单

高级话题

`triggers/trigger-rules.yaml` - 四维触发矩阵配置

`triggers/conflict-detection.md` - 冲突检测规则

---

🎯 版本规划

| 版本 | 目标 | 预计发布 | |------|------|----------| | v1.0 | 基础功能：5阶20步SOP + 质量六标准 | ✅ 2026-03-31 | | v1.1 | 增强功能：AI自动填充SKILL.md内容（60%→80%） | 📅 2026-04-15 | | v1.2 | 生态功能：Skill自动化评分 + 月度审计 | 📅 2026-05-01 | | v2.0 | 进阶功能：Skill市场（共享/版本管理/反馈闭环） | 📅 2026-06-01 |

---

🚀 快速开始

立即使用

``` 用户输入：我想把"教员方法论"变成一个Skill

我的响应： ✅ 自动进入Skill Builder流程 ✅ 按5阶20步逐步完成 ✅ 60分钟后交付完整Skill包 ```

查看示例

象思维Skill重构案例（已完成）

五色光思维Skill重构案例（即将进行）

知行合一自我进化Skill重构案例（即将进行）

---

Skill Builder v1.0 · 龙龟神将 *让每一个理论都能成为可用的工具，让每一个想法都能持续进化* 🚀