/toolbox-lint 命令（全量 L1+L2+L3） #63

Open
Open
/toolbox-lint 命令（全量 L1+L2+L3）#63
Labels
resolvedAutopilot has resolved this issue

Description

@MatthewYe
MatthewYe
opened on Jun 22, 2026

Parent

#60 — 插件安装自检命令 /toolbox-lint

What to build

创建 commands/toolbox-lint.md 命令文件。该命令运行时，agent 执行三层自检并输出结构化的 TOOLBOX_LINT_REPORT。

命令定义

---
description: Verify the toolbox plugin is correctly and completely installed. Runs a three-level self-check — L1 existence, L2 content correctness, L3 functional smoke — and outputs a TOOLBOX_LINT_REPORT with per-item PASS/FAIL/WARN verdicts.
---

三层检查清单

L1 — 存在性检查

项预期
dist/index.js存在
node_modules/存在
agents/implementer.md存在
agents/reviewer.md存在
agents/argus.md存在
commands/ 下至少 6 个 .md（含 toolbox-lint 自身）存在
skills/ 目录非空
upstream/skills/engineering/存在 SKILL.md 文件
upstream/skills/productivity/存在 SKILL.md 文件
principles/karpathy.md存在
principles/karpathy-primary.md存在
Canary skill 文件存在
Canary command 文件存在

L2 — 内容正确性检查

项验证方式
所有 agent .md 有有效 YAML frontmatter + prompt 字段gray-matter 解析
Implementer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Coding"
Reviewer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Judging"
Argus prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Analyzing"
所有 command .md 有有效 frontmatter + descriptiongray-matter 解析
所有 SKILL.md 有有效 frontmatter + name、descriptiongray-matter 解析
karpathy.md 包含全部 4 条 principle子串匹配 "Principal 1" 到 "Principal 4"
自我报告 JSON 可解析读取 + JSON.parse
自我报告中的 agents 数量与文件系统一致交叉核对
自我报告中的 commands 与文件系统一致交叉核对
自我报告中的 skill_paths 三项都存在且可读交叉核对
自我报告中的 upstream_skill_commands 与文件系统一致交叉核对

L3 — 功能冒烟检查

项验证方式
加载 canary skillskill 工具 → 检查返回 CANARY_OK: toolbox skill registration verified
加载上游 engineering skill（如 tdd 或 diagnose）skill 工具 → 成功返回指令
加载上游 productivity skill（如 caveman）skill 工具 → 成功返回指令
调用 canary commandcommand 执行 → 检查输出 CANARY_OK: toolbox command registration verified
调用上游 command（如 /caveman）command 执行 → 正常返回
Dispatch agent（general 做简单任务）task 工具 → 正常返回
bun runtime 可用bun --version → 成功

输出格式

TOOLBOX_LINT_REPORT:
## L1 — 存在性检查
[PASS] dist/index.js
[FAIL] principles/karpathy.md — 文件不存在
...
## L2 — 内容正确性检查
[PASS] agents/implementer.md — frontmatter 有效
[WARN] agents/reviewer.md — prompt 缺少 Principle 3
...
## L3 — 功能冒烟检查
[PASS] canary skill 加载成功
[FAIL] upstream skill (tdd) 加载失败
...
## 汇总
L1: 11/13 PASS, 2 FAIL
L2: 10/12 PASS, 1 FAIL, 1 WARN
L3: 5/7 PASS, 2 FAIL
  • 报告以 TOOLBOX_LINT_REPORT: 开头
  • 每项标注 [PASS]、[FAIL]、[WARN]
  • FAIL 和 WARN 附带简要原因
  • 末尾汇总各层通过率
  • FAIL 项不触发自动修复

自指处理

  • /toolbox-lint 自身在 L1 命令文件存在性检查中作为文件被统计，形成自指验证
  • L3 中不自我调用 /toolbox-lint，避免无限循环

Acceptance criteria

  • commands/toolbox-lint.md 存在，frontmatter 有效（description 字段）
  • 运行 /toolbox-lint 输出以 TOOLBOX_LINT_REPORT: 开头
  • L1 存在性检查覆盖所有必需文件/目录
  • L2 内容正确性检查覆盖 frontmatter 验证、principles 注入验证、自我报告交叉核对
  • L3 功能冒烟检查覆盖 canary、上游 skill、上游 command、agent dispatch、bun runtime
  • 每项标注 PASS/FAIL/WARN
  • 报告末尾包含各层汇总（通过数/总数）
  • 命令无参数，总是运行全量检查
  • 命令仅报告，不执行任何修复操作
  • 自我报告文件缺失时，L2 相关项标记为 FAIL（附原因），不崩溃

Blocked by

Activity

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

    resolvedAutopilot has resolved this issue

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all \u003cpre\u003e\u003ccode\u003e blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks"); } } catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); } })(); (function(){ try { var __m = "github.com"; var __re = new RegExp('^' + "github\\.com" + '
      Skip to content

      /toolbox-lint 命令（全量 L1+L2+L3） #63

      Open
      Open
      /toolbox-lint 命令（全量 L1+L2+L3）#63
      Labels
      resolvedAutopilot has resolved this issue

      Description

      @MatthewYe
      MatthewYe
      opened on Jun 22, 2026

      Parent

      #60 — 插件安装自检命令 /toolbox-lint

      What to build

      创建 commands/toolbox-lint.md 命令文件。该命令运行时，agent 执行三层自检并输出结构化的 TOOLBOX_LINT_REPORT。

      命令定义

      ---
description: Verify the toolbox plugin is correctly and completely installed. Runs a three-level self-check — L1 existence, L2 content correctness, L3 functional smoke — and outputs a TOOLBOX_LINT_REPORT with per-item PASS/FAIL/WARN verdicts.
---

      三层检查清单

      L1 — 存在性检查

      项预期
      dist/index.js存在
      node_modules/存在
      agents/implementer.md存在
      agents/reviewer.md存在
      agents/argus.md存在
      commands/ 下至少 6 个 .md（含 toolbox-lint 自身）存在
      skills/ 目录非空
      upstream/skills/engineering/存在 SKILL.md 文件
      upstream/skills/productivity/存在 SKILL.md 文件
      principles/karpathy.md存在
      principles/karpathy-primary.md存在
      Canary skill 文件存在
      Canary command 文件存在

      L2 — 内容正确性检查

      项验证方式
      所有 agent .md 有有效 YAML frontmatter + prompt 字段gray-matter 解析
      Implementer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Coding"
      Reviewer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Judging"
      Argus prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Analyzing"
      所有 command .md 有有效 frontmatter + descriptiongray-matter 解析
      所有 SKILL.md 有有效 frontmatter + name、descriptiongray-matter 解析
      karpathy.md 包含全部 4 条 principle子串匹配 "Principal 1" 到 "Principal 4"
      自我报告 JSON 可解析读取 + JSON.parse
      自我报告中的 agents 数量与文件系统一致交叉核对
      自我报告中的 commands 与文件系统一致交叉核对
      自我报告中的 skill_paths 三项都存在且可读交叉核对
      自我报告中的 upstream_skill_commands 与文件系统一致交叉核对

      L3 — 功能冒烟检查

      项验证方式
      加载 canary skillskill 工具 → 检查返回 CANARY_OK: toolbox skill registration verified
      加载上游 engineering skill（如 tdd 或 diagnose）skill 工具 → 成功返回指令
      加载上游 productivity skill（如 caveman）skill 工具 → 成功返回指令
      调用 canary commandcommand 执行 → 检查输出 CANARY_OK: toolbox command registration verified
      调用上游 command（如 /caveman）command 执行 → 正常返回
      Dispatch agent（general 做简单任务）task 工具 → 正常返回
      bun runtime 可用bun --version → 成功

      输出格式

      TOOLBOX_LINT_REPORT:
## L1 — 存在性检查
[PASS] dist/index.js
[FAIL] principles/karpathy.md — 文件不存在
...
## L2 — 内容正确性检查
[PASS] agents/implementer.md — frontmatter 有效
[WARN] agents/reviewer.md — prompt 缺少 Principle 3
...
## L3 — 功能冒烟检查
[PASS] canary skill 加载成功
[FAIL] upstream skill (tdd) 加载失败
...
## 汇总
L1: 11/13 PASS, 2 FAIL
L2: 10/12 PASS, 1 FAIL, 1 WARN
L3: 5/7 PASS, 2 FAIL
      • 报告以 TOOLBOX_LINT_REPORT: 开头
      • 每项标注 [PASS]、[FAIL]、[WARN]
      • FAIL 和 WARN 附带简要原因
      • 末尾汇总各层通过率
      • FAIL 项不触发自动修复

      自指处理

      • /toolbox-lint 自身在 L1 命令文件存在性检查中作为文件被统计，形成自指验证
      • L3 中不自我调用 /toolbox-lint，避免无限循环

      Acceptance criteria

      • commands/toolbox-lint.md 存在，frontmatter 有效（description 字段）
      • 运行 /toolbox-lint 输出以 TOOLBOX_LINT_REPORT: 开头
      • L1 存在性检查覆盖所有必需文件/目录
      • L2 内容正确性检查覆盖 frontmatter 验证、principles 注入验证、自我报告交叉核对
      • L3 功能冒烟检查覆盖 canary、上游 skill、上游 command、agent dispatch、bun runtime
      • 每项标注 PASS/FAIL/WARN
      • 报告末尾包含各层汇总（通过数/总数）
      • 命令无参数，总是运行全量检查
      • 命令仅报告，不执行任何修复操作
      • 自我报告文件缺失时，L2 相关项标记为 FAIL（附原因），不崩溃

      Blocked by

      Activity

      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

        resolvedAutopilot has resolved this issue

        Projects

        No projects

          Milestone

          No milestone

          Relationships

          None yet

          Development

          No branches or pull requests

          Issue actions

          , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
          Skip to content

          /toolbox-lint 命令（全量 L1+L2+L3） #63

          Open
          Open
          /toolbox-lint 命令（全量 L1+L2+L3）#63
          Labels
          resolvedAutopilot has resolved this issue

          Description

          @MatthewYe
          MatthewYe
          opened on Jun 22, 2026

          Parent

          #60 — 插件安装自检命令 /toolbox-lint

          What to build

          创建 commands/toolbox-lint.md 命令文件。该命令运行时，agent 执行三层自检并输出结构化的 TOOLBOX_LINT_REPORT。

          命令定义

          ---
