!8 feat(skills): karpathy-wiki-ingest 成为 bundled skill (IK8MWT #20) · Pull Request !9 · andershsueh/alice-cli

## 概要

实现 issue #20 (IK8MWT): karpathy-wiki-ingest builtin skill — 把 raw/ 里的新源编译进 wiki/ 的确定性执行器。兄弟技能: karpathy-wiki-new (建库) → 本技能 (进料) → karpathy-wiki-lint (体检)。

## 改动

- 新增 `src/skills/bundled/karpathy-wiki-ingest/SKILL.md` (151 行): frontmatter + 中文正文,7 步 Ingest Checklist(scan → design → scaffold → build → lint → log → 回报)、逐份/批量两种节奏、失败处理表、三条禁止事项。
- 新增 `src/skills/bundled/karpathy-wiki-ingest/ingest.ts` (264 行): `scanRaw(root)` 只读扫描,给出 pending / ingested / orphans 三类;`appendLog(root, type, summary)` 按 `## [YYYY-MM-DD] <type> | <summary>` 追加,type ∈ 7 类白名单,append-only;CLI 入口 `node ingest.ts <root> scan | append <type> <summary>`。
- 新增 `test-case/test-issue-020.ts` (404 行): 9 个用例 / 51 个断言,覆盖 SKILL.md 契约、scanRaw 三个分类、scanRaw 幂等、缺 raw/ 抛错、appendLog 格式 + type 白名单 + 幂等、dist 打包。
- 更新 `test-case/test-list.md`: 新增 test-issue-020 行;回归基线 168 → 219 断言。

## 验证

- 全量回归 7 个 issue 测试,219/219 断言全绿(001=27 / 002=36 / 003=34 / 004=25 / 005=9 / 019=37 / 020=51)
- `bun run build` 成功;`dist/skills/bundled/karpathy-wiki-ingest/` 含 SKILL.md + 编译后 ingest.js(由 `scripts/postbuild.mjs` 自动拷贝)
- 生产路径自检:`dist/core/skillManager.js` 能从 dist/skills/bundled 发现该 skill

## 设计决策

1. **scanRaw 只读 + 三分类**: pending(待摄取)/ ingested(已登记)/ orphans(已登记但源不在)。LLM 视角「下一步要做什么」+「有什么不一致要解释」一目了然。
2. **appendLog 自动补最小 log.md 骨架**: 不强制用户先跑 karpathy-wiki-new。在空库里也能工作,但骨架显式标注「完整 schema 请跑 /karpathy-wiki-new」—— 不让两种 log.md 形态在野外混淆。
3. **type 白名单严格对齐 CLAUDE.md log 维护纪律**: 7 类枚举 (`ingest / query / wiki / lint / deliverable / milestone / todo`),非法 type 立即抛错,append-only 不改写旧条目。
4. **basename 而非全路径判等**: SKILL.md 明确「只看文件名,不解析路径」。「raw/Pan-2010-X.md」 与 「Pan-2010-X.md」 视为同一份源,符合 Karpathy 原文「revising topic summaries」的简化精神。
5. **缺 raw/ 抛错 + 友好提示**: 不静默建空目录,引导用户先跑 `/karpathy-wiki-new`,与兄弟 skill 的「先建库」契约一致。

## 风险点

- 解析 ingest summary 用正则抓文件名 token (`FILENAME_TOKEN_RE`),复杂叙述(如「对比 README.md vs SPEC.md」)可能误抓。已知约束,后续 lint skill (#21) 可加二次校验。
- 最小 log.md 骨架不携带完整 schema(避免与 karpathy-wiki-new 模板耦合),用户首次走 ingest 而非先建库时需手动补全 schema。

Generated with [Claude Code](https://claude.com/claude-code)

Closes #20

类型	指派人员	状态
审查	andershsueh 已审查通过	已完成 (1/1人)
测试	andershsueh 已测试通过	已完成 (1/1人)

andershsueh / alice-cli .gitee-modal { width: 500px !important; }

搜索帮助

andershsueh / alice-cli