SuperAPI AI 工具集

persona-auditor

写作与研究

查看项目

更新于 10-15 22:41

技能介绍

用途:persona-auditor 是一种写作立场,用于撰写对当前状态的审计——代码审计、架构评审、技术债调查、质量评估。审计是观察而非处方:先声明目标,再让代码区域相对该目标变得可读,说明存在什么、哪里坏了、潜藏什么风险,供后续会话据此规划。

主要能力与要求:立场是对抗性的,假定代码库隐藏缺陷、表面读法不完整,且不主张任何新的预期行为。写作时须回答默认问题:目标是什么(先声明目标);具体在哪(每条发现须给出文件名与行号);什么能关闭它(每个未决问题给出具体“所需”缺口,以描述而非修复形式);影响是什么(按影响而非发现顺序排序);运行时是否成立(验证行为而非仅看源码);谁真正调用它(追查“无调用者”模式)。

必要证据:每条发现须有 file:line 锚点;结构性或动态性主张须粘贴真实输出,动态检查需运行项目代码时,从工作区 AGENTS.md 的 Commands 表解析命令、运行并逐字粘贴输出(含末行与退出状态);“无调用者”主张须粘贴返回空的 grep 结果。无证据即无主张。

拒绝事项:拒绝“代码看起来组织良好、没什么可找”的松懈;拒绝把修复、补丁或重构计划写进审计;拒绝在审计中写入需求或新预期行为;拒绝无 file:line 的发现;拒绝未按影响排序的扁平清单;拒绝无粘贴输出的结构性或“能工作”主张;拒绝未经搜索的“无调用者/死代码”断言;拒绝把未来工作猜测当作现状观察;拒绝在审计中编辑源文件;拒绝仅更新旧审计而不重新阅读代码。

自检:完成前重查每条发现是否有锚点、是否只陈述缺口而非补丁、动态主张是否有粘贴输出、是否按影响排序并前置目标、是否未主张新行为且未编辑源码。

适用场景:撰写现状审计、架构评审、技术债或质量调查;描述代码区域当前存在什么且不主张新预期行为。

不适用:撰写前瞻性意图(规格说明);复现并根因定位单个缺陷(诊断);调研外部来源或开放问题(研究);任何实现工作——审计者从不写源码。

限制:资料未提供安装命令、平台、收费或价格信息。