第三件带脚本：收编目件出厂——第8轮设计模式提炼：给编目配一条产线

flowchart TD
    A["第一件 minutes-fixer<br/>把一件事写清楚"] --> B["第二件 skill-dispatcher<br/>让一堆件排好队"]
    B --> C["第三件 catalog-drafter<br/>给编目配一条产线"]

name: catalog-drafter
description: Draft a starter catalog for skill-dispatcher by scanning the
  local skill registry. Use when the user asks to draft, bootstrap, refresh,
  or audit a skill catalog, or asks what skills are installed and how each
  is called. Read-only by contract - it proposes catalog rows and never
  writes files. For finding new skills to install use find-skills instead.
  Not a replacement for skill-dispatcher or any catalogued skill.
# Catalog Drafter — 编目产线

装机盘的第三层：扫出全部在册件，起草一行四列的编目，落盘交给用户。
本件只生产草稿，不装货。

## 编目格式
四列规格从 skill-dispatcher 的 references/catalog.md 采认：
域别名 | 件名 | 一句话触发词 | 召唤口令
其中域别名与召唤口令由你定稿，脚本只供后两列原料。

## 工作流程
1. 盘点：运行 scripts/draft_catalog.py；退出码非零走降级路径，
   不许现场改脚本
2. 归域：给每行补域别名；一域超过八件时，先建议收编目再交稿
3. 撞户上报：标记 [DUPLICATE] 的行原样列出，禁止擅自合并，
   留哪一户由用户裁决
4. 呈稿：输出完整四列表；召唤口令列由脚本草稿改写成
   用户可原话复制的自然句
5. 交割：用户确认后，由用户自行把表贴进前台件的编目；本件不落盘

## 不要做
- 不要写任何文件——产线只出厂，不安装
- 不要推荐脚本输出里不存在的件名
- 不要静默合并撞户行
- 不要为「补全描述」去展开读取件的正文——编目只认门牌

## 示例
- 「我的装机盘里都有什么」→ 跑脚本，按域分组呈全表，
  总件数与撞户数随表报
- 「给 skill-dispatcher 刷新编目」→ 呈四列表，并逐行标注
  与旧编目的增减
- 「帮我找几个能处理 PDF 的新件」→ 让路 find-skills，
  产线不开进货单

## 完成定义
- 呈出的表恰好四列，每行件名都出自脚本输出
- 脚本退出码、撞户数量如实随稿报告
- 本次运行写盘数为零

#!/usr/bin/env python3
"""draft_catalog.py - 只读扫描技能注册表，输出编目草稿原料（TSV）。
契约：本脚本永不写盘；同一注册表状态两次运行输出逐字节一致。
输出列：件名 | 描述摘要 | 召唤口令草稿（前两列给机器，第三列供改写）
"""
import argparse, os, re, sys

def parse_frontmatter(path):
    try:
        with open(path, encoding="utf-8") as f:
            head = f.read(4096)
    except OSError:
        return None, ""
    m = re.match(r"^---\s*\n(.*?)\n---\s*(\n|$)", head, re.S)
    if not m:
        return None, ""
    name, desc_lines, in_desc = None, [], False
    for raw in m.group(1).splitlines():
        line = raw.rstrip()
        nm = re.match(r"^name:\s*(.+?)\s*$", line)
        dm = re.match(r"^description:(.*)$", line)
        if nm and not in_desc:
            name = nm.group(1).strip().strip("'\"")
        elif dm:
            in_desc = True
            first = dm.group(1).strip()
            if first:
                desc_lines.append(first)
        elif in_desc and raw[:1] in (" ", "\t") and line:
            desc_lines.append(line)
        elif line and line[:1] not in (" ", "\t", "#"):
            in_desc = False
    return name, " ".join(desc_lines)

def scan(root):
    rows = []
    for d in sorted(os.listdir(root)):
        p = os.path.join(root, d, "SKILL.md")
        if os.path.isfile(p):
            name, desc = parse_frontmatter(p)
            rows.append((name or d, d, desc))
    return rows

def clip(text, width):
    text = re.sub(r"\s+", " ", text or "").strip()
    return text[: width - 1] + "…" if len(text) > width else text

def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("--root", action="append",
                    help="技能根目录，可多次传入；缺省扫用户级与项目级")
    ap.add_argument("--max-desc", type=int, default=40)
    args = ap.parse_args()
    roots = args.root or [os.path.expanduser("~/.claude/skills"),
                          os.path.join(os.getcwd(), ".claude", "skills")]
    all_rows = []
    for root in roots:
        if not os.path.isdir(root):
            print(f"ERROR: root not found: {root}", file=sys.stderr)
            sys.exit(1)
        all_rows.extend(scan(root))
    if not all_rows:
        print("EMPTY: no SKILL.md found", file=sys.stderr)
        sys.exit(2)
    seen = {}
    for name, _d, _desc in all_rows:
        seen[name] = seen.get(name, 0) + 1
    dupes = {n for n, c in seen.items() if c > 1}
    for name, d, desc in sorted(all_rows):      # 固定排序，保证可重放
        mark = " [DUPLICATE]" if name in dupes else ""
        call = f"用 {name} 来 {clip(desc, 18) or '……'}"
        print(f"{name}\t{clip(desc, args.max_desc)}{mark}\t{call}")
    if dupes:
        print(f"# 撞户 {len(dupes)} 个：{', '.join(sorted(dupes))}",
              file=sys.stderr)
    sys.exit(0)

if __name__ == "__main__":
    main()

flowchart TD
    A["用户请求编目草稿"] --> B["点亮 catalog-drafter"]
    B --> C["跑 draft_catalog.py"]
    C --> D{"退出码为零"}
    D -->|非零| E["走三条降级路<br/>如实上报"]
    D -->|零| F["拿到 TSV 原料"]
    F --> G["归域补别名<br/>改写召唤口令"]
    G --> H{"遇到 DUPLICATE 行"}
    H -->|有| I["原样列出<br/>用户裁决"]
    H -->|无| J["呈完整四列表"]
    I --> J
    J --> K["用户确认后<br/>自行贴进编目"]
    K --> L["本次写盘数为零"]

# 三件套：正文、脚本、无需编目（编目是产出不是输入）
mkdir -p ~/.claude/skills/catalog-drafter/scripts
# 将上文 SKILL.md 存为 ~/.claude/skills/catalog-drafter/SKILL.md
# 将上文脚本   存为 ~/.claude/skills/catalog-drafter/scripts/draft_catalog.py

# 项目级随 git 走（团队共享同一份注册表口径时）
mkdir -p .claude/skills && cp -r ~/.claude/skills/catalog-drafter .claude/skills/

# 出厂自测：裸跑脚本，先验只读、再验可重放（连跑两次 diff 输出）
python3 ~/.claude/skills/catalog-drafter/scripts/draft_catalog.py --root ~/.claude/skills

# 上下游市场撞名复查（本通道今日未开，命令备上架日用）
npx skills find catalog-drafter