Luban skill

Skill PlevanTem/luban-skill/.claude/skills/luban-skill

不是泛泛而谈，蒸馏一个专家，带走ta的方法论和专业判断。Distill expert methodology into agent kits — not vibes persona prompts

Install

npx -y skills add PlevanTem/luban-skill --skill luban-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Distills professional methodology into reusable expert role packages for Claude Code. Generates a complete role directory (SOUL.md, SKILL.md, identity.json, capability map, critique rubric, anti-patterns) from a domain name plus optional seed materials. Activates only on explicit invocation by name — "luban" or "鲁班". Does not activate on generic persona requests like "make me an expert agent" or "play a senior X".

SKILL.md

8.0 KB, as published. Nobody here has run it

luban-skill

Nuwa 蒸馏人，鲁班蒸馏专业方法论。 Luban distills professional methodology — not individuals, not vibes.

luban 在 Claude Code 里把"生成专业角色"这件事从"让 LLM 描述一个专家"升级为"按方法论蒸馏一个可被真专家承认的角色"。完整方法论在 references/generation-protocol.md，可独立运行。

1. 触发条件

luban 仅在用户明确说出 "luban" 或 "鲁班" 时激活。不蹭以下泛触发：

❌ 不触发:

"make me an expert agent"
"play a senior X for me"
"扮演一个资深 Y"
"generate an expert persona"

✅ 触发:

"use luban to generate a B2B SaaS PM expert"
"用鲁班蒸馏一个高级税务律师"
"luban distill <sub-specialty>"
"用 luban 生成 / 帮我 luban 一个 ... 角色"

如果用户的请求像 "make me a senior X" 但没说 luban：不要主动 hijack——用户可能想要其他工具或就地解决。可以告知 luban 存在，但不强行接管。

2. 执行流程概览

完整流程在 references/generation-protocol.md，共 16 个 section（v0.3.0 起含 §13a 交互协议）。

高层步骤分为 7 个 phase（与 generation-protocol §13a.1 的 banner 一致）。每个 phase 开始前必须显示阶段 banner：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📍 Phase N / 7 — <phase name>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

7 个 phase（每步都 view 对应 reference 文件，不要凭记忆执行）：

Phase 1: 解析输入 + 族判定 + sub-specialty 收敛 (§1-§2)
Phase 2: 种子勘探 (§3, seed-prospect-protocol.md) — 零种子时产 corpora-candidates.md
Phase 3: Capability Taxonomy (§4) — 结束时触发确认门 A（capability-map preview）
Phase 4: Anchors + persona 命名 (§5, §9.2) — 结束时触发确认门 B（persona preview）
Phase 5: Progressive spec + Rubric + Tools (§6-§8) — SKILL.md / capability-clusters / critique-rubric / retrieval-sources
Phase 6: SOUL.md (9-section v0.3) + anti-patterns + evolution-protocol (§9-§12)
Phase 7: Validation + Delivery (§13-§14) — 6 check 全过后触发确认门 C（pre-delivery preview）

每个 phase 用 TaskCreate 维护可视进度。状态信号约定（per §13a.3）：🔍 调研中 / 📝 起草中 / 🧪 验证中 / ✅ 通过 / ⚠️ 需确认。

3. 加载顺序 (which references to view, in what order)

按需 view，不要一次性全 view (会占用过多 context)：

首次进入 luban 时必 view:

references/generation-protocol.md — 主流程

Step 1-2 (输入解析 + 族判定) 时 view:

references/domain-families.md — 5 个族骨架 + 每族的 critique corpora 候选类型

Step 3 (零种子时) view:

references/seed-prospect-protocol.md — 候选清单格式规范

Step 4-5 (生成产物) 时:

生成 identity.json 前 view: references/identity-schema.json
生成 SOUL.md 前 view: references/soul-template.md
生成 <role>/SKILL.md 前 view: references/skill-template.md
生成 capability-map.md 前 view: references/capability-map-template.md
生成 critique-rubric.md 前 view: references/critique-rubric-template.md
生成 anti-patterns.md 前 view: references/anti-patterns-template.md

用户后续要 evolve 角色时 view:

references/evolution-protocol.md

4. 关键决策点 (where Claude must stop and ask user)

luban 分两类 stopping points：stop-and-ask（用户不答 luban 走不下去）+ preview-and-confirm（用户审阅 luban 阶段产物）。

4.1 Stop-and-ask 门（6 个，沿用 v0.2）

sub-specialty 不明确 — 用户只给"产品经理"这种粗粒度，必须回问到"B2B SaaS PM"级别 (per generation-protocol §1.1)
族不匹配 — 用户的领域不在 5 个族内 (per domain-families.md "未匹配处理")，让用户选 (a) 自己写族骨架 (b) 自由模式
零种子 — 用户没能提供前三类种子，产出 corpora-candidates.md 后让用户选 A/B/C (per seed-prospect-protocol)
vibes_risk 即将被设为 high — 进入 zero-shot 模式前，最后一次明确警告并请求确认
6 check 任一失败 — 不能放水通过。回到对应 stage 修复
evolution entry 落盘前 — user_confirmed 必须 true 才能写入 evolution.jsonl

4.2 Preview-and-confirm 门（3 个，v0.3.0 新增 — per generation-protocol §13a.2）

门 A: capability-map.md 落地后 — show 摘要 + [unverified] 数量，请用户决定 continue / revise / cancel
门 B: anchors + SOUL §1-§5 落地后 — show persona 预览（handle、名字、intro、sacred anchors），请用户决定 continue / rename / revise anchors / cancel
门 C: validation 全过后、写 GENERATION_REPORT 前 — show 交付摘要（路径、模式、honest limits），请用户决定 commit / revise

4.3 命名确认（v0.3.0 强制 — per generation-protocol §9.2）

在确认门 B 触发之前，luban 必须用 AskUserQuestion 三选一确认 display name：

选项 A: 功能名（基于 sub-specialty slug）
选项 B: luban 建议的拟人名（短、中性、不带身份信息）
选项 C: 用户自定

详细命名规则见 references/soul-template.md "命名的决策流程" 段。

5. 输出产物结构

默认落盘路径：.claude/skills/<role-slug>/（v0.3.0 起改为 Claude Code 原生 skills 路径）

路径决策：每个生成的角色是一个 Claude Code Skill，必须放在 .claude/skills/ 才能被框架原生发现（/ 浮动面板可见 + auto-activation）
<role-slug> 建议短形态（如 ai-pm 而非 ai-product-manager），因为 .claude/skills/ 路径已隐含"这是一个 agent skill"
同一项目下多个角色并列存放在 .claude/skills/ 下，每个角色一个子目录
luban-skill 自身也住在 .claude/skills/luban-skill/，不冲突
自动维护 .claude/skills/INDEX.md —— 每次生成新角色 append 一行（slug / display name / family / sub-specialty / vibes_risk）
用户显式指定其他路径时遵从用户

成功生成的角色目录:

.claude/skills/<role-slug>/
├── SOUL.md
├── SKILL.md                          (角色的 Claude Code skill 入口，不是 luban 本身)
├── identity.json                     (符合 references/identity-schema.json)
├── evolution.jsonl                   (初始空)
├── GENERATION_REPORT.md              (诚实账单)
└── references/
    ├── capability-map.md
    ├── critique-rubric.md
    ├── anti-patterns.md
    ├── corpora-candidates.md         (zero-shot 模式必有)
    └── source-material/              (用户提供的种子原文存档)

GENERATION_REPORT.md 是强制产物，必含 (per generation-protocol §14):

使用的种子材料 / 缺失的种子
领域族 + sub-specialty
generation_mode (seeded/weak-seeded/zero-shot) + vibes_risk (low/mid/high)
6 个 validation check 的结果
已知 honest limits 摘要
建议的下一步（如何升级到更高 generation_mode）

6. 与其他 skill 的协作边界

Nuwa: 用户想蒸馏具体真人 (Munger / Naval / Musk) 时，提示用 Nuwa 不是 luban
OpenPersona / clawsouls / soul.md 系列: 这些做 persona portability，不做方法论蒸馏。如果用户问的是"如何让 persona 跨 platform"，这些更合适