harness-engineering: Skill for Claude Code

curate-research —— 仓库自我策展 harness

一个讲 Harness Engineering 的仓库，用一个 harness 来策展自己。本 skill 把外部调研候选可控地整合进 tracked 档案。

核心约束：评审全自动；收录是人类闸门，必须停下来和用户来回讨论后才动 works/ 与 articles.md。

何时用

• 用户给出一批候选 URL（文章 / 论文 / 工具 / 项目），希望整合进仓库
• 用户说「处理 / 收录 / 整理」translate/ 暂存区的翻译
• 已有 translate/<batch>/works-ready/ 候选译文，要决定去向

输入与产物路径

暂存区（gitignored，本地过程区）：translate/<batch>/

• sources/<slug>/source.md（原文快照；论文额外抓 source-full.md）
• translations/<slug>/{01-analysis,02-prompt,translation}.md（过程三件套）
• works-ready/<slug>-translation.md（发布候选）+ works-ready/README.md（状态表，本批权威）

正式档案（tracked）：works/<slug>-translation.md + references/articles.md 条目。

流水线 6 阶段

①抓取 ──②翻译 ──③评审[全自动] ──🚧人类闸门🚧──④收录 ──⑤校验 ──⑥清理

① 抓取

用 baoyu-url-to-markdown 把每个 URL 存到 sources/<slug>/source.md。论文/长文必须额外抓 HTML 全文到 source-full.md（否则只有摘要页，C8 会拦谎报）。

② 翻译

按 baoyu-translate 配置生成 translations/<slug>/ 三件套 → works-ready/<slug>-translation.md。01-analysis.md 要含收录建议；source-full.md 存在时，分析稿不得声称「仅摘要页」。

③ 评审（全自动并行扇出）

对每篇候选派一个评审 agent（一批 3–4 篇，并行多个 agent）。统一打分维度，吐结构化定性。标准评审 prompt 模板：

你是 Harness Engineering 中文知识库的内容评审。仓库主题：人类设计约束与反馈回路、AI agent 写代码。 读 sources/<slug>/source.md(+source-full.md)、works-ready/<slug>-translation.md、translations/<slug>/01-analysis.md，逐篇回答：

• 原文价值：原创洞察密度 / 长文实质 vs 产品页·发布稿·摘要。高/中/低
• 翻译质量：完整逐译 / 压缩摘要 / 首轮粗稿；通顺度、术语到位度。精品/合格/需返工
• 与仓库契合度：补薄弱环节还是重复
• 一句话定性 + 建议去向：works/ 正式收录 / articles.md 观察项一行 / tools/ / 暂不收录 基于实际内容，紧凑中文，结构化输出即为最终产出。

汇总成一张「候选 × 定性 × 去向」表。

🚧 人类闸门（不可跳过）

把评审表交给用户，来回讨论收录决策。精品 vs 边角的边界判断、是否返工、哪些合并成专题——都由人定。未经用户确认，不得进入 ④。

④ 收录（按减熵分流规则）

• 实质原创长文 / 论文 → works/：cp 到 works/<slug>-translation.md，在 articles.md 加一个 ### N. 编号条目（脉络一末尾，旧编号顺移），并同步全部计数缓存（见下）。
• 边角材料（产品页 / README / 发布稿 / 短 bliki）→ articles.md「观察项 / 候选材料（不计入文章数）」表一行，链上游 URL，不做编号条目（文章数不变）。
• 工具类 → 只在用户实际用过后才进 tools/；未实测前在观察项表标 🔵「待实测后入 tools/」。
• 需返工的长文：先润色（事实核查加译者注 / 术语统一）再进 works/。