Skip to content

统一技能步骤提示，醒目说明正在做什么及为什么 #112

New issue
New issue
Closed
Closed
统一技能步骤提示，醒目说明正在做什么及为什么#112

Description

@mindcarver
mindcarver
opened on Nov 3, 2026

结果与范围

让全部 13 个 Thinloop 技能在关键步骤开始前醒目展示当前做什么及为什么做，直接调用子技能也生效。只调整沟通指令与配套文档/版本，不改变技能权限、路由或交付门。

方案与确认

采用共用步骤沟通参考，全部技能入口必须读取。默认以带图标和等号边框的文本块展示「第几步」「当前步骤」「做什么」「为什么」。在阶段切换、方向变化、等待或阻塞时更新，不为每个工具调用重复展示；原因说明与当前任务有关的目的或风险，不输出内部推理链，不虚构总步数。
方案确认：需要确认：否；状态：默认免确认。状态：DONE。

验收与任务

  • A1：13 个入口（包括直接调用）均加载统一规则；同一步连续工具操作不重复刷屏。
  • A2：展示模板包含当前步骤编号（任务内连续、切换子技能不重置）、步骤图标、🎯 行动、💡 原因、醒目边框、中文任务名、做什么、为什么；未知总步数不编造，阻塞说明缺失与原因。
  • A3：现有路由/权限/确认/独立验收门不变；仓库检查通过，独立验收覆盖实际模拟输出。
  • A4：合并 main，检查并刷新已安装客户端，完整核对技能与支持的 hooks，无法验证项如实报告。
  • T1：统一步骤沟通规则并接入全部入口。
  • T2：更新版本/说明及针对性契约测试并执行仓库验证。
  • T3：独立验收、PR、合并、同步客户端及精确清理。

验证

A1–A4 已完成，逐项直接证据、独立验收与客户端核对见最终审计评论。

完成审计

验收闭合：A1–A4 PASS。实施账目：T1–T3 DONE。交付状态：PR #113 已合并，main 844203a、安装核验和任务资源清理完成。页面验收：N/A，本次为技能指令文本。

Activity

  1. mindcarver commented on Nov 3, 2026

    @mindcarver
    mindcarver
    on Nov 3, 2026
    OwnerAuthor

    候选完成审计（独立验收/合并前）

    • Issue 统一技能步骤提示，醒目说明正在做什么及为什么 #112；PR 统一步骤提示：图标、当前编号、行动与原因 #113；分支 codex/112-step-explanations；基线 5fc0889；候选 c3bbe5d。
    • A1：13 个入口在工作流前加载唯一共用参考，相关契约检查通过。
    • A2：步骤图标、数字编号、🎯行动、💡原因、等号边框、连续编号/未知总数/阻塞/不刷屏检查通过；独立场景验收待回填。
    • A3：362 个仓库测试通过；后续图标/编号补充的相关 7 项检查通过；11版本面、路由、4组定义验证、2个dry-run、delivery protocol、README图和Claude严格验证通过；CI和独立验收待完成。路由/权限/确认/交付门未修改。
    • A4：合并及客户端核验待完成。合并前基线 Codex/Claude/ZCode 均 PASS；其他 skill links 完整，OpenCode runtime/DSH hook 静态检查为 MANUAL，继续取运行时证据，不把 MANUAL 写为 PASS。
    • T1 DONE；T2 DONE；T3 进行中。
    • 页面验收 N/A：技能沟通指令，不包含产品页面变化。
    • 独立验收实际调用标识 /root/accept_112，目标 c3bbe5d，尚未返回。
    • 清理所有者：父 QuickDev；工作树 /Users/carver/workspace/mindcarver/thinloop-wt-112；本地/远端分支 codex/112-step-explanations；本任务无 current.md。

  2. mindcarver commented on Nov 3, 2026

    @mindcarver
    mindcarver
    on Nov 3, 2026
    OwnerAuthor

    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 执行其全部现有工程检查。

  3. mindcarver commented on Nov 3, 2026

    @mindcarver
    mindcarver
    on Nov 3, 2026
    OwnerAuthor

    最终完成审计（2026-11-03）

    • Issue 统一技能步骤提示，醒目说明正在做什么及为什么 #112；PR 统一步骤提示：图标、当前编号、行动与原因 #113 已合并；独立验收目标 c3bbe5d；main/远端 main 均为 844203a。
    • 验收闭合：A1 PASS（13入口强制共用规则、直接调用）；A2 PASS（图标/等号框、当前数字编号、行动与原因、跨技能连续编号、未知总数、不刷屏和阻塞四情景）；A3 PASS（362/362测试、全部现有工程检查及远端 Thinloop CI 通过，原技能规则逐字保持）；A4 PASS（以下安装、main核对及精确清理证据）。
    • 独立验收：实际调用新上下文 /root/accept_112，返回 PASS；逐项证据和四类实际提示见本 Issue 上一条完整验收评论，PR 同步保存。页面验收 N/A。
    • 实施账目：T1 DONE（共用参考与13入口）；T2 DONE（0.18.1各版本面、文档及契约检查）；T3 DONE（独立验收、合并、安装与清理）。
    • main 验证：git merge-base --is-ancestor c3bbe5d HEAD 成功；候选至 main 的任务载荷与文档/测试差异为空；main 版本11面与步骤契约复核通过。
    • 安装：Codex/Claude Code/ZCode 的 verify-install 均 PASS 0.18.1，13技能完整；Claude/ZCode 各2个支持Hook完整且匹配。Codex刷新源码链接；Claude原生marketplace/update刷新；ZCode既有RPC刷新失败后重新只读确认仍旧版，改用当前宿主支持的原生命令 zcode plugins marketplace update thinloop、zcode plugins update thinloop@thinloop，成功后只读复核全PASS。未升级宿主或更改市场来源。
    • 其他已安装客户端：Pi/CodeWhale/Reasonix 的源码链接、版本、技能、能力检查PASS。OpenCode/DSH的13源码链接和版本PASS。统一检查器对OpenCode运行时及DSH复杂YAML保留MANUAL，未将该输出改写为自动PASS；已补充直接核验：opencode debug skill重定向完整JSON后解析，发现13个Thinloop技能且13个均包含新入口；dsh --profile web --dump-config退出0，用安全YAML解析（不执行!!js）确认唯一thinloop-continuity条目指向本仓库handler，条目及祖先均无disabled。安装配置证据已齐全，未声称真实会话中Hook事件已触发。WorkBuddy按约定SKIP。
    • 清理：工作树 /Users/carver/workspace/mindcarver/thinloop-wt-112 已在干净状态移除；本地分支 codex/112-step-explanations 已删除；显式删除同名远端分支后 git ls-remote --heads origin codex/112-step-explanations 空输出；本地/远端main一致；本任务未创建current.md。主检出原有.playwright-mcp/及两张DSH图片保持原样。
    • 三本账：验收、实施、交付闭合。无剩余阻塞。真实用户体验验收留给用户；既有运行会话需重新加载或新建后读取指令，不保证所有模型每次遵从。
  4. mindcarver
    closed this as completedon Nov 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions