Skip to content

统一步骤提示:图标、当前编号、行动与原因 - #113

Merged
mindcarver merged 1 commit into
mainfrom
codex/112-step-explanations
Nov 3, 2026
Merged

mindcarver merged 1 commit into
mainfrom
codex/112-step-explanations

Conversation

@mindcarver

Copy link
Copy Markdown
Owner

结果

全部 13 个 Thinloop 技能在关键步骤开始前,以带图标和等号边框的文本块说明当前第几步、做什么以及为什么做。任务内连续编号,切换子技能不重置,同一步连续工具调用不重复刷屏;未知总步数只显示当前编号。

共用一份沟通参考,各入口执行前加载;版本同步为 0.18.1,更新安装说明与发布说明。路由、权限、确认和交付门保持有效。

验证

  • 仓库 362 个测试通过;用户补充图标/编号后相关 7 个测试复核通过。
  • 11 个版本面、路由同步、评测定义、Knowledge/Thinloop dry-run、隔离交付 protocol、README 图、Claude 严格插件验证通过。
  • 独立新上下文验收已实际调用 /root/accept_112,目标 c3bbe5d,结果待回填。
  • 指令行为仍受宿主/模型影响,既有会话需重新加载或新建;真实使用验收留给用户。
  • 无页面或生产部署变更。合并后核验客户端与任务清理。

Refs #112

@mindcarver

Copy link
Copy Markdown
Owner Author

Thinloop #112 独立验收

  • 验收者:/root/accept_112,独立于实施者的新上下文子 Agent。
  • 日期:2026-11-03。
  • 仓库:/Users/carver/workspace/mindcarver/thinloop-wt-112。
  • 基准:5fc0889;候选:c3bbe5d5869c6e93a3a84370c7d09f2f914f25b7。
  • 亲读来源:仓库 AGENTS.md、实时 gh issue view 112 --json number,title,body,state,url、完整 git diff 5fc0889..c3bbe5d、全部 13 个入口的头部、候选 scd-next 与 scd-quickdev 完整技能、共用 step-communication.md、Next status-contract.md、QuickDev evidence-contract.md/release-contract.md/issue-delivery-contract.md。
  • 独立观察 PR:gh pr list --state all --search '112 in:body' --json number,title,state,headRefOid,url 返回开放 PR 统一步骤提示:图标、当前编号、行动与原因 #113,head 为上述候选。
  • 结论:PASS(候选工程与情景验收)。A4 为父 Agent 后续交付条件,尚未验收,不构成已完成 Issue 的结论。

验收映射

项 结论 直接证据
A1 PASS 13 个 SKILL.md 均在首个工作流章节之前要求必须读取同一实际可解析文件,直接调用同样适用;全部入口契约测试通过。下方 S1 直接 Next 启动、S3 同一步多工具实际应用均符合。
A2 PASS 下方四类输出均有实际数字、中文任务名、动作图标、等号边框、🎯 做什么、💡 为什么;S2 从既有第 2 步续至第 3 步;S3 不为工具调用重发提示;S4 说明缺失、推进影响和下一行动,未知总数只写当前步。
A3 PASS 完整测试 362/362 通过,其余 CI 本地命令全部退出 0;原 13 个技能去除新增两行后与基准逐字相同;路由、hooks、scripts、原权限/确认/验收参考无差异;四类模型情景应用见下文。
A4 待交付 / UNVERIFIED 未执行合并 main、刷新客户端或支持 hooks 终态核验;本验收者未修改用户配置。由父 Agent 合并后提供独立已验收差异进入 main、安装载荷/版本/完整技能/支持 hooks 与清理证据。A4 不得在此文件基础上标记完成。

实际情景应用

方法:本独立模型亲自加载候选技能和共享参考后,针对以下明确输入生成会发给用户的提示;没有复用实施者提供的样例。S1/S3 使用本次已执行的只读读取/验证路径,S2/S4 是明确标识的受控上下文场景,不把假设上下文或故障写成本机事实。此为当前模型的直接规则应用证据,不是多宿主、多模型遵从率测量。

