用途
ArkWeb Committer 代码检视技能用于从 ArkWeb 项目 Committer 的视角对代码进行严格审查。其检视标准高于普通 code review,重点关注代码是否严格匹配设计文档、是否符合 ArkWeb 架构合规性、是否遵循 Chromium 代码规范与 OpenHarmony 集成规范,以及是否引入安全风险、性能隐患或可维护性问题。
主要能力
该技能按八个维度进行检视:
- 设计一致性:检查实现是否与设计文档中的接口定义完全一致,包括方法签名、参数类型、返回值、类名与文件名对应关系,以及是否存在设计文档未提到的实现。
- 架构合规:检查修改是否位于正确的架构层(API/框架/内核),是否跨越不应跨越的层边界,是否正确使用 ArkWeb 分层调用链路,新增文件是否放在正确目录。
- 代码规范:检查命名规范(类名 PascalCase、方法名 camelCase、常量 UPPER_CASE)、Chromium 编码风格(头文件顺序、include guard、namespace)、注释完整性、代码行长度、缩进与格式。
- 安全性:检查输入校验完整性(空指针、越界、类型检查)、注入风险(字符串拼接 SQL/命令/HTML)、权限检查、敏感数据处理(日志脱敏、内存清零)、沙箱边界是否被突破。
- 性能:检查是否存在不必要的拷贝或序列化、是否在主线程执行耗时操作、内存分配是否合理、是否存在性能热点(循环内分配、锁竞争)、是否正确使用智能指针避免内存泄漏。
- 线程安全:检查是否存在数据竞争、锁粒度是否合理、回调是否在正确线程执行、是否正确使用 PostTask 跨线程调用。
- 兼容性:检查是否影响已有 API 行为、是否正确处理不同 OHOS 版本差异、是否考虑 1+8 设备差异、是否有合理降级策略。
- 可测试性:检查单元测试覆盖率、测试用例是否覆盖关键路径和边界条件、Mock/Stub 是否合理、测试是否可重复运行。
使用方式
该技能支持两种运行模式:
模式 A(Subagent 模式,推荐):作为独立 subagent 被 arkweb-architect 调用时,设计文档路径和代码目录已在 task 描述中提供,直接输出检视报告。输入格式从 task 描述中解析,包括设计文档路径、生成代码目录、代码分析结果路径(可选)。输出为检视报告,保存到指定路径并回复摘要。
模式 B(交互模式):在主 session 中直接调用,由用户指定代码目录和设计文档。
检视流程分为四步:读取设计文档获取接口定义、架构设计与约束条件;遍历生成代码按文件逐个检视并记录发现;将代码实现与设计文档逐项交叉验证;输出检视报告。
报告格式包含基本信息(需求、检视日期、代码文件数、代码行数)、检视结果总览(八维度结果与问题数)、严重问题(必须修复)、建议改进(建议修复)、优秀实践和结论(通过/有条件通过/不通过)。产出物路径为 {DOCS_REPO}/docs/{date}-{feature}-committer-review.md。
Subagent 回复格式包含完成状态、报告路径、检视结果(严重问题数、建议改进数、结论、关键发现)。
适用场景
适用于 ArkWeb 项目的代码提交前审查,特别是需要从 Committer 视角进行严格质量把关的场景。可作为 arkweb-architect 工作流中的独立审查环节,也可由开发者主动调用进行代码自检。
限制
该技能的具体实现细节、依赖环境、安装方式、收费模式等信息暂未提供。