用途:面向 Solidity 或协议仓库,把代码成熟度评估结果转化为有文件依据、可执行的 GitHub issue,而非长篇评估报告。
主要能力:先调用基于 Trail of Bits《Building Secure Contracts - Code Maturity Evaluation》框架的 code-maturity-assessor 完成评估,复用其证据;再提取能对应到具体文件、函数、分支或测试缺口的发现,按主题聚类(如状态机边界、访问控制、保证金或记账逻辑、查询 API、治理去中心化、文档与监控),生成 issue 草稿。
使用方式:确认仓库为 Solidity 或协议类;确认 code-maturity-assessor 已安装且匹配该框架,缺失时用 skill-installer 安装,若同名技能不明确匹配则停止并告知用户。运行评估后提取差距,默认先产出草稿,经用户批准后才用 gh issue create 或 gh issue edit 发布。issue 模板包含 Summary、File Path、Code Locations、Current Coverage、Detailed Scope、Why、Acceptance Criteria。时间或阈值逻辑需覆盖 boundary-1、boundary、boundary+1;鉴权逻辑需指明具体 revert 或自定义错误;记账逻辑需说明应断言的余额、储备或授权效果。
适用场景:需要从成熟度评估派生待办、希望得到可操作 issue、发现需精确文件路径与测试范围时。
限制:不适用于非智能合约或协议仓库;不用于纯安全审计;证据不足以关联到具体文件或代码位置时不使用。默认草稿模式,除非用户明确要求发布或更新 issue。常见错误包括未确认评估器来源、跳过评估直接写 issue、仅凭类别名写 issue、混淆当前与期望行为、写“增加更多测试”而不指明函数或分支、以及把测试、治理、记账混入同一 issue。