description: Verify the toolbox plugin is correctly and completely installed. Runs a three-level self-check — L1 existence, L2 content correctness, L3 functional smoke — and outputs a TOOLBOX_LINT_REPORT with per-item PASS/FAIL/WARN verdicts.
---

          三层检查清单

          L1 — 存在性检查

          项预期
          dist/index.js存在
          node_modules/存在
          agents/implementer.md存在
          agents/reviewer.md存在
          agents/argus.md存在
          commands/ 下至少 6 个 .md（含 toolbox-lint 自身）存在
          skills/ 目录非空
          upstream/skills/engineering/存在 SKILL.md 文件
          upstream/skills/productivity/存在 SKILL.md 文件
          principles/karpathy.md存在
          principles/karpathy-primary.md存在
          Canary skill 文件存在
          Canary command 文件存在

          L2 — 内容正确性检查

          项验证方式
          所有 agent .md 有有效 YAML frontmatter + prompt 字段gray-matter 解析
          Implementer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Coding"
          Reviewer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Judging"
          Argus prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Analyzing"
          所有 command .md 有有效 frontmatter + descriptiongray-matter 解析
          所有 SKILL.md 有有效 frontmatter + name、descriptiongray-matter 解析
          karpathy.md 包含全部 4 条 principle子串匹配 "Principal 1" 到 "Principal 4"
          自我报告 JSON 可解析读取 + JSON.parse
          自我报告中的 agents 数量与文件系统一致交叉核对
          自我报告中的 commands 与文件系统一致交叉核对
          自我报告中的 skill_paths 三项都存在且可读交叉核对
          自我报告中的 upstream_skill_commands 与文件系统一致交叉核对

          L3 — 功能冒烟检查

          项验证方式
          加载 canary skillskill 工具 → 检查返回 CANARY_OK: toolbox skill registration verified
          加载上游 engineering skill（如 tdd 或 diagnose）skill 工具 → 成功返回指令
          加载上游 productivity skill（如 caveman）skill 工具 → 成功返回指令
          调用 canary commandcommand 执行 → 检查输出 CANARY_OK: toolbox command registration verified
          调用上游 command（如 /caveman）command 执行 → 正常返回
          Dispatch agent（general 做简单任务）task 工具 → 正常返回
          bun runtime 可用bun --version → 成功

          输出格式

          TOOLBOX_LINT_REPORT:
## L1 — 存在性检查
[PASS] dist/index.js
[FAIL] principles/karpathy.md — 文件不存在
...
## L2 — 内容正确性检查
[PASS] agents/implementer.md — frontmatter 有效
[WARN] agents/reviewer.md — prompt 缺少 Principle 3
...
## L3 — 功能冒烟检查
[PASS] canary skill 加载成功
[FAIL] upstream skill (tdd) 加载失败
...
## 汇总
L1: 11/13 PASS, 2 FAIL
L2: 10/12 PASS, 1 FAIL, 1 WARN
L3: 5/7 PASS, 2 FAIL
          • 报告以 TOOLBOX_LINT_REPORT: 开头
          • 每项标注 [PASS]、[FAIL]、[WARN]
          • FAIL 和 WARN 附带简要原因
          • 末尾汇总各层通过率
          • FAIL 项不触发自动修复

          自指处理

          • /toolbox-lint 自身在 L1 命令文件存在性检查中作为文件被统计，形成自指验证
          • L3 中不自我调用 /toolbox-lint，避免无限循环

          Acceptance criteria

          • commands/toolbox-lint.md 存在，frontmatter 有效（description 字段）
          • 运行 /toolbox-lint 输出以 TOOLBOX_LINT_REPORT: 开头
          • L1 存在性检查覆盖所有必需文件/目录
          • L2 内容正确性检查覆盖 frontmatter 验证、principles 注入验证、自我报告交叉核对
          • L3 功能冒烟检查覆盖 canary、上游 skill、上游 command、agent dispatch、bun runtime
          • 每项标注 PASS/FAIL/WARN
          • 报告末尾包含各层汇总（通过数/总数）
          • 命令无参数，总是运行全量检查
          • 命令仅报告，不执行任何修复操作
          • 自我报告文件缺失时，L2 相关项标记为 FAIL（附原因），不崩溃

          Blocked by

          Activity

          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

            resolvedAutopilot has resolved this issue

            Projects

            No projects

              Milestone

              No milestone

              Relationships

              None yet

              Development

              No branches or pull requests

              Issue actions

              , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length \u003e 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
              Skip to content

              /toolbox-lint 命令（全量 L1+L2+L3） #63

              Open
              Open
              /toolbox-lint 命令（全量 L1+L2+L3）#63
              Labels
              resolvedAutopilot has resolved this issue

              Description

              @MatthewYe
              MatthewYe
              opened on Jun 22, 2026

              Parent

              #60 — 插件安装自检命令 /toolbox-lint

              What to build

              创建 commands/toolbox-lint.md 命令文件。该命令运行时，agent 执行三层自检并输出结构化的 TOOLBOX_LINT_REPORT。

              命令定义

              ---
