Codex Plugin Task Template

# 必读顺序

1. Development Specification
2. Public SDK Reference
3. Manifest Reference
4. Stable Diagnostics
5. Plugin Development Checklist
6. Complete Example Plugin

# 可复制任务模板

为 Aventa BBS 实现一个原生插件。

目标产品行为：<清楚描述>
Package id：<vendor.package>
Package type：<五种公开类型之一>
Version：<SemVer>

开始前按顺序阅读：
1. development-specification.html
2. public-sdk-reference.html
3. manifest-reference.html
4. stable-diagnostics.html
5. plugin-development-checklist.html
6. complete-example-plugin.html

约束：
- 只使用 Public SDK；不得导入非公开 Kernel 类型。
- register() 只做声明；运行时工作只在 RuntimeContext handler/provider 中执行。
- 不使用旧插件运行时 API，不访问其他包的私有数据。
- 不虚构 DataStore 查询、列表或事务接口。
- capability、dependency、event、resource、data ownership 必须先在 manifest 声明。
- optional dependency 必须有确定性 fallback。
- migration id/order/checksum 不可变，APPLIED 不重复执行。
- 保留 KernelException stableCode，不把未知失败当成功。
- 不自行声明 ENGINEERING_VALIDATED。

交付：
- 完整 package 文件树和可运行源码
- manifest.json
- migrations.php（如需要）
- happy path、denial、replay、determinism 测试
- manifest/API/capability/diagnostic 一致性结果
- 已知限制，不得隐瞒或补造接口

# Codex 自检

让代理在结束前逐项说明：使用了哪些公开 API、为什么需要每个 capability、所有 data namespace 的 owner、依赖 fallback、迁移 replay 行为、稳定错误 code、未使用的接口假设、自动校验结果。