| name | unit-analyst |
| description | 统一分析 paper、repo、dataset、blog 与技术笔记 unit；按 kind 路由到既有 evidence-first prepare/Agent-fill/verify 实现，保持历史 owner、偏好与确认回执身份不变。 |
Unit Analyst
当用户要深读或分析一个 paper、repo、dataset、blog 或人工技术笔记 unit，而不只是把来源入库时，使用这个 facade。
共同契约
- 理解来自 runtime Agent；脚本只准备空白结构、搬运 Agent fill、逐字核验证据、检查 currentness/substance 并落盘。没有 Agent 阅读与填写，不得自动产生分类、能力、适用性、可信度、偏好或结论。
- Agent 先读完整材料，再按 implementation 给出的 locator 协议挂短逐字 evidence。图片、文件名、alt text、目录关键词、规模、平台字段与机械摘要都不能自动变成判断。
- prepare 后按旧 implementation operation 获取 task-scoped eligible preferences；无 current selection 使用 neutral defaults。facade 不改写 preference skill/operation、record owner、provenance、diagnostic 或 ConfirmationReceipt 身份。
- verify 后的 judgement 仍为
pending_user_confirmation。只有真实用户当前消息授权、真实 signer 与 current evidence 才能确认；不得把“我”、Agent 或来源为用户当作签字。
- source/parse-cache/repo tree、fill binding、record 或 evidence 漂移时 fail closed，旧确认自动失效；不得用兼容路径降低 evidence、substance、containment、CAS、journal 或 checkpoint 门。
Kind 路由
| kind | 内部 implementation | Agent 填写契约 |
|---|
paper | .agents/skills/unit-analyst/scripts/paper.py | Agent 选择 method_system / benchmark / survey，填写类型理由与对应五要素；类型和每个要素都需逐字 evidence。未选分支保持空。 |
repo | .agents/skills/unit-analyst/scripts/repo.py | 机械 structure scan 后，Agent 填 capability / reuse_points / entry_map；每项引用本地冻结源码的真实 file:line。 |
dataset | .agents/skills/unit-analyst/scripts/dataset.py | Agent 填 positioning / composition / schema_access / suitability_risks；每项引用冻结数据卡或 parse-cache。 |
blog / human note | .agents/skills/unit-analyst/scripts/blog.py | Agent 填 positioning / key_points / credibility / reusable_explanation；每项引用冻结 HTML、Markdown 或 parse-cache。 |
四个 canonical implementation 都归属本 skill；其持久协议 owner 仍分别是 paper-analyst、repo-analyst、dataset-analyst、blog-analyst。不要迁名这些逻辑身份，也不要复制一层 facade receipt。旧四个 skill 资源目录已删除；这些 owner 名只作为 record、preference、journal、receipt、provenance 与 diagnostic 的持久协议身份保留。
Agent 流程
- 确认 canonical unit 已有可用的冻结 source；没有则交
source-intake，不要创建空分析。
- 按 kind 调用上表 implementation 的 prepare。repo 可先执行纯机械 structure scan；paper 的 figure/structure 操作也只能产生机械索引。
- Runtime Agent 阅读完整材料，只填写该 kind 的必需槽位，并逐条挂合法 evidence。
- 用同一 implementation verify；失败时修正 fill 或重新 prepare，不能绕过验证直接写 record。
- 用
kb review 向用户呈现已经 verified 且 current 的判断；确认与拒绝仍由统一 public review adapter 执行。
路由边界
- 新来源或仅入库：
source-intake。
- 多来源 survey、taxonomy、趋势与研究缺口：
literature-synthesizer。
- 只查现有知识库、术语或治理状态：
kb-cli / knowledge-base-manager。
- 需要符号级 repo 深读或图表解释时，Agent 可按需扩展当前 note，但仍须引用真实源码或 source evidence。
默认完整填写当前 kind 的全部要素；只有用户明确要求时才调整阅读侧重，不能因此省略必需槽位。
