thun-res/vlink / .agents/skills/sync-review
sync-review
Verified审计 VLink 代码、doc、Doxygen、Python/C API、测试、示例、版本、 CMake、conanfile.py、Android.bp、vcpkg、packup 构建打包面、Agent 索引以及 .github 的 workflows、scripts、Docker、模板、Wiki 与治理 文件同步关系,定位 API、功能或工程入口变化后的遗漏和过时描述。公开 API、功能入口或文档结构变化时必须使用;用户要求"检查文档同步"、 "API 改了查遗漏"、"同步构建打包"、"同步 .github"、"同步审计"或 发版前核对时使用。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.0 KB |
| agents/openai.yaml | config | 246 B |
| references/API-SURFACES.md | markdown | 2.2 KB |
| references/BUILD-PACKAGING-SURFACES.md | markdown | 4.5 KB |
| references/CHANGE-SCOPE.md | markdown | 1.6 KB |
| references/CROSS-CHECKS.md | markdown | 3.5 KB |
| references/GITHUB-SURFACES.md | markdown | 6.2 KB |
| references/REPORTING.md | markdown | 1.4 KB |
references/API-SURFACES.md
View on GitHub# API 与使用面同步
对每个受影响的公开类、方法、函数、枚举、宏、URL 参数或功能入口逐项
核对。
## 注释与文档
- Doxygen 的签名、参数名、默认值、返回值和既有异常说明与实现一致;
新增成员不漏注释,删除成员不留残余。
- 按 `.agents/REPO-REFERENCE.md` 定位 `doc/` 章节,核对示例、参数表、
默认值、scheme 和跨章速查表。
- 文档结构或标题变化后,同步检查站内链接、Agent 小节引用和图片说明。
## C API 与 Python API
- C API 的声明、实现、ABI、错误码、所有权说明、C 示例和测试同步。
- `languages/python_api/` 各功能 `.cc` 的绑定与 C++ 签名一致;`vlink.py` 包装、docstring、
默认参数和导出列表同步。
- 新公开 C++ API 是否需要暴露到 C/Python 必须有明确结论;不暴露时说明
产品或兼容性理由。
- `languages/python_api/test/` 与 `languages/python_api/examples/` 覆盖对应绑定和推荐用法。
## API、ABI 与 SemVer
- 删除或改名公开符号、修改签名/默认值、改变 enum 既有值、公开 struct
布局、URL 参数、CLI flag、CMake target、C API 返回码或环境变量名时,
核对 `doc/15-contributing.md` §15.17 的兼容性分类。
- 破坏性 API/ABI 变化必须与 MAJOR 版本、CHANGELOG 和 PR 说明一致;
`zerocopy` 线格式即使升级 MAJOR 也不得改动。
- 新增公开符号、enum 末尾值或向后兼容选项至少属于 MINOR;PATCH 只能
修复问题,不得改变 API/ABI。弃用标记须写明替代 API 和引入版本。
- 未经构建或 ABI 对比不能宣称二进制兼容;只报告静态可证结论。
## 测试与示例
- 新行为有有效断言;既有行为变化时更新旧断言,不得只删除失败用例。
- `test/`、`languages/c_api/test/`、Python 测试与公开接口层级匹配。
- `examples/` 代码和 README 使用当前推荐 API,能体现最新入口、参数和
错误处理。
- 只静态审计时不得声称示例可编译或测试已通过。
## 变更摘要
重要特性、修复、破坏性变化、弃用和可感知性能变化检查
`CHANGELOG.md`;琐碎内部改动无需堆砌。版本标题变化不能代替内容条目。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |