SuperAPI AI 工具集

refine-product-100

通用与其它

查看项目

更新于 11-11 22:14

技能介绍

用途

refine-product-100 是一个面向产品持续改进的 AI 技能,目标是通过反复迭代执行,将产品逐步逼近最高品质。它不是一次性审查工具,而是在每一轮运行中读取上一次的总结,避免重复检查相同视角,自主选择当前最有效的改善轴,并完成具体改善、验证与记录。当用户明确指定 release 模式时,它会在通过质量门后继续执行分发与公开状态确认。

主要能力

  • 自主改善规划:从上次摘要中提取已关闭、仍开放、下一假设与不可重复项,选择与上次不同的主改善轴。只有当出现新证据、未解决 P0/P1 或上次修正验证不足时,才允许重复同一轴。
  • 覆盖矩阵:按目的与适配、功能与状态、输入与数据、输出与阅读面、UI/UX 与可访问性、非功能与运维、安全与安全、集成与契约、验证与质量门、文档与学习路径、AI/自动化资产、清理与产物卫生等轴,将各轴分类为 Covered / N/A / Open,并将 Open 进一步归入 Fix now / Guard now / Block。该矩阵是候选地图,不限制 AI 自主发现问题。
  • 修复周期:包括 Context/Health、Review、Implement/Sweep、Test/Verify、Docs/Cleanup、Close 六个阶段。在可执行模式下每轮必须完成至少一项具体改善(如 bug 修复、UX 文案修正、输入校验、测试新增、文档同步、清理、防护新增),不能仅以审查结束。
  • 状态管理:唯一持久状态文件为 .git/info/refine-product-state.md,采用 compact rewrite 方式更新。状态内容包括 Current Snapshot / Last Run Detail / Open Items / Recent Runs / Do Not Repeat / Next Focus Candidates / Guard or Block,并设有行数与大小上限(Last Run 25 行、Recent Runs 5 件、Open/Do Not Repeat/Guard 各 10 件、Next Focus 3 件、整体 160 行或 16KB)。
  • 分类与安全:将问题分为 Fix now(范围内、可解释正确性、可本地验证、非破坏性)、Guard now(无法直接修复但可通过 test / static guard / docs / checklist 降低风险)、Block(破坏性、外部公开、生产数据、规格判断、权限不足)。同一原因重试最多 3 次,超过后重新分类为 Block。
  • 发布补充:仅在 release / deploy / publish 或同义明确请求时,且针对软件分发物,在通过 typecheck、lint、test、audit、build/pack 等质量门后,执行 commit、tag、push、publish、GitHub Release 与公开确认,并逐项报告 done / skipped / blocked。
  • 输出契约:No-Edit 模式输出 Plan or Findings / Gate / Coverage Matrix Summary / Safe-to-Fix 判定 / Recommendation / Run Ledger;Executable 模式输出 Done / Improvement Focus / Sweep / Check / Findings / Safe-to-Fix 判定 / Coverage Sweep / 100% Pass 判定 / Next Steps / Run Ledger;release 模式额外输出 Release Status。Run Ledger 始终以最多 10 行的 compact form 输出。
  • Handoff:仅在存在 Block、用户决策等待、重要 Guard now 或非平凡恢复路径时输出,包含 Goal / Current State / Open Items / Prior State Used / Recommended Path / Resume Prompt / Do Not 等字段。

使用方式

该技能通过输入 Target(current workspace / all / src / file / folder / product name)、Focus(feature / non-functional / UIUX / security / docs / cleanup / all)和 Mode(空栏 / fix / improve / quick / plan / review / dry-run / verbose / release / deploy / publish)来调用。空栏为 default。plan / review / dry-run 为 No-Edit 模式,仅输出计划或指摘,不修改文件、不创建或更新 state file。verbose / full / 详细为修饰符,在通常模式上附加详细输出。release / deploy / publish 在 default 的质量门后进入 Release Addendum。

适用场景

适用于需要对代码、文档、幻灯片、运行手册、提示词、数据、AI 资产等产品要素进行持续、自主、可验证的迭代改进的场景。特别适合希望在每轮运行中都有具体产出、避免空转审查、并保留可追溯状态与交接信息的团队或个人。

限制

  • 状态文件仅使用 .git/info/refine-product-state.md;若无 .git/ 目录,则记录 Local State: skipped 并说明理由,不创建替代日志。
  • 不写入 raw log、全文 Findings、终端输出、diff、长文 Handoff、secret、个人数据、绝对路径或未验证推测。
  • 发布操作仅在明确 release intent 下执行;若分发对象、版本、公开目标或权限不明确,或需要破坏性历史操作,则作为 Block 等待确认。
  • 存在 Fix now 时不分发。
  • 文档等非软件分发物在 release 模式下跳过。
  • 该技能假定独立运行,不添加 handoffs: frontmatter 或依赖 custom agent 的描述。
  • 子代理仅用于大规模仓库、多视角 Sweep、长日志解析等只读调查;不使用时需在最终报告中说明理由。
  • 本介绍基于所提供资料整理,未提供具体收费、价格、平台支持范围或效果数据。