description: Verify the toolbox plugin is correctly and completely installed. Runs a three-level self-check — L1 existence, L2 content correctness, L3 functional smoke — and outputs a TOOLBOX_LINT_REPORT with per-item PASS/FAIL/WARN verdicts.
---

              三层检查清单

              L1 — 存在性检查

              项预期
              dist/index.js存在
              node_modules/存在
              agents/implementer.md存在
              agents/reviewer.md存在
              agents/argus.md存在
              commands/ 下至少 6 个 .md（含 toolbox-lint 自身）存在
              skills/ 目录非空
              upstream/skills/engineering/存在 SKILL.md 文件
              upstream/skills/productivity/存在 SKILL.md 文件
              principles/karpathy.md存在
              principles/karpathy-primary.md存在
              Canary skill 文件存在
              Canary command 文件存在

              L2 — 内容正确性检查

              项验证方式
              所有 agent .md 有有效 YAML frontmatter + prompt 字段gray-matter 解析
              Implementer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Coding"
              Reviewer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Judging"
              Argus prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Analyzing"
              所有 command .md 有有效 frontmatter + descriptiongray-matter 解析
              所有 SKILL.md 有有效 frontmatter + name、descriptiongray-matter 解析
              karpathy.md 包含全部 4 条 principle子串匹配 "Principal 1" 到 "Principal 4"
              自我报告 JSON 可解析读取 + JSON.parse
              自我报告中的 agents 数量与文件系统一致交叉核对
              自我报告中的 commands 与文件系统一致交叉核对
              自我报告中的 skill_paths 三项都存在且可读交叉核对
              自我报告中的 upstream_skill_commands 与文件系统一致交叉核对

              L3 — 功能冒烟检查

              项验证方式
              加载 canary skillskill 工具 → 检查返回 CANARY_OK: toolbox skill registration verified
              加载上游 engineering skill（如 tdd 或 diagnose）skill 工具 → 成功返回指令
              加载上游 productivity skill（如 caveman）skill 工具 → 成功返回指令
              调用 canary commandcommand 执行 → 检查输出 CANARY_OK: toolbox command registration verified
              调用上游 command（如 /caveman）command 执行 → 正常返回
              Dispatch agent（general 做简单任务）task 工具 → 正常返回
              bun runtime 可用bun --version → 成功

              输出格式

              TOOLBOX_LINT_REPORT:
## L1 — 存在性检查
[PASS] dist/index.js
[FAIL] principles/karpathy.md — 文件不存在
...
## L2 — 内容正确性检查
[PASS] agents/implementer.md — frontmatter 有效
[WARN] agents/reviewer.md — prompt 缺少 Principle 3
...
## L3 — 功能冒烟检查
[PASS] canary skill 加载成功
[FAIL] upstream skill (tdd) 加载失败
...
## 汇总
L1: 11/13 PASS, 2 FAIL
L2: 10/12 PASS, 1 FAIL, 1 WARN
L3: 5/7 PASS, 2 FAIL
              • 报告以 TOOLBOX_LINT_REPORT: 开头
              • 每项标注 [PASS]、[FAIL]、[WARN]
              • FAIL 和 WARN 附带简要原因
              • 末尾汇总各层通过率
              • FAIL 项不触发自动修复

              自指处理

              • /toolbox-lint 自身在 L1 命令文件存在性检查中作为文件被统计，形成自指验证
              • L3 中不自我调用 /toolbox-lint，避免无限循环

              Acceptance criteria

              • commands/toolbox-lint.md 存在，frontmatter 有效（description 字段）
              • 运行 /toolbox-lint 输出以 TOOLBOX_LINT_REPORT: 开头
              • L1 存在性检查覆盖所有必需文件/目录
              • L2 内容正确性检查覆盖 frontmatter 验证、principles 注入验证、自我报告交叉核对
              • L3 功能冒烟检查覆盖 canary、上游 skill、上游 command、agent dispatch、bun runtime
              • 每项标注 PASS/FAIL/WARN
              • 报告末尾包含各层汇总（通过数/总数）
              • 命令无参数，总是运行全量检查
              • 命令仅报告，不执行任何修复操作
              • 自我报告文件缺失时，L2 相关项标记为 FAIL（附原因），不崩溃

              Blocked by

              Activity

              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

                resolvedAutopilot has resolved this issue

                Projects

                No projects

                  Milestone

                  No milestone

                  Relationships

                  None yet

                  Development

                  No branches or pull requests

                  Issue actions

                  , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
                  Skip to content

                  /toolbox-lint 命令（全量 L1+L2+L3） #63

                  Open
                  Open
                  /toolbox-lint 命令（全量 L1+L2+L3）#63
                  Labels
                  resolvedAutopilot has resolved this issue

                  Description

                  @MatthewYe
                  MatthewYe
                  opened on Jun 22, 2026

                  Parent

                  #60 — 插件安装自检命令 /toolbox-lint

                  What to build

                  创建 commands/toolbox-lint.md 命令文件。该命令运行时，agent 执行三层自检并输出结构化的 TOOLBOX_LINT_REPORT。

                  命令定义

                  ---