S1:直接调用 scd-next

输入:用户直接调用 scd-next,只询问 Thinloop Issue #112 当前状态;新任务,尚未展示步骤。

读取:候选 scd-next/SKILL.md、references/status-contract.md、共用步骤沟通参考。

将展示的首条进度:

======= 🔎 第 1 步:核对步骤提示任务的实时状态 =======
🎯 做什么:读取 Issue #112、关联拉取请求与验收记录,核对当前可继续的行动。
💡 为什么:任务是否完成取决于实时交付证据,单独的提交不能证明验收和安装已经完成。
================================================

对应实际只读路径:已读取 Issue #112 和关联 PR #113;不创建或修改跟踪器状态,不启动实施,不从本地提交推出 DONE。

判定:PASS。直接调用也先呈现提示;数字是 1,无总数,无权限扩张。

S2:跨技能继续,已有第 2 步

受控输入:同一任务上一条已展示「第 2 步:核对 Issue #112 交付边界」,用户随后明确要求继续该 Issue 的候选验证;从 scd-next 转至 scd-quickdev。不是让 Next 自行执行建议。

读取:候选 scd-quickdev/SKILL.md、evidence-contract.md、共用步骤沟通参考;保留上一条已观察编号 2。

将展示:

======= 🧪 第 3 步:验证统一步骤提示的候选改动 =======
🎯 做什么:转入 scd-quickdev,运行 Issue #112 的入口契约检查与仓库完整测试。
💡 为什么:状态检查已经明确了交付边界,继续实施验证需要直接检查候选规则和现有行为是否一致。
================================================

判定:PASS。当前数字为 3,切换技能不重置为 1;说明切换后的行动及目的;不因切换取消后续独立验收或交付门。

S3:同一步连续工具操作

输入:当前处于第 3 步候选验证;将执行版本核对、完整测试和路由漂移检查,均服务于同一行动。步骤开始只展示一次:

======= 🧪 第 3 步:验证统一提示的兼容性 =======
🎯 做什么:检查版本一致性、运行全部仓库测试,并核对路由生成内容。
💡 为什么:确认新增提示规则没有破坏现有技能契约,且各发布载体保持一致。
==========================================

