skill-forgelisted
Install: claude install-skill qiaomiaojoe/ai-academic-workflow
# Skill Forge · 源材料 → 成品 skill(5 阶段 2 停点)
一次性完成从源材料到可用 skill 的全过程。全程只有 **2 个【停】点**等用户拍板(阶段 1 锁筛选准则、阶段 5 落盘前总审),其余阶段自动连跑。
## 调用约定(独立运行)
- 最小输入:目标 skill 主题 + 目�� skill 名(小写连字符)+ 源材料(`skill源材料/` 或用户给的任意文件/文件夹,不限格式 PDF/md/txt/docx/epub;含 源材料清单.md 时先读它了解各份定位)+ 目标平台(Claude Code / Codex,默认 Claude Code)。源材料文件夹不存在或为空 → 停下提醒先跑 `skill-workshop-plan` 或手动放料。
- 落盘:全局 skills 目录(Claude Code → `~/.claude/skills/<name>/`;Codex → `${CODEX_HOME:-$HOME/.codex}/skills/<name>/`),**独立于 paper 项目,跨项目复用,不落进项目文件夹**。
- **调用方覆盖约定**:调用方(工作台 prompt / 用户)显式给出的参数、输入路径、落盘路径与工具选择,一律覆盖本 skill 的默认;但本 skill 的方法步骤、硬约束与停点不可被省略或稀释——调用方若要求跳过某硬约束,以本 skill 为准并提示冲突。
## 全局硬约束
- ⚠️ 只在 2 个【停】点停下等回复,其余一口气连跑,不要每步都问。
- ⚠️ 分清"明显的"和"需拍板的":明显改动(术语统一、笔误、准则的机械应用、控制点的常规改写)直接处理,总审时列清单;只有真歧义(留剔边界、真伪硬约束、破坏性拆分)才拎出来拍板。
- ⚠️ 软约束词(consider / may / could / typically / often)一律保留原词,不擅自升级为 must / CRITICAL。
- ⚠️ 脚注 / 表格说明里的硬约束必须单独列一条,不能并进正文。
- ⚠️ 页码必须实测,不允许"约 p.XXX"。
- ⚠️ 唯一不可逆的动作是写入磁盘——只发生在停 2 批准之后。
## 阶段 1 · 提议筛选准则
读全部源材料全文,结合目标主题,提议**针对这些材料 + 这个主题**的筛选准则(每条说清针对什么内容/章节模式、为什么有用或无用,不给通用准则)。多份材料时:先标各份定位(主锚 / 补充 / 对照),准则注明适用于哪份;方法论主张冲突的单独列出等拍板。输出:保留准则 5-8 条 / 剔除准则 5-8 条 / 拿不准 ≥2 条(含倾向与担心)。
→【停 1】等"按这个跑"或"改:xxx"。改了就复述改后准则再继续;确认后的准则原样写进最终素材开头存档。
## 阶段 2 · 筛选 + 结构化提取 + 自查偏差(确认准则后自动跑)
- A 相关性筛选:按准则判断每个段落 → 保留段落清单(章节|起止页|段落主题|命中准则)+ 剔除段落清单 + 段落级拿不准(≥3 条,宁可多列也别替用户做主)。
- B 结构化提取:保留段落里每个分析步骤整理成 7 字段:`## Q[编号] · [步骤名称]`——触发条件 / 输入要求 / 操作流程(1.2.3.)/ 输出标准 / 易错点(≥1 条 + 怎么防)/ 页码引用([书名] p.XXX-XXX 实测)。
- C 自查 3 类 AI 提取偏差,分两类处理、不停:明显的(术语不一致、笔误)→ 直接改并记