Skill）¶

面向 AI agent 的机器接口约定。Human DX（彩色 help、交互确认）保留；Agent DX 强调可预测、可自省、默认瘦输出。

已落地（Phase 2 / 精简 3 / 4）¶

项	位置
Curated ops 目录	`agentero-core::ops`
CLI 自省	`agentero describe [op] --json`
同源 invariants	`ops::agent_invariants_markdown()` → MCP resource + Skill 指针
layout-index 共享解析	`agentero-core::features::pdf::layout_index`
MCP 瘦 `paper_list` + `fields`/`full`	`integration/mcp`
MCP `paper_set_read` / `layout_list` / `layout_get`	同上
MCP `file_list` / `file_read` / `file_write`	Vault 内 UTF-8 文本（Papers 外的 `.tex` 等）；拒绝 `.agentero`、二进制、NOTES 直写
MCP `vault_list` + `vault` 参数	列出用户打开过的本地 Vault；工具可切换到其中任意一个，未知名路径拒绝
MCP `paper_paths` / `paper_move`	相关路径与论文库移动；和 CLI 共用 `catalog::paper_related_paths` / `move_paper_under` / `migrate_paper_between_vaults`
MCP `paper_tag_set` / `paper_tag_list`	替换用户标签（保留内部标签）与全库标签清单；和 CLI 共用 core 标签函数
MCP `file_move` / `file_delete`	通用路径链接感知移动；删除默认回收站，`permanent=true` 永久删除；与 CLI `paper delete --files` 共用 core delete
MCP `vault_search`	全库 Markdown 关键词 AND；复用 Host 搜索，沿用 MCP 文件路径限制；返回 path/snippet/line/truncated，见 backend/mcp
MCP resources	`agentero://vault`、`agentero://agent-invariants`、`agentero://skills/agentero-cli`
Skill 削薄	`templates/vault/.agents/skills/agentero-cli` v16（任务分支协议；`describe`/`set-read`/`vault list` 不再默认开场）