随后工具轨迹及用户消息:

  1. node scripts/check-version.mjs → 不额外发送步骤块。
  2. node --test tests/*.test.mjs → 不额外发送步骤块。
  3. node scripts/sync-routing-kernel.mjs --check → 不额外发送步骤块。

实际执行结果分别为 PASS version 0.18.1: 11 surfaces、362 tests / 362 pass / 0 fail、routing kernel check passed (8 routes, 4 generated surfaces)。这三个工具均确已在本次验收执行。

如出现值得告知的同一步进度,则发送一次简短更新而不重发三行模板,例如:

第 3 步进度:版本和路由核对已通过,完整测试仍在执行。

该句是受控运行中间态示例,不声称本次最终测试尚在执行。

判定:PASS。连续工具操作只对应一次步骤块;同一步进度保留数字 3,不递增、不重复完整提示。

S4:遇到阻塞且总步数未知

受控输入:此前已展示到第 3 步;只读 Next 检查中,权威 GitHub Issue 无法读取。该故障仅为情景输入,本次实际 GitHub 读取成功;尚不知道解锁后还需多少步。

读取:候选 scd-next/SKILL.md、status-contract.md、共用步骤沟通参考。遇阻塞产生新的有意义步骤,递增至 4。

将展示:

======= 🚧 第 4 步:等待权威状态恢复可读 =======
🎯 做什么:记录 Issue #112 无法读取的阻塞,下一行动是在读取能力恢复后重试一次只读核对。
💡 为什么:缺少权威 Issue 与验收记录时无法确定任务状态,本地提交不足以支持完成或继续交付的判断。
============================================

紧随的状态说明:UNVERIFIED:权威 GitHub Issue #112 无法读取;本地记录仅作支持证据。 如此前已有用户确认请求,该请求继续待确认,不视为得到授权。

判定:PASS。当前数字 4,无 /M、百分比或捏造流程总数;明确缺失来源、影响和恢复后下一行动;不更改认证配置、不索取或输出凭据、不把解释当授权。

可复现检查

以下命令均在候选工作树运行并成功退出 0(完整测试统计直接取自测试器):

cd /Users/carver/workspace/mindcarver/thinloop-wt-112
git rev-parse HEAD
git diff 5fc0889..c3bbe5d
node --test tests/*.test.mjs
node scripts/check-version.mjs
node scripts/sync-routing-kernel.mjs --check
node evals/validate-discovery-cases.mjs
node evals/validate-knowledge-cases.mjs
node evals/knowledge/validate.mjs
node evals/thinloop/validate.mjs
node evals/knowledge/runner/run.mjs --mode dry
node evals/thinloop/runner/run.mjs --mode dry
node evals/delivery/run.mjs --mode protocol
node scripts/generate-readme-diagrams.mjs --check
npm exec --yes --package=@anthropic-ai/claude-code@2.1.197 -- claude plugin validate . --strict
git diff --exit-code 5fc0889..c3bbe5d -- AGENTS.md config/routing-kernel.json hooks scripts skills/scd-quickdev/references/release-contract.md skills/scd-quickdev/references/scope-contract.md skills/scd-next/references/status-contract.md
git status --short

结果:362 tests、362 pass、0 fail、0 cancelled、0 skipped、0 todo;版本 0.18.1 的 11 个载体通过;路由 8 routes/4 generated surfaces 通过;Knowledge dry 5 cases;Thinloop dry 7 cases/3 conditions;delivery protocol PASS;Claude strict validation passed;最终工作树 git status --short 无输出。

原技能规则逐字保持检查:

// 在仓库执行:node --input-type=module(下列脚本)
import fs from 'node:fs';
import cp from 'node:child_process';
for (const name of fs.readdirSync('skills').filter(n => n.startsWith('scd-'))) {
  const file = `skills/${name}/SKILL.md`;
  const base = cp.execFileSync('git', ['show', `5fc0889:${file}`], {encoding: 'utf8'});
  const candidate = fs.readFileSync(file, 'utf8');
  const stripped = candidate.replace(/^开始执行前必须先读取并遵守\[步骤沟通\]\([^\n]+\n\n/m, '');
  if (stripped !== base) throw new Error(`Existing rules changed: ${name}`);
  console.log(`PASS unchanged original rules: ${name}`);
}

实际输出为全部 13 个技能 PASS。原路由/权限/确认/独立验收门内容保持原样,新参考最后明确声明只调整用户可见沟通。

三本账与限制

  • 实时读取时 Issue 正文仍把 A1–A4、T1–T3 和交付审计列为待完成;本报告只补充候选工程和独立情景证据,父 Agent 应将真实结果映射回 Issue。
  • T1/T2 候选内容与工程验证已有直接证据;T3 尚含父 Agent 的 PR/合并、客户端刷新、main 核对和精确清理。
  • A4、合并版本、客户端终态、必需远端检查的最新结果以及资源清理,均不得由本报告推断为 PASS。验收者未刷新客户端、修改用户配置、访问生产或修改产品代码。
  • 当前模型对四类场景的直接输出可复核;未开展每个宿主/每个模型的重复行为试验,不保证指令在所有环境每次都遵从。既有运行会话是否重新加载规则需要在真实客户端使用时确认。
  • 本次为技能指令文本,页面浏览器验收 N/A。仓库无 package.json 或额外 compile/build 步骤;按 .github/workflows/ci.yml 执行其全部现有工程检查。

@mindcarver
mindcarver merged commit 844203a into main Nov 3, 2026
1 check passed
@mindcarver
mindcarver deleted the codex/112-step-explanations branch November 3, 2026 09:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant