AGENT SKILL

fresh-eyes-loop

发布后独立质量循环——单盲四角色流水线(A 审 12 视角 → B 修 → C 验 → D 复核),每轮新 session 保证零上下文,连续 2 轮无 P0/P1 即停。

License 许可
MIT
最近更新
2026-11-13
Stars
★ 56
Forks
10

01 前言 Front Matter

name
fresh-eyes-loop
color
#16B8F3
emoji
🔍
version
1.9.0
description
发布后独立质量循环——单盲四角色流水线(A 审 12 视角 → B 修 → C 验 → D 复核),每轮新 session 保证零上下文,连续 2 轮无 P0/P1 即停。

02 资源文件 33

03 SKILL.md 正文

fresh-eyes-loop · 质量循环定义

一个循环 = 一轮又一轮的"独立审查 → 修复 → 验证",直到干净为止。

这不是检查清单,是一套让独立性可被重复执行的机制。每一轮都用全新 session 跑(零上下文),所以"作者自己看不出问题"这个人类弱点被结构性消解。

这是什么

一套可复用的质量循环定义。它描述:谁来做(单盲四角色:A 审 / B 修 / C 验 / D 复核)、每一轮怎么走(审查 → 修复 → 验证 → 复核)、什么时候停(连续 2 轮无 P0/P1)、产物放哪(runs/YYYY/MM/DD/run-NN/)。

  • A = 审查者(单盲):独立跑 12 视角审查;发现的质量由下游 C 验收 / D 复核把关(legacy 双盲 B 并行审查走 FORGE_ENABLE_B_CHECK=1 逃生门)。
  • B/C/D = 工程师执行修复(现行 B 侧为复核模式——独立复核 A 的 P0/P1,可推翻可补充)/ 验收者逐条实测验收(不采信修复自报)/ 复核者对 P0/P1 裁决 CONFIRM / DOWNGRADE / REOPEN。
  • 编排者(非 agent):在角色间中转、维护 runs/ 文件、判定停止条件。编排者 = 一次 harness session 本身(WorkBuddy 有人值守 / DSH 无头 / Codex headless),注入 loop.md「执行形态」节的主任务协议即跑——不存在第二种编排形态(driver 多轮编排循环已随整合归一删除,经验沉淀于 FORGE/lessons/driver.md)。

怎么用

  1. 读 loop.md 拿到完整 SOP(角色 / 轮次协议 / 产物 schema / 停止条件)。
  2. 12 视角的定义见 playbook/fresh-eyes-review.md(A 按它跑)。playbook 共 22 视角六层:1-12 常规发版(driver 循环标准配置)、13-14 文档治理(手动)、15-16 全文档通读(手动/草稿工具)、17-19 动态面(跨组件契约/构建产物/执行证据——需跨包追踪或 build/实跑取证,worker 工具面实测仅 sf_read / sf_write / run_bash 三件,跨包构建取证超其超时预算,发版审查建议手动追加)、20-21 深度专项(季度全仓体检)、22 发现面(门面改动时)。 loop 与工具的视角边界以 playbook 分层表为准——playbook 演进(如新增视角/调整分层)时,本文件与下游工具同步对齐。
  3. 四角色的行为指令在 prompts/(a-check / a-consolidate / b-fix / b-audit / c-verify / d-review;b-check 为 legacy 双盲逃生门 FORGE_ENABLE_B_CHECK=1 时启用)。
  4. b-audit 步骤:b-fix 改完代码后执行器自动跑 sofagent audit --full --diff——审计每次变更,自用先行铁律。audit FAIL(exit 2)打回 b-fix 重修,不进 c-verify。
  5. 跨 run 的永久索引在 FORGE/LEDGER.md(被 git 跟踪);每轮正文在 runs/(不进 git)。

实现载体

编排者 = harness session 本身(注入主任务协议即跑,协议 SSOT 见 loop.md「执行形态」节)。角色执行三通道任选:① 编排 session 自身(仅首个角色)② 执行器单步 node FORGE/src/fresh-eyes-driver.mjs --worker --step <step> --round-dir <abs> --target <ver>(DSH 后端;worktree 隔离经 FORGE_WORKTREE_ROOT 环境变量由编排方建立并注入; 内置 stall 守卫、工具软硬熔断、报告质量门控、零发现假绿检测)③ 有头 session 的 subagent。

