SuperAPI AI 工具集

@6171/agent-change-ledger

编程与开发

查看项目

更新于 10-16 09:31

技能介绍

用途:当 AI 智能体修改代码、且结果需要可解释、可评审、易回滚时使用本技能。输出是证据优先的变更记录,而非通用代码评审。

输入:接受任意子集,包括仓库路径或 patch/diff、变更请求或 issue 文本、已变更文件及预期影响、已运行命令及输出、测试/检查/类型检查/构建/部署结果、评审人身份与审批状态、回滚或还原流程。不得请求或记录密钥、令牌、密码、私钥或环境文件完整内容,一律以 [REDACTED] 处理。

工作流:一句话陈述意图并列出明确验收标准;盘点增量(新增、修改、删除、生成产物、schema/配置变更、公共 API 变更),区分观察到的事实与声明;按领域映射风险(数据丢失、安全、兼容性、性能、运维、迁移),未知项显式标注;构建验证矩阵(命令、范围、结果、时间戳、证据位置),无输出或可信 CI 结果不得标记通过;应用评审门禁,缺失门禁记为 BLOCKED 而非 PASS;记录回滚动作、有状态数据注意事项与触发信号;按固定格式输出台账并计算最终状态 READY、BLOCKED 或 NEEDS-EVIDENCE。

输出结构包含 ledger_version、change(intent、acceptance_criteria、scope)、risk_register、validation、review_gates、rollback、final_status、open_questions。

规则:优先原始证据与精确命令而非文字保证;缺失测试、评审、回滚细节视为明确缺口,不静默推断成功;台账保持一次可评审的规模,大日志用链接;仅输入 diff 时输出 NEEDS-EVIDENCE,直到提供验证与回滚信息;除非用户另行要求实现,不修改仓库。