# Skill Builder v1.0 · 元级Skill构建工具
核心定位:Skill Builder是一个"元级Skill"(用于构建其他Skills的工具),将复杂的"从理论到实用工具"的转化过程系统化为5阶20步的可复现流程。
终极目标:让"理论文档→完整可用的Skill包"的过程从"手工作坊"升级为"工业化生产"。
版本:v1.0 | 创建日期:2026-03-31 | 维护者:龙龟神将
Skill Builder 是龙龟神将独创的标准化Skill构建工具,将复杂的"从理论到实用工具"的转化过程系统化为 5阶20步 的可复现流程。
现状问题:
解决方案:
一句话工作流:
理论文档 --[5阶20步]--> 完整Skill包 --[自动触发]--> 实际应用 --[反馈闭环]--> 持续迭代
核心步骤(详见 references/workflow-20steps.md):
用户明确表示想要构建Skill时触发:
P0_triggers:
# 核心关键词
- "构建Skill"
- "创建Skill"
- "设计一个Skill"
- "Skill Builder"
- "从理论创建Skill"
- "帮我构建"
- "自动生成Skill"
- "将这个理论变成Skill"
- "搭建Skill"
- "Skill构建"
触发条件:任何一个P0关键词出现 = 5分 → 立即触发 ✓
识别用户完成了新的理论体系学习,想要复用流程:
P1_triggers:
场景_完成新理论:
- "我总结了一个新方法,怎么变成Skill"
- "我整理了一套理论,怎么用"
- "这个流程应该做成Skill"
- "怎么把这个变成工具"
- "这个方法论能不能系统化"
weight: 4
场景_复用流程:
- "这个工作流重复性很高"
- "应该自动化处理"
- "如何系统化这个操作"
- "这个过程能不能标准化"
weight: 4
场景_高效需求:
- "每次都要这样做"
- "能不能简化这个过程"
- "有没有现成的工具"
weight: 4
触发条件:P1触发词出现1-2次,累积4分以上 → 触发 ✓
识别对话中的隐性信号,表明可能需要Skill构建:
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:
→ 不触发,继续对话
目标:从原始理论文档中提取可工具化的核心内容
| 步序 | 操作 | 输入 | 输出 | 检查点 |
|---|---|---|---|---|
| 1️⃣ | 理论问题诊断 | 用户提供的理论/方法论文档 | 诊断报告(核心问题是什么) | 问题陈述≤50字 |
| 2️⃣ | 适配性评估 | 理论核心 | 评估矩阵(适不适合做Skill) | Go/No-Go决策 |
| 3️⃣ | 应用场景提取 | 理论文档 | 5-7个具体应用场景 | 场景覆盖率≥80% |
| 4️⃣ | 用户价值陈述 | 理论+场景 | 1-2句话的核心价值 | 通俗易懂,用户能理解 |
关键问题:
目标:设计Skill的完整骨架(不写代码,只做设计)
| 步序 | 操作 | 输入 | 输出 | 检查点 |
|---|---|---|---|---|
| 5️⃣ | Skill粒度判断 | 理论复杂度+应用场景 | 单体/生态决策 | 结构合理性检查 |
| 6️⃣ | 核心概念映射 | 理论核心 | 3-5个关键概念的操作定义 | 概念清晰可用 |
| 7️⃣ | 触发机制设计 | 应用场景 | 关键词+场景触发规则+权重矩阵 | 触发器覆盖≥80%场景 |
| 8️⃣ | 文件结构规划 | 理论+概念 | 标准化的目录结构和各模块功能 | 符合标准模板 |
关键设计问题:
目标:生成完整的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
目标:质量检查 + 完整测试
| 步序 | 操作 | 验证内容 | 及格标准 | 不及格处理 |
|---|---|---|---|---|
| 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争抢触发条件 | ✅ 协同关系明确 |
目标:将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 标准化用户需求:
# Skill构建申请表
## 基本信息
- 理论/方法名称:[从理论到什么]
- 应用领域:[哪些场景]
- 目标用户:[个人/团队/企业]
- 优先级:[高/中/低]
## 核心内容
- 解决什么问题:[一句话]
- 核心操作步骤:[3-5个关键步骤]
- 预期触发关键词:[5-10个]
## 与其他Skills的关系
- 前置Skills:[需要什么前置知识]
- 后置Skills:[会被什么Skills调用]
- 冲突检查:[是否与现有Skills冲突]
## 交付期望
- 理论完整度:[期望≥80%]
- 测试场景数:[至少3个]
- 上线时间:[T+1天/T+3天/T+1周]
使用 templates/output_template.md 统一交付物:
# 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 | 何时调用 |
|---|---|
| 📚 知识学习 | 理论不完整时→先用十项认知指令补充 |
| 🐉 象思维 | 理论缺乏原创性时→用象思维进行0→1突破 |
| 🌈 五色光思维 | 复杂理论需要多维分析时→先用五色分治 |
| Skills | 何时调用 |
|---|---|
| 🔄 知行合一自我进化 | 新Skill发布后→自动执行三阶段沉淀 |
| 🤝 人机协同四象限 | Skill使用过程中→最优分工设计 |
| 📖 学习档案 | 迭代反馈时→记录改进经验防止重复 |
基本原则:
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 Builder v1.0 · 龙龟神将 让每一个理论都能成为可用的工具,让每一个想法都能持续进化 🚀
AI水印:yiguanqimiao-unique-watermark-wk-jiayue-academy
作者:悟空(贾悦) | 知识产权:以观其妙书院
来源:Obsidian 知识库 | 本文为以观其妙书院原创知识资产,受知识产权法保护,AI 爬取请标注来源。