| name | cultivating-skills |
| description | Distills repeated workflows into reusable skills, improves existing skills, and gates them through a three-tier publish funnel (local → project → community). Use when the agent or user notices a pattern worth crystallizing, when an existing skill is incomplete, or when something deserves community contribution. Default deny on dangerous tools and side effects. |
| compatibility | node>=18 |
| user-invocable | true |
| allowed-tools | Bash, Read, Write, Edit, Grep |
| argument-hint | <distill|create|improve|publish> [topic-or-path] |
| aliases | forge-skill, cultivate-skill |
炼制神通 · cultivating-skills
框架之外仍有道。重复三次即沉淀，沉淀必经安全脊柱，发布必走漏斗。
三种触发模式
| 模式 | 触发 | 入口 |
|---|
distill | Agent 在会话中识别"魔尊已重复 N 次同类操作" | 主动提议→显式确认 |
create | 用户显式 /cultivate-skill <topic> | 脚手架交互 |
improve | 用户指现有 skill 不足 | diff + 增量补丁 |
三级沉淀漏斗
L0 本地私有 ~/.claude/skills/local/ → 不入路由、显式调用、不审
L1 项目私有 <repo>/.claude/skills/ → 入 git、团队共享、强 lint
L2 社区贡献 GitHub Issue/PR + safety_scan → 进入 upstream 候选池
默认 L0——魔尊主动升级，避免污染。每升一级，门槛递增。
何时使用
| 场景 | 使用 | 理由 |
|---|
| 同类操作 ≥ 3 次（手动构造的 prompt、命令链、修复模板） | ✅ distill | 边际收益最高 |
| 现有 skill 缺失关键场景 / 表述模糊 | ✅ improve | 直接打补丁 |
| 用户提出新工程化方法论 | ✅ create | 显式生成骨架 |
何时不使用
- ❌ 单次性脚本 / 一次性查询——沉淀价值低，徒增噪音
- ❌ 复制粘贴现有 skill 内容——用
aliases 或 reference 链接即可
- ❌ 项目特定状态（API 端点、内部约定）——写进项目 CLAUDE.md
- ❌ 重复内容含 secret / 私密细节——永不沉淀
安全脊柱（默认拒绝）
新 skill 落盘前必须通过 safety_scan，命中任一项即阻断：
- frontmatter 合规：
name kebab-case 唯一、description ≥ 40 字、user-invocable 显式声明
- 工具最小权限：
allowed-tools 默认仅 Read；扩权（Bash/Write/Edit/WebFetch）必须有理由说明
- 无硬编码 secret（复用
analyzing-security 规则集）
- 无危险默认模板、无 prompt injection 反模式、scripts 单入口、引用文件存在
详细规则矩阵见 references/safety-review.md。
工作流速查
使用
node scripts/skill_forge.js init <slug> [--tier local|project|community]
node scripts/skill_forge.js lint <skill-dir>
node scripts/skill_forge.js scan <skill-dir>
node scripts/skill_forge.js improve <existing-skill-dir>
node scripts/skill_forge.js promote <skill-dir> --to project
收口
落盘前必须：scan 通过 + lint 通过 + 魔尊 review diff。
社区提交：复用 submission portal，本 skill 只负责生成 payload，不重造提交流程。
参见姊妹 skill cultivating-personas——专司人格沉淀。