description: Verify the toolbox plugin is correctly and completely installed. Runs a three-level self-check — L1 existence, L2 content correctness, L3 functional smoke — and outputs a TOOLBOX_LINT_REPORT with per-item PASS/FAIL/WARN verdicts.
---

                  三层检查清单

                  L1 — 存在性检查

                  项预期
                  dist/index.js存在
                  node_modules/存在
                  agents/implementer.md存在
                  agents/reviewer.md存在
                  agents/argus.md存在
                  commands/ 下至少 6 个 .md（含 toolbox-lint 自身）存在
                  skills/ 目录非空
                  upstream/skills/engineering/存在 SKILL.md 文件
                  upstream/skills/productivity/存在 SKILL.md 文件
                  principles/karpathy.md存在
                  principles/karpathy-primary.md存在
                  Canary skill 文件存在
                  Canary command 文件存在

                  L2 — 内容正确性检查

                  项验证方式
                  所有 agent .md 有有效 YAML frontmatter + prompt 字段gray-matter 解析
                  Implementer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Coding"
                  Reviewer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Judging"
                  Argus prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Analyzing"
                  所有 command .md 有有效 frontmatter + descriptiongray-matter 解析
                  所有 SKILL.md 有有效 frontmatter + name、descriptiongray-matter 解析
                  karpathy.md 包含全部 4 条 principle子串匹配 "Principal 1" 到 "Principal 4"
                  自我报告 JSON 可解析读取 + JSON.parse
                  自我报告中的 agents 数量与文件系统一致交叉核对
                  自我报告中的 commands 与文件系统一致交叉核对
                  自我报告中的 skill_paths 三项都存在且可读交叉核对
                  自我报告中的 upstream_skill_commands 与文件系统一致交叉核对

                  L3 — 功能冒烟检查

                  项验证方式
                  加载 canary skillskill 工具 → 检查返回 CANARY_OK: toolbox skill registration verified
                  加载上游 engineering skill（如 tdd 或 diagnose）skill 工具 → 成功返回指令
                  加载上游 productivity skill（如 caveman）skill 工具 → 成功返回指令
                  调用 canary commandcommand 执行 → 检查输出 CANARY_OK: toolbox command registration verified
                  调用上游 command（如 /caveman）command 执行 → 正常返回
                  Dispatch agent（general 做简单任务）task 工具 → 正常返回
                  bun runtime 可用bun --version → 成功

                  输出格式

                  TOOLBOX_LINT_REPORT:
## L1 — 存在性检查
[PASS] dist/index.js
[FAIL] principles/karpathy.md — 文件不存在
...
## L2 — 内容正确性检查
[PASS] agents/implementer.md — frontmatter 有效
[WARN] agents/reviewer.md — prompt 缺少 Principle 3
...
## L3 — 功能冒烟检查
[PASS] canary skill 加载成功
[FAIL] upstream skill (tdd) 加载失败
...
## 汇总
L1: 11/13 PASS, 2 FAIL
L2: 10/12 PASS, 1 FAIL, 1 WARN
L3: 5/7 PASS, 2 FAIL
                  • 报告以 TOOLBOX_LINT_REPORT: 开头
                  • 每项标注 [PASS]、[FAIL]、[WARN]
                  • FAIL 和 WARN 附带简要原因
                  • 末尾汇总各层通过率
                  • FAIL 项不触发自动修复

                  自指处理

                  • /toolbox-lint 自身在 L1 命令文件存在性检查中作为文件被统计，形成自指验证
                  • L3 中不自我调用 /toolbox-lint，避免无限循环

                  Acceptance criteria

                  • commands/toolbox-lint.md 存在，frontmatter 有效（description 字段）
                  • 运行 /toolbox-lint 输出以 TOOLBOX_LINT_REPORT: 开头
                  • L1 存在性检查覆盖所有必需文件/目录
                  • L2 内容正确性检查覆盖 frontmatter 验证、principles 注入验证、自我报告交叉核对
                  • L3 功能冒烟检查覆盖 canary、上游 skill、上游 command、agent dispatch、bun runtime
                  • 每项标注 PASS/FAIL/WARN
                  • 报告末尾包含各层汇总（通过数/总数）
                  • 命令无参数，总是运行全量检查
                  • 命令仅报告，不执行任何修复操作
                  • 自我报告文件缺失时，L2 相关项标记为 FAIL（附原因），不崩溃

                  Blocked by

                  Activity

                  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

                    resolvedAutopilot has resolved this issue

                    Projects

                    No projects

                      Milestone

                      No milestone

                      Relationships

                      None yet

                      Development

                      No branches or pull requests

                      Issue actions

                      , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
                      Skip to content

                      /toolbox-lint 命令（全量 L1+L2+L3） #63

                      Open
                      Open
                      /toolbox-lint 命令（全量 L1+L2+L3）#63
                      Labels
                      resolvedAutopilot has resolved this issue

                      Description

                      @MatthewYe
                      MatthewYe
                      opened on Jun 22, 2026

                      Parent

                      #60 — 插件安装自检命令 /toolbox-lint

                      What to build

                      创建 commands/toolbox-lint.md 命令文件。该命令运行时，agent 执行三层自检并输出结构化的 TOOLBOX_LINT_REPORT。

                      命令定义

                      ---
description: Verify the toolbox plugin is correctly and completely installed. Runs a three-level self-check — L1 existence, L2 content correctness, L3 functional smoke — and outputs a TOOLBOX_LINT_REPORT with per-item PASS/FAIL/WARN verdicts.
---

                      三层检查清单

                      L1 — 存在性检查

                      项预期
                      dist/index.js存在
                      node_modules/存在
                      agents/implementer.md存在
                      agents/reviewer.md存在
                      agents/argus.md存在
                      commands/ 下至少 6 个 .md（含 toolbox-lint 自身）存在
                      skills/ 目录非空
                      upstream/skills/engineering/存在 SKILL.md 文件
                      upstream/skills/productivity/存在 SKILL.md 文件
                      principles/karpathy.md存在
                      principles/karpathy-primary.md存在
                      Canary skill 文件存在
                      Canary command 文件存在

                      L2 — 内容正确性检查

                      项验证方式
                      所有 agent .md 有有效 YAML frontmatter + prompt 字段gray-matter 解析
                      Implementer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Coding"
                      Reviewer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Judging"
                      Argus prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Analyzing"
                      所有 command .md 有有效 frontmatter + descriptiongray-matter 解析
                      所有 SKILL.md 有有效 frontmatter + name、descriptiongray-matter 解析
                      karpathy.md 包含全部 4 条 principle子串匹配 "Principal 1" 到 "Principal 4"
                      自我报告 JSON 可解析读取 + JSON.parse
                      自我报告中的 agents 数量与文件系统一致交叉核对
                      自我报告中的 commands 与文件系统一致交叉核对
                      自我报告中的 skill_paths 三项都存在且可读交叉核对
                      自我报告中的 upstream_skill_commands 与文件系统一致交叉核对

                      L3 — 功能冒烟检查

                      项验证方式
                      加载 canary skillskill 工具 → 检查返回 CANARY_OK: toolbox skill registration verified
                      加载上游 engineering skill（如 tdd 或 diagnose）skill 工具 → 成功返回指令
                      加载上游 productivity skill（如 caveman）skill 工具 → 成功返回指令
                      调用 canary commandcommand 执行 → 检查输出 CANARY_OK: toolbox command registration verified
                      调用上游 command（如 /caveman）command 执行 → 正常返回
                      Dispatch agent（general 做简单任务）task 工具 → 正常返回
                      bun runtime 可用bun --version → 成功

                      输出格式

                      TOOLBOX_LINT_REPORT:
## L1 — 存在性检查
[PASS] dist/index.js
[FAIL] principles/karpathy.md — 文件不存在
...
## L2 — 内容正确性检查
[PASS] agents/implementer.md — frontmatter 有效
[WARN] agents/reviewer.md — prompt 缺少 Principle 3
...
## L3 — 功能冒烟检查
[PASS] canary skill 加载成功
[FAIL] upstream skill (tdd) 加载失败
...
## 汇总
L1: 11/13 PASS, 2 FAIL
L2: 10/12 PASS, 1 FAIL, 1 WARN
L3: 5/7 PASS, 2 FAIL
                      • 报告以 TOOLBOX_LINT_REPORT: 开头
                      • 每项标注 [PASS]、[FAIL]、[WARN]
                      • FAIL 和 WARN 附带简要原因
                      • 末尾汇总各层通过率
                      • FAIL 项不触发自动修复

                      自指处理

                      • /toolbox-lint 自身在 L1 命令文件存在性检查中作为文件被统计，形成自指验证
                      • L3 中不自我调用 /toolbox-lint，避免无限循环

                      Acceptance criteria

                      • commands/toolbox-lint.md 存在，frontmatter 有效（description 字段）
                      • 运行 /toolbox-lint 输出以 TOOLBOX_LINT_REPORT: 开头
                      • L1 存在性检查覆盖所有必需文件/目录
                      • L2 内容正确性检查覆盖 frontmatter 验证、principles 注入验证、自我报告交叉核对
                      • L3 功能冒烟检查覆盖 canary、上游 skill、上游 command、agent dispatch、bun runtime
                      • 每项标注 PASS/FAIL/WARN
                      • 报告末尾包含各层汇总（通过数/总数）
                      • 命令无参数，总是运行全量检查
                      • 命令仅报告，不执行任何修复操作
                      • 自我报告文件缺失时，L2 相关项标记为 FAIL（附原因），不崩溃

                      Blocked by

                      Activity

                      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

                        resolvedAutopilot has resolved this issue

                        Projects

                        No projects

                          Milestone

                          No milestone

                          Relationships

                          None yet

                          Development

                          No branches or pull requests

                          Issue actions

                          , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
                          Skip to content

                          /toolbox-lint 命令（全量 L1+L2+L3） #63

                          Open
                          Open
                          /toolbox-lint 命令（全量 L1+L2+L3）#63
                          Labels
                          resolvedAutopilot has resolved this issue

                          Description

                          @MatthewYe
                          MatthewYe
                          opened on Jun 22, 2026

                          Parent

                          #60 — 插件安装自检命令 /toolbox-lint

                          What to build

                          创建 commands/toolbox-lint.md 命令文件。该命令运行时，agent 执行三层自检并输出结构化的 TOOLBOX_LINT_REPORT。

                          命令定义

                          ---
description: Verify the toolbox plugin is correctly and completely installed. Runs a three-level self-check — L1 existence, L2 content correctness, L3 functional smoke — and outputs a TOOLBOX_LINT_REPORT with per-item PASS/FAIL/WARN verdicts.
---

                          三层检查清单

                          L1 — 存在性检查

                          项预期
                          dist/index.js存在
                          node_modules/存在
                          agents/implementer.md存在
                          agents/reviewer.md存在
                          agents/argus.md存在
                          commands/ 下至少 6 个 .md（含 toolbox-lint 自身）存在
                          skills/ 目录非空
                          upstream/skills/engineering/存在 SKILL.md 文件
                          upstream/skills/productivity/存在 SKILL.md 文件
                          principles/karpathy.md存在
                          principles/karpathy-primary.md存在
                          Canary skill 文件存在
                          Canary command 文件存在

                          L2 — 内容正确性检查

                          项验证方式
                          所有 agent .md 有有效 YAML frontmatter + prompt 字段gray-matter 解析
                          Implementer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Coding"
                          Reviewer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Judging"
                          Argus prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Analyzing"
                          所有 command .md 有有效 frontmatter + descriptiongray-matter 解析
                          所有 SKILL.md 有有效 frontmatter + name、descriptiongray-matter 解析
                          karpathy.md 包含全部 4 条 principle子串匹配 "Principal 1" 到 "Principal 4"
                          自我报告 JSON 可解析读取 + JSON.parse
                          自我报告中的 agents 数量与文件系统一致交叉核对
                          自我报告中的 commands 与文件系统一致交叉核对
                          自我报告中的 skill_paths 三项都存在且可读交叉核对
                          自我报告中的 upstream_skill_commands 与文件系统一致交叉核对

                          L3 — 功能冒烟检查

                          项验证方式
                          加载 canary skillskill 工具 → 检查返回 CANARY_OK: toolbox skill registration verified
                          加载上游 engineering skill（如 tdd 或 diagnose）skill 工具 → 成功返回指令
                          加载上游 productivity skill（如 caveman）skill 工具 → 成功返回指令
                          调用 canary commandcommand 执行 → 检查输出 CANARY_OK: toolbox command registration verified
                          调用上游 command（如 /caveman）command 执行 → 正常返回
                          Dispatch agent（general 做简单任务）task 工具 → 正常返回
                          bun runtime 可用bun --version → 成功

                          输出格式

                          TOOLBOX_LINT_REPORT:
## L1 — 存在性检查
[PASS] dist/index.js
[FAIL] principles/karpathy.md — 文件不存在
...
## L2 — 内容正确性检查
[PASS] agents/implementer.md — frontmatter 有效
[WARN] agents/reviewer.md — prompt 缺少 Principle 3
...
## L3 — 功能冒烟检查
[PASS] canary skill 加载成功
[FAIL] upstream skill (tdd) 加载失败
...
## 汇总
L1: 11/13 PASS, 2 FAIL
L2: 10/12 PASS, 1 FAIL, 1 WARN
L3: 5/7 PASS, 2 FAIL
                          • 报告以 TOOLBOX_LINT_REPORT: 开头
                          • 每项标注 [PASS]、[FAIL]、[WARN]
                          • FAIL 和 WARN 附带简要原因
                          • 末尾汇总各层通过率
                          • FAIL 项不触发自动修复

                          自指处理

                          • /toolbox-lint 自身在 L1 命令文件存在性检查中作为文件被统计，形成自指验证
                          • L3 中不自我调用 /toolbox-lint，避免无限循环

                          Acceptance criteria

                          • commands/toolbox-lint.md 存在，frontmatter 有效（description 字段）
                          • 运行 /toolbox-lint 输出以 TOOLBOX_LINT_REPORT: 开头
                          • L1 存在性检查覆盖所有必需文件/目录
                          • L2 内容正确性检查覆盖 frontmatter 验证、principles 注入验证、自我报告交叉核对
                          • L3 功能冒烟检查覆盖 canary、上游 skill、上游 command、agent dispatch、bun runtime
                          • 每项标注 PASS/FAIL/WARN
                          • 报告末尾包含各层汇总（通过数/总数）
                          • 命令无参数，总是运行全量检查
                          • 命令仅报告，不执行任何修复操作
                          • 自我报告文件缺失时，L2 相关项标记为 FAIL（附原因），不崩溃

                          Blocked by

                          Activity

                          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

                            resolvedAutopilot has resolved this issue

                            Projects

                            No projects

                              Milestone

                              No milestone

                              Relationships

                              None yet

                              Development

                              No branches or pull requests

                              Issue actions

                              , 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
                              Skip to content

                              /toolbox-lint 命令（全量 L1+L2+L3） #63

                              Open
                              Open
                              /toolbox-lint 命令（全量 L1+L2+L3）#63
                              Labels
                              resolvedAutopilot has resolved this issue

                              Description

                              @MatthewYe
                              MatthewYe
                              opened on Jun 22, 2026

                              Parent

                              #60 — 插件安装自检命令 /toolbox-lint

                              What to build

                              创建 commands/toolbox-lint.md 命令文件。该命令运行时，agent 执行三层自检并输出结构化的 TOOLBOX_LINT_REPORT。

                              命令定义

                              ---
description: Verify the toolbox plugin is correctly and completely installed. Runs a three-level self-check — L1 existence, L2 content correctness, L3 functional smoke — and outputs a TOOLBOX_LINT_REPORT with per-item PASS/FAIL/WARN verdicts.
---

                              三层检查清单

                              L1 — 存在性检查

                              项预期
                              dist/index.js存在
                              node_modules/存在
                              agents/implementer.md存在
                              agents/reviewer.md存在
                              agents/argus.md存在
                              commands/ 下至少 6 个 .md（含 toolbox-lint 自身）存在
                              skills/ 目录非空
                              upstream/skills/engineering/存在 SKILL.md 文件
                              upstream/skills/productivity/存在 SKILL.md 文件
                              principles/karpathy.md存在
                              principles/karpathy-primary.md存在
                              Canary skill 文件存在
                              Canary command 文件存在

                              L2 — 内容正确性检查

                              项验证方式
                              所有 agent .md 有有效 YAML frontmatter + prompt 字段gray-matter 解析
                              Implementer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Coding"
                              Reviewer prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Judging"
                              Argus prompt 包含 Karpathy principles子串匹配 "Principle 1: Think Before Analyzing"
                              所有 command .md 有有效 frontmatter + descriptiongray-matter 解析
                              所有 SKILL.md 有有效 frontmatter + name、descriptiongray-matter 解析
                              karpathy.md 包含全部 4 条 principle子串匹配 "Principal 1" 到 "Principal 4"
                              自我报告 JSON 可解析读取 + JSON.parse
                              自我报告中的 agents 数量与文件系统一致交叉核对
                              自我报告中的 commands 与文件系统一致交叉核对
                              自我报告中的 skill_paths 三项都存在且可读交叉核对
                              自我报告中的 upstream_skill_commands 与文件系统一致交叉核对

                              L3 — 功能冒烟检查

                              项验证方式
                              加载 canary skillskill 工具 → 检查返回 CANARY_OK: toolbox skill registration verified
                              加载上游 engineering skill（如 tdd 或 diagnose）skill 工具 → 成功返回指令
                              加载上游 productivity skill（如 caveman）skill 工具 → 成功返回指令
                              调用 canary commandcommand 执行 → 检查输出 CANARY_OK: toolbox command registration verified
                              调用上游 command（如 /caveman）command 执行 → 正常返回
                              Dispatch agent（general 做简单任务）task 工具 → 正常返回
                              bun runtime 可用bun --version → 成功

                              输出格式

                              TOOLBOX_LINT_REPORT:
## L1 — 存在性检查
[PASS] dist/index.js
[FAIL] principles/karpathy.md — 文件不存在
...
## L2 — 内容正确性检查
[PASS] agents/implementer.md — frontmatter 有效
[WARN] agents/reviewer.md — prompt 缺少 Principle 3
...
## L3 — 功能冒烟检查
[PASS] canary skill 加载成功
[FAIL] upstream skill (tdd) 加载失败
...
## 汇总
L1: 11/13 PASS, 2 FAIL
L2: 10/12 PASS, 1 FAIL, 1 WARN
L3: 5/7 PASS, 2 FAIL
                              • 报告以 TOOLBOX_LINT_REPORT: 开头
                              • 每项标注 [PASS]、[FAIL]、[WARN]
                              • FAIL 和 WARN 附带简要原因
                              • 末尾汇总各层通过率
                              • FAIL 项不触发自动修复

                              自指处理

                              • /toolbox-lint 自身在 L1 命令文件存在性检查中作为文件被统计，形成自指验证
                              • L3 中不自我调用 /toolbox-lint，避免无限循环

                              Acceptance criteria

                              • commands/toolbox-lint.md 存在，frontmatter 有效（description 字段）
                              • 运行 /toolbox-lint 输出以 TOOLBOX_LINT_REPORT: 开头
                              • L1 存在性检查覆盖所有必需文件/目录
                              • L2 内容正确性检查覆盖 frontmatter 验证、principles 注入验证、自我报告交叉核对
                              • L3 功能冒烟检查覆盖 canary、上游 skill、上游 command、agent dispatch、bun runtime
                              • 每项标注 PASS/FAIL/WARN
                              • 报告末尾包含各层汇总（通过数/总数）
                              • 命令无参数，总是运行全量检查
                              • 命令仅报告，不执行任何修复操作
                              • 自我报告文件缺失时，L2 相关项标记为 FAIL（附原因），不崩溃

                              Blocked by

                              Activity

                              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

                                resolvedAutopilot has resolved this issue

                                Projects

                                No projects

                                  Milestone

                                  No milestone

                                  Relationships

                                  None yet

                                  Development

                                  No branches or pull requests

                                  Issue actions