By name: crystallize-skill description: >- 把重复性流程 / 动作沉淀（固化）为一个可复用 skill 的元流程编排。 当用户说"沉淀成 skill"、"把这个流程做成 skill"、"固化成技能"、"封装成 skill"、 "crystallize skill"，或当某操作已重复多次、明显值得固化为常态资产时使用。 user_invocable: true version: "1.1.0"
crystallize-skill：把重复流程沉淀为可复用 skill
用户是 AI-Agent native（不写代码、不亲自维护文件），但会发现重复流程并下指令"沉淀成 skill"。本 skill 是 AI 必须自动执行的五步流水线，把维护纪律绑定到动作上，而不是靠 AI 每次自觉。
0. 心智模型（铁律）
改在仓库 · 装到本地 · 本地只读
每个 skill 二选一身份：
- 原创态 = 住 GitHub 仓库
alongor666/alongor666-skills（✅git，唯一权威源），在仓库工作树里编辑，git 追溯。 - 消费态（本机） =
sync-skills link直连软链（~/.claude/skills/<x>→ 仓库工作树skills/<x>），改源即生效，无快照层。 - 消费态（他人机器） =
npx skills add拉快照副本，永不在快照里编辑，更新靠重拉。
拓扑：① GitHub 仓库（唯一权威源）→ ② 本机 ~/.claude/skills/<x>（sync-skills 软链直连工作树，改源即 live）／③ 他人机器 npx 快照（发布渠道）。项目专属、不跨项目复用的 skill 放 ④ <project>/.claude/skills/*.md（随项目 git）。
1. 流水线（AI 自动执行，用户全程不碰文件）
Step 1 · 判归属（默认值能判就判，仅真歧义问用户一句）
- 跨项目 / 跨会话复用 → 仓库①（原创态，本 skill 主路径）。
- 只服务单一项目、依赖该项目数据 / 路径 → 项目④ 的
.claude/skills/<name>.md。 - 用户已明示"Git 共享 / 仓库 / 跨项目" → 直接走①，不再问。
Step 2 · 查重叠（防混乱核心，禁止新建重复）
- 先扫描现有 skill 的
description（Claude Code 已把全部 skill 描述注入 system-reminder，直接读，不必逐个 grep）。 - 命中相近 skill → 并入它 / 走路由器模式（一域一 router + N 窄子命令），不新建重复。
- 与基座类（如
writing-skills写作规范、commit-push-pr-core提交基座）有关 → 复用 / import，不复制其骨架。
Step 3 · 写在唯一事实源
- 仓库 skill：在仓库 clone 写
skills/<name>/SKILL.md。质量规范（frontmatter / 结构 / 触发语）调用writing-skillsskill 把关，不自行随意发挥。 - 项目 skill：写
<project>/.claude/skills/<name>.md。 - frontmatter 必含
name（与目录同名）、description（含 CSO 第三人称触发语："Use when / 当用户说 …"）；推荐version、user_invocable。
Step 4 · 发布 + 安装（仓库 skill 路径）
# 在仓库工作树内
git add skills/<name> && git commit -m "feat(skill): 新增 <name>" && git push
# 本机直连补链（幂等；已有直连的技能改源即生效，无需任何重装）
skills/sync-skills/sync-skills.sh link
# 验证直连健康
skills/sync-skills/sync-skills.sh doctor
- ⚠️ 本机禁止
npx skills add --all——会把直连软链覆盖为快照拷贝，此后改源不再生效（用doctor检测、link修回）。npx skills add仅用于发布给别人 / 其他机器；逗号批量--skill a,b,c静默失败，多个 skill 须for循环逐个单装。
Step 5 · 登记
- 更新本项目
.claude/rules/skills-map.md的"本项目用法"行（若与本项目相关）。 - 写 / 更新 memory（维护模型见
project_skills_maintenance_model）。
2. 防混乱清单（每条 = 一个制造新乱的动作 + 护栏）
| 禁止动作 | 后果 | 护栏 |
|---|---|---|
本机跑 npx skills add --all |
直连软链被覆盖成快照，改源失效 | 只用 sync-skills link；误跑后 doctor+link 修回 |
在 ~/.claude/skills 新建实体目录 skill（绕过仓库） |
重现"四不像"无溯源 | 原创一律进①或④ |
| 不查重就新建 | 重复 / 口径漂移 | Step 2 先扫描 + 路由器 |
| 改完忘 push | 别的机器 / 会话拿旧版 | push 是 Step 4 固定步 |
| 改 skill 不更 skills-map / 文档 | SSOT 漂移 | Step 5 编辑即同步 |
给别人发布时逗号批量 --skill a,b,c |
静默失败 | 循环单装 |
3. 查询命令（不靠记忆）
skills/sync-skills/sync-skills.sh doctor # 本机直连健康度（漂移项退出码 1）
npx skills add alongor666/alongor666-skills -g -l # 仓库已发布哪些（发布视角）
npx skills list -g # 本地装了哪些 + 来源
4. 不做什么（范围纪律）
- ❌ 不替代
writing-skills：SKILL.md 的写作质量交给它，本 skill 只管编排"判归属→发布→安装→登记"。 - ❌ 不给
~/.claude/skills/~/.agents/skills做 git init（运行时目录是软链 + 派生副本，git 化只制造噪音；追溯靠仓库①的 git）。 - ❌ 不过度抽象：项目专属、强依赖单项目数据的流程，留在项目④，不为"共享"强行上提到仓库。