工具面机制事实(FORGE/lessons/architecture.md):执行器走 DSH CLI 桥接时,sofagent 自定义工具(sf_read / sf_write / run_bash)在子进程边界不生效——角色实际使用 DSH 自带 bash/fs 工具链,能力等价(读文件/写文件/跑命令)。审查所需证据由 prompt 注入或角色自行 bash 取证。

机器守闸:tools/check/check-fresh-eyes-artifacts.mjs(产物契约校验 = 编排者停止条件判定的机械面)。

🔴 编排权归属铁律

编排 = harness session 本身(注入主任务协议、逐角色调执行器、落盘、判收敛)——不得把编排委托给任何长驻编排进程。历史上的 driver 多轮编排循环因此退役:主 session 内嵌套拉起长生命周期进程树,用户打断 session 时级联 SIGTERM 会杀掉整棵树,run 产物丢失(与 release-gate-loop 实证同机理)。编排 session 自身被中断无需恢复进程——状态全在 runs/ 文件里(文件即状态),新 session 注入同一协议即断点续跑。

长跑监督(无人值守 DSH 场景,编排方自查三条):

  1. 轮询现态锚:读 runDir 的 status.md(每轮一行,含 phase 与 P0/P1 计数)——phase 变化才汇报,同一状态不重复说话。
  2. 产物真实性抽验:报告数量增长 ≠ 有效产出。 find <roundDir> -name 'check-*.md' -size -1k(1KB 以下 = 疑似占位骨架),命中即 cat 验内容;收口仍未回填的视角按修复批协议补跑该视角(不必全量重跑)。
  3. 中止必归档:任何原因中止的 run(进程死亡 / 人工停止 / 环境冲突)也必须在 FORGE/LEDGER.md 补一行(aborted-<死因简述>)——没有终态记录的 run 是审计黑洞。

循环级演化

evolution.md 记录对这套循环本身的改进建议(人类门控的"加一减一"),防止 specs 越长越烂。

04 同仓库更多 Skills

KongFangXun
KongFangXun/sofagent

enterprise-fde-识别AI节点

当 FDE 需要对工作流节点做 AI 分类判定时用这个 Skill—— 不是"它是干什么的",是"什么时候用"。 写错 description = Skill 永远不会被触发。

★ 56
KongFangXun
KongFangXun/sofagent

cordis-plugin-sofagent

一次挂载 sofagent 全套能力——6 项能力一次到位(注入 · 审计与验收 · 经验 · 回溯 · 巡检 · FDE 三域)(seam: non-seam:plugin-suite)——只编排不重实现——sofagent 约束层在 DSH(DeepSeek Harness)生态的插件形态。

★ 56
KongFangXun
KongFangXun/sofagent

cordis-plugin-sofagent-rsi-corpus

语料管道 tool 集——脱敏 L0/L1 + 三分拣(SENSITIVE/JUDGEMENT/ABSTAIN),与出厂基准逐字节等价(golden 锁定)(seam: non-seam:tool-set)——桥接 @sofagent/rsi-corpus runPipeline——DSH(DeepSeek Harness)cordis plugin。sofagent 约束层在 DeepSeek Harness 生态的插件形态。

★ 56
KongFangXun
KongFangXun/sofagent

cordis-plugin-sofagent-rollback

出错逆序撤销——git snapshot → effect disposer(seam: agent/error)——桥接 @sofagent/core getHistoryFilePath——DSH(DeepSeek Harness)cordis plugin。sofagent 约束层在 DeepSeek Harness 生态的插件形态。

★ 56
KongFangXun
KongFangXun/sofagent

cordis-plugin-sofagent-inject

启动注入企业约束——四层加载链(seam: agent/pre-step)——桥接 @sofagent/inject buildConstrainedSystemPrompt——DSH(DeepSeek Harness)cordis plugin。sofagent 约束层在 DeepSeek Harness 生态的插件形态。

★ 56
KongFangXun
KongFangXun/sofagent

cordis-plugin-sofagent-fde

FDE 进场与能力流通——把企业业务梳理成 AI 能力,并让这些能力在企业内被发布、发现、调用、评价、退役(seam: non-seam:tool-set)——桥接 @sofagent/orchestrator publishCapability / @sofagent/ontology generateOntologyView / @sofagent/core restoreSnapshot——DSH(DeepSeek Harness)cordis plugin。sofagent 约束层在 DeepSeek Harness 生态的插件形态。

★ 56