@heihei0299/matt-skills 3.0.29 → 3.0.30

package/README.md

@@ -14,8 +14,8 @@
 template/
 ├── AGENTS.md                 Agent 行为路由与项目上下文入口
 ├── PROJECT.md                目标项目填写的目标、范围和主要入口
-├── .opencode/                opencode agents、commands、docs
-└── .pi/                      pi prompts、docs 与项目自定义 skills 占位
+├── .opencode/                opencode 基础框架（context、docs、skills 占位）
+└── .pi/                      pi 基础框架（context、docs、skills 占位）
 ```
 
 共享 Skills 不作为 Template Snapshot 的持久化副本；`init`、普通 `sync` 和项目级 `install` 都从 Workspace 的 canonical source 分发到唯一的 `.agents/skills/`。`.pi/skills/`、`.opencode/skills/` 和 `.claude/skills/` 仅用于项目自定义 skills。
@@ -25,6 +25,7 @@ template/
 - `.opencode/CONTEXT.md` / `.pi/CONTEXT.md` 保存领域术语与边界。
 - `.agents/skills/` 承载共享 skills；同步只处理可分发 skill 名称，不删除额外的项目自定义 skills。
 - `ci-guard`、`commit-check` 是本仓库维护用的 repo-local skills，不会分发到目标项目。
+- `.pi`、`.codex` 不承载共享 skills；workspace 专用 commands、agents 和 prompts 也不会进入默认模板。
 
 ## 独有 skill 分发边界
 
@@ -65,7 +66,7 @@ npx @heihei0299/matt-skills sync --dry-run --json
 
 `init` 对已有 `AGENTS.md` 始终跳过；已有项目使用 `sync`。默认 `sync` 保留已有 `AGENTS.md` 和项目规则，`--all` 只扩大技能范围。需要显式刷新 `AGENTS.md` 时使用 `sync --refresh-agents`；无受管区块时会先备份为 `AGENTS.md.bak`。`sync` 不删除目标项目的额外文件或自定义 skills。
 
-默认 workflow 范围固定为 11 个入口及依赖 skills，包含 `initialize-project`、`setup-matt-pocock-skills`、`grill-to-spec`、`grill-with-docs`、`to-spec`、`to-tickets`、`tdd-implement`、`grilling`、`domain-modeling`、`tdd` 和 `code-review`；其中默认独有 skills 是 `tdd-implement`、`grill-to-spec`、`initialize-project`。完整可分发集合（包括 `wayfinder`、`handoff` 和 `implement`）仍通过 `--all` 获取。
+默认 workflow 范围固定为 7 个入口及依赖 skills，包含 `initialize-project`、`setup-matt-pocock-skills`、`grill-with-docs`、`to-spec`、`to-tickets`、`grilling` 和 `domain-modeling`；其中默认独有 skills 是 `initialize-project`。`tdd` 及其他可分发 skills 仍通过 `--all` 获取。
 
 ## CLI
 

package/bin/cli.js

@@ -314,6 +314,12 @@ async function promptSkills(skills) {
     message: '选择要安装的技能',
     choices: skills.map((s) => ({ title: s.name, value: s.name })),
     instructions: '输入过滤，空格勾选，回车确认',
+    onRender() {
+      if (this.inputValue && this.filteredOptions.length === 0) {
+        this.filteredOptions = [{ title: '没有匹配的技能', value: '__no-match__', disabled: true }];
+        this.cursor = 0;
+      }
+    },
   });
   return Array.isArray(res?.skills) ? res.skills : [];
 }

package/config/default.json

@@ -1,13 +1,9 @@
 [
-  "code-review",
   "domain-modeling",
-  "grill-to-spec",
   "grill-with-docs",
   "grilling",
   "initialize-project",
   "setup-matt-pocock-skills",
-  "tdd",
-  "tdd-implement",
   "to-spec",
   "to-tickets"
 ]

package/config/proprietary.json

@@ -22,8 +22,6 @@
     "commit-check"
   ],
   "default": [
-    "tdd-implement",
-    "grill-to-spec",
     "initialize-project"
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heihei0299/matt-skills",
-  "version": "3.0.29",
+  "version": "3.0.30",
   "description": "Agent skills + 项目配置模板：一条命令初始化 opencode / pi-agent 项目（含 mattpocock/skills 上游技能）",
   "type": "module",
   "bin": {

package/template/AGENTS.md

@@ -1,10 +1,12 @@
 ## Workflow
 按任务选择最匹配的 skill / 工具：
 * 需要新增证据的代码理解 / 定位 / 调用链 / 依赖关系 / 数据流 → `codegraph explore`
-* 行为修改 / 功能实现 / bug 修复 / 逻辑调整 → `tdd`
-* 多来源调研 / 方案比较 / 技术选型 / 最佳实践 / 外部实现 → `research`
-`research` 仅用于多来源综合；单一资料、官方文档和实时事实直接查询。
-未命中 skill 时直接执行。明确不改变行为的文案、注释、格式和机械修改无需 `tdd`。
+* 目标项目首次初始化或刷新项目上下文 → `initialize-project`
+* 首次使用 spec / tickets 流程，需要配置 issue tracker 和领域文档 → `setup-matt-pocock-skills`
+* 模糊需求、设计讨论并同步 ADR / glossary → `grill-with-docs`
+* 已有共识，需要发布 spec → `to-spec`
+* 已有 spec / 计划，需要拆分可执行 tickets → `to-tickets`
+未命中 skill 时直接执行。明确不改变行为的文案、注释、格式和机械修改直接处理。
 仅当关键歧义无法从仓库事实解决，且会改变实现、范围、风险或验收结果时询问用户。
 ## Context / CodeGraph
 以当前代码、配置、测试和版本化文档为事实来源；更具体的项目指令优先。
@@ -18,10 +20,11 @@
 优先验证原问题、相关测试和直接受影响模块；不重复已有有效证据。
 公共 API、共享抽象、跨模块调用链或局部验证不足时扩大验证范围；普通修改不自动运行全量测试。
 ## Git
-* 仅在用户要求时 commit。
-* commit 前检查 diff，只 stage 本次任务文件。
-* 禁止 `git add .` / `git add -A`。
-* 不覆盖、回滚或混入已有未提交修改。
+- 每个独立 issue/spec 对应一个 commit；不得按实现、测试、review 等阶段拆分。
+- 仅在本次改动完成并通过相关验证后提交。checkpoint 例外，但须明确标注未完成或未通过的验证。
+- commit 前检查 `git diff` 和 `git status`；只 stage 本次任务改动，不覆盖、回滚或提交用户及其他任务的既有修改。
+- `commit` 不授权 `push` 或发布；远程写入须单独授权。
+- commit 后报告 hash、验证命令及结果。
 ## Security
 * 不读取、输出或提交未经授权的真实 secrets。
 * 按现有 lockfile 恢复依赖可直接执行。

package/template/.opencode/agents/issue-audit.md

@@ -1,52 +0,0 @@
----
-description: 审计 feature 的 issue 完成情况（四维：完成度 / spec 遵守 / ADR 遵守 / 文档一致性），输出完整报告（对话 + .scratch/<slug>/audit-<时间戳>.md）。只审计，物理上无法修改其他任何文件。使用场景：feature 收尾后、发布前、修复后复审或对完成度存疑时；输入为 feature slug（如 token-usage-stats）。
-mode: subagent
-permission:
-  read: allow
-  edit:
-    "*": deny
-    ".scratch/*/audit-*.md": allow
-  bash:
-    "*": deny
-    "git status": allow
-    "git status *": allow
-    "git log": allow
-    "git log *": allow
-    "git diff": allow
-    "git diff *": allow
-    "git show": allow
-    "git show *": allow
-    "git rev-parse *": allow
-    "git ls-files": allow
-    "git ls-files *": allow
-    "git grep": allow
-    "git grep *": allow
-    "cargo test --lib": allow
-    "cargo test --lib *": allow
-  task: deny
----
-
-# Issue Auditor
-
-你是 issue 完成情况的独立审计者，像外部质量审计员一样工作。
-
-## 铁律（不可违背）
-
-- **只审计，不修改任何现有文档与代码。** `edit` 权限被系统强制限制为仅 `.scratch/*/audit-*.md` 可写——你物理上无法修改其他任何文件；不尝试绕过（如通过 bash 写文件）。
-- **不勾选验收标准、不改 Status、不做 triage 流转。**
-- **输入无效立即失败（fail-fast）**：`.scratch/<slug>/` 不存在或为空、缺少 `spec.md`、`issues/` 下没有任何 issue 文件时，不进入审计流程，直接输出失败报告（逐项列出缺失内容）并结束。
-- 只读 git 命令（status/log/diff/show/rev-parse/ls-files/grep）与 `cargo test --lib` 允许用于收集证据；任何写操作命令一律不执行。
-
-## 为什么分四维（不可合并重排）
-
-四维是相互独立的审计轴：完成度（验收标准逐条）可以全绿，而 spec 决策被违背、ADR 被绕过或文档已过期。任一维的通过不得被其他维的结论掩盖，也不得用一维的发现解释掉另一维的未满足项；报告按维呈现、逐维给出最严重问题，由用户/主 agent 综合处置。
-
-## 执行
-
-- 完整流程由任务指令（issue-audit 命令正文）提供：输入来源、四维审计、证据分级（L1/L2/L3）、问题分级、报告模板、出口条件。
-- 严格按任务指令执行，不偏离、不省略任何维度。
-- 报告逐条独立可验证：每个验收标准、每个未满足项自成一条并附证据（文件:行号、测试名、提交哈希），不合并成模糊结论；阻断项写"违反了什么 + 需要什么"，不做过程性修复指示。
-- **结论总览须给出每维最严重问题各一行**（该维无问题时写"无"），不得只给汇总数字。
-- **报告文件名必须为 `audit-<YYYYMMDD-HHMM>.md`，精确到分钟**（如 `audit-20260802-0604.md`），不得省略分钟；同名文件已存在时追加 `-2` 序号，永不覆盖。
-- 报告语言中文；代码标识符、测试名、字段名、提交哈希保留原文。
-- 报告不完整不得结束——四维缺失、未满足项遗漏、证据缺失时继续补齐。

package/template/.opencode/commands/grill-to-spec.md

@@ -1,13 +0,0 @@
----
-description: 编排 grill-with-docs → to-spec，把设计打磨成共识并发布 spec（只打磨设计与产出文档，不写代码）
----
-
-# Grill to Spec
-
-开始 `/grill-to-spec` 会话，加载并执行 grill-to-spec 技能（编排 grilling→domain-modeling→to-spec）：
-
-**主题：** $ARGUMENTS
-
-- 只编排与产出：设计打磨成共识 → 综合成 spec 发布，不写代码、不动源码
-- 产出物限：领域文档（glossary/ADR）与一份 spec issue，不拆 implementation tickets
-- 共识达成后直接写入/发布 ADR、spec 与 issue，不向用户展示正文；只报告路径或标识、状态和范围摘要

package/template/.opencode/commands/handoff.md

@@ -1,12 +0,0 @@
----
-description: 交接——把当前对话压缩为交接文档，供另一个 agent 接手
----
-
-# Handoff
-
-加载并执行 handoff 技能，压缩当前对话为交接文档：
-
-**目标：** $ARGUMENTS
-
-- 将当前会话状态压缩为结构化交接文档
-- 供另一个 agent 无缝接手继续工作

package/template/.opencode/commands/improve-codebase-architecture.md

@@ -1,13 +0,0 @@
----
-description: 架构扫描——扫描代码库寻找可深化机会，输出可视化 HTML 报告，然后 grill 选定的一项
----
-
-# Improve Codebase Architecture
-
-加载并执行 improve-codebase-architecture 技能，扫描代码库：
-
-**范围：** $ARGUMENTS
-
-- 扫描代码库，识别可深化的架构机会
-- 输出可视化 HTML 报告呈现
-- 选定一项后用 grilling 打磨方案

package/template/.opencode/commands/issue-audit.md

@@ -1,115 +0,0 @@
----
-description: 审计 feature 的 issue 完成情况（四维：完成度 / spec 遵守 / ADR 遵守 / 文档一致性），输出完整报告，只审计不修改
-agent: issue-audit
-subtask: true
----
-
-# Issue Audit：`$ARGUMENTS`
-
-对 feature `$ARGUMENTS` 执行完整 issue 审计（对应目录 `.scratch/$ARGUMENTS/`），按以下流程执行。
-
-## 铁律（不可违背）
-
-- **不修改任何现有文档与代码。** issue 文件、spec.md、README*、src-rust/、webui/ 等一切现有文件禁止改动。
-- **唯一允许的写入**：新建审计报告 `.scratch/$ARGUMENTS/audit-<YYYYMMDD-HHMM>.md`（时间戳文件名，保留多次审计历史）。不覆盖、不修改任何其他文件，不生成其他产物。
-- **不勾选验收标准、不改 Status、不做 triage 流转。** 状态机是 triage 技能的职责；审计只产出事实结论。
-- **输入无效立即失败（fail-fast）**：`.scratch/$ARGUMENTS/` 不存在或为空、缺少 `spec.md`、`issues/` 下没有任何 issue 文件时，不进入审计流程，直接输出失败报告（逐项列出缺失内容）并结束。
-- 审计与被审计分离：发现问题不修复、不流转，只在报告中记录（阻断项附"需要什么"），处置由用户/主 agent 决定。
-- 只读 git 命令（status/log/diff/show/rev-parse/ls-files/grep）用于收集提交历史证据；任何写操作命令一律不执行。
-- 报告语言中文；代码标识符、测试名、字段名、提交哈希保留原文。
-
-## 输入来源
-
-- `.scratch/$ARGUMENTS/spec.md`（Implementation Decisions、Testing Decisions、Out of Scope）
-- `.scratch/$ARGUMENTS/issues/*.md`（每票验收标准、Blocked by 依赖）
-- `.scratch/$ARGUMENTS/audit-*.md`（历史审计报告，读取最新一份作为对比基线；无则标注"无历史基线"）
-- `docs/adr/*.md`（架构决策，审计对象）
-- `CONTEXT.md`（术语表；违反术语视为 spec 遵守问题）
-- 当前工作树代码 + 只读 git 历史（提交哈希作为"确实做过"的证据）
-
-## 为什么分四维（不可合并重排）
-
-四维是相互独立的审计轴：完成度（验收标准逐条）可以全绿，而 spec 决策被违背、ADR 被绕过或文档已过期。任一维的通过不得被其他维的结论掩盖，也不得用一维的发现解释掉另一维的未满足项；报告按维呈现、逐维给出最严重问题，由用户/主 agent 综合处置。
-
-## 四维审计
-
-1. **完成度**：逐票核对每个 issue 的验收标准（checkboxes）——逐条判定满足/未满足，引用代码位置、单测名、提交哈希作为证据。Blocked by 依赖未满足的票不计入完成度。
-2. **Spec 遵守**：spec.md 的 Implementation Decisions 是否被落实、是否违背；Testing Decisions 的测试是否真实存在（非空头声明）；**Out of Scope 是否被越过**（实现做了 spec 明说不做的事 = 阻断项）。
-3. **ADR 遵守**：每个 `docs/adr/NNNN-*.md` 的决策在当前实现中是否被遵守。
-4. **文档一致性**：README.md / README_ZH.md（及受影响的其他用户文档）与当前实现是否一致——无过期信息、无声称未实现的功能（如 feature 中某 UI 尚未实现，文档不得声称其存在）、命令示例与界面描述与实际一致。
-
-## 证据分级（下结论的纪律）
-
-- **L1 静态**（默认）：读代码、读 git 提交记录、核对单测存在性与断言内容。
-- **L2 测试套件**：运行仓库完整测试套件（本项目：`cargo test --lib` 于项目根；如有 JS 侧测试一并运行）。每次审计必跑。
-- **L3 端到端**：仅在以下情形升级——① 某验收标准明确要求"链路可用/端到端"；② L1 静态核对发现不一致、仅靠静态无法定案。**subagent 内不执行 L3**；判定需要升级后，将条目列入报告「待主 agent 隔离验证」清单（注明升级条件与需验证内容），由主 agent 在隔离环境（临时 HOME + mock 上游）执行。
-- **弱证据不足**：间接、缺失、仅一致的证据不足以支撑"通过"结论；无法取证到位的条目标为非阻断疑点并注明"需要升级证据"。
-
-## 问题分级
-
-- **阻断项（must-fix）**：验收标准未达成、违反 ADR、越过 Out of Scope、违背 spec 决策。
-- **非阻断项（should-note）**：文档措辞、建议性改进、证据仅间接的疑点。
-- feature 结论 = 阻断项数 + 非阻断项数；**阻断为 0 才判定通过**。
-
-## 执行步骤（顺序自包含）
-
-1. 校验输入（fail-fast）：确认 `.scratch/$ARGUMENTS/` 存在且非空、`spec.md` 存在、`issues/` 下至少有一个 issue 文件；任一项不满足 → 输出失败报告（逐项列出缺失内容）并结束，不进入审计、不生成审计报告文件。校验通过后列出 spec、全部 issue、历史审计报告（若有）。
-2. 收集约定：读 spec.md、全部 issues、`docs/adr/`、CONTEXT.md。
-3. 逐票核对（维度 1）：每票验收标准逐条判定，记录证据。
-4. 维度 2：以 spec 决策与 Out of Scope 对照当前代码实现。
-5. 维度 3：以每个 ADR 对照当前实现。
-6. 维度 4：对照 README 等文档与当前实现。
-7. 跑 L2 测试套件（`cargo test --lib`），记录通过数/失败数。
-8. 判定 L3 升级条件，必要时列出待主 agent 隔离验证清单。
-9. 读取最新历史报告（若有）作基线，对比阻断项变化。
-10. 汇总四维报告：对话输出完整报告，并写入 `.scratch/$ARGUMENTS/audit-<YYYYMMDD-HHMM>.md`。
-    - **文件名必须精确到分钟**（如 `audit-20260802-0604.md`），格式为 `audit-` + 年(4)月(2)日(2)-时(2)分(2) + `.md`。不得省略分钟、不得用其他命名。
-    - 同分钟重跑导致同名时追加 `-2`、`-3` 序号（如 `audit-20260802-0604-2.md`），永不覆盖已有文件。
-
-## 报告原则（逐条独立可验证）
-
-- **逐条独立可验证**：每个验收标准、每个未满足项自成一条并附证据（文件:行号、测试名、提交哈希），不合并成模糊结论——读者可逐条复核。
-- **行为性表述**：阻断项写"违反了什么 + 需要什么"，不做过程性修复指示（如"应该打开 X 文件改 Y"）；证据引用（文件:行号）仅为定位证据，不作修复指令。
-- **不合并重排**：四维结论按维呈现、互不遮盖（见「为什么分四维」）。
-
-## 报告模板（强制，四维缺失视为未完成）
-
-```markdown
-# Issue 审计报告：$ARGUMENTS
-
-审计时间：<YYYY-MM-DD HH:MM>（精确到分钟）｜基线：<上次报告文件名 或 "无历史基线">
-
-## 结论总览
-- 阻断项：N 项 / 非阻断项：M 项 → 通过 / 未通过
-- 每维最严重问题：维度1：<票号+一句> ｜ 维度2：<一句> ｜ 维度3：<一句> ｜ 维度4：<一句>（该维无问题写"无"）
-- 与上次审计对比：新增解决 k 项 / 新引入 j 项 / 持续未满足 i 项（无历史基线时写"本次为首份报告"）
-
-## 维度 1 · 完成度（逐票）
-- 01 <标题>：满足 / 未满足（验收标准逐条 + 证据：文件:行号、测试名、提交哈希）
-
-## 维度 2 · Spec 遵守
-- 满足 / 违反（引用 spec 行号 + 代码证据；Out of Scope 检查结果）
-
-## 维度 3 · ADR 遵守
-- 0001 <标题>：遵守 / 违反（证据）
-
-## 维度 4 · 文档一致性
-- README.md：一致 / 过期信息（引用行 + 实现事实）
-
-## 未满足项清单（显式记录）
-- [阻断] <票号> <内容>：原因 + 需要什么
-- [非阻断] <内容>：原因
-
-## 待主 agent 隔离验证（L3 条目，如无则写"无"）
-- <条目>：升级条件 + 需验证内容
-
-## 备注
-- 证据级别说明（哪些条目用了 L1/L2/L3）
-- 本次审计为只读审计，仅新建本报告文件，未修改任何现有文档
-```
-
-## 出口条件（强制）
-
-- 输入无效按 fail-fast 出口：直接输出失败报告（逐项列出缺失内容），不生成审计报告文件。
-- 正常审计：四维全部给出结论、每维最严重问题列出、未满足项逐条列出、证据引用齐全 → 才可结束。
-- 报告不完整（缺维、未满足项遗漏、证据缺失）→ **继续补齐，不得提前结束**。

package/template/.opencode/commands/teach.md

@@ -1,12 +0,0 @@
----
-description: 教学——在当前工作区内教用户一个新技能或概念
----
-
-# Teach
-
-加载并执行 teach 技能，在当前工作区内教学：
-
-**主题：** $ARGUMENTS
-
-- 以当前目录为教学工作区（MISSION.md、reference、learning-records、lessons 等）
-- 按 MISSION 目标逐步教学，产出教学材料

package/template/.opencode/commands/to-spec.md

@@ -1,13 +0,0 @@
----
-description: 把当前对话综合为 spec 并发布到 issue tracker（不采访，只综合已讨论的内容）
----
-
-# To Spec
-
-加载并执行 to-spec 技能，把当前对话综合为 spec：
-
-**主题：** $ARGUMENTS
-
-- 只综合已讨论的内容，不新增采访提问
-- 按 spec 模板编写并发布到 issue tracker
-- 发布前展示给用户确认

package/template/.opencode/commands/to-tickets.md

@@ -1,12 +0,0 @@
----
-description: 把计划/spec/当前对话拆为一批 tracer-bullet 票，每票声明阻塞边，发布到 issue tracker
----
-
-# To Tickets
-
-加载并执行 to-tickets 技能，把计划或 spec 拆为票：
-
-**主题：** $ARGUMENTS
-
-- 拆为 tracer-bullet 票，每票声明其阻塞边
-- 发布到配置的 issue tracker（本地每票一个文件，或真实 tracker 的原生阻塞链接）

package/template/.opencode/commands/triage.md

@@ -1,12 +0,0 @@
----
-description: 分诊——把 issue 与外部 PR 按 triage 角色状态机流转：分类、验证、需要时 grill、写 agent-ready brief
----
-
-# Triage
-
-加载并执行 triage 技能，对 issue/PR 做分诊：
-
-**对象：** $ARGUMENTS
-
-- 按 triage 状态机流转：分类 → 验证 → 需要时 grill → 写 agent-ready brief
-- 遵守 triage labels 与 issue tracker 约定

package/template/.opencode/commands/wayfinder.md

@@ -1,13 +0,0 @@
----
-description: 巨型规划——把超出一个 agent 会话的大块工作规划为 issue tracker 上的决策票地图，逐票解决直到路径清晰
----
-
-# Wayfinder
-
-加载并执行 wayfinder 技能，为超长工作规划一张共享的决策票地图：
-
-**目标：** $ARGUMENTS
-
-- 把超过一个 agent 会话能容纳的工作拆为 issue tracker 上的决策票
-- 每票一个决策点，标注依赖与阻塞边
-- 逐票解决，直到通往目标的路径清晰

package/template/.opencode/commands/writing-for-agents.md

@@ -1,12 +0,0 @@
----
-description: 技能写作参考——编写和编辑技能的最佳实践（词汇表与原则，让技能可预测）
----
-
-# Writing Great Skills
-
-加载并执行 writing-for-agents 技能，编写/编辑技能：
-
-**主题：** $ARGUMENTS
-
-- 以技能设计规范为参考（回合连续性、模型选择、任务分解等原则）
-- 按 Agent Skills 标准编写可预测的技能文本

package/template/.pi/agents/issue-audit.md

@@ -1,52 +0,0 @@
----
-description: 审计 feature 的 issue 完成情况（四维：完成度 / spec 遵守 / ADR 遵守 / 文档一致性），输出完整报告（对话 + .scratch/<slug>/audit-<时间戳>.md）。只审计，物理上无法修改其他任何文件。使用场景：feature 收尾后、发布前、修复后复审或对完成度存疑时；输入为 feature slug（如 token-usage-stats）。
-mode: subagent
-permission:
-  read: allow
-  edit:
-    "*": deny
-    ".scratch/*/audit-*.md": allow
-  bash:
-    "*": deny
-    "git status": allow
-    "git status *": allow
-    "git log": allow
-    "git log *": allow
-    "git diff": allow
-    "git diff *": allow
-    "git show": allow
-    "git show *": allow
-    "git rev-parse *": allow
-    "git ls-files": allow
-    "git ls-files *": allow
-    "git grep": allow
-    "git grep *": allow
-    "cargo test --lib": allow
-    "cargo test --lib *": allow
-  task: deny
----
-
-# Issue Auditor
-
-你是 issue 完成情况的独立审计者，像外部质量审计员一样工作。
-
-## 铁律（不可违背）
-
-- **只审计，不修改任何现有文档与代码。** `edit` 权限被系统强制限制为仅 `.scratch/*/audit-*.md` 可写——你物理上无法修改其他任何文件；不尝试绕过（如通过 bash 写文件）。
-- **不勾选验收标准、不改 Status、不做 triage 流转。**
-- **输入无效立即失败（fail-fast）**：`.scratch/<slug>/` 不存在或为空、缺少 `spec.md`、`issues/` 下没有任何 issue 文件时，不进入审计流程，直接输出失败报告（逐项列出缺失内容）并结束。
-- 只读 git 命令（status/log/diff/show/rev-parse/ls-files/grep）与 `cargo test --lib` 允许用于收集证据；任何写操作命令一律不执行。
-
-## 为什么分四维（不可合并重排）
-
-四维是相互独立的审计轴：完成度（验收标准逐条）可以全绿，而 spec 决策被违背、ADR 被绕过或文档已过期。任一维的通过不得被其他维的结论掩盖，也不得用一维的发现解释掉另一维的未满足项；报告按维呈现、逐维给出最严重问题，由用户/主 agent 综合处置。
-
-## 执行
-
-- 完整流程由任务指令（issue-audit 命令正文）提供：输入来源、四维审计、证据分级（L1/L2/L3）、问题分级、报告模板、出口条件。
-- 严格按任务指令执行，不偏离、不省略任何维度。
-- 报告逐条独立可验证：每个验收标准、每个未满足项自成一条并附证据（文件:行号、测试名、提交哈希），不合并成模糊结论；阻断项写"违反了什么 + 需要什么"，不做过程性修复指示。
-- **结论总览须给出每维最严重问题各一行**（该维无问题时写"无"），不得只给汇总数字。
-- **报告文件名必须为 `audit-<YYYYMMDD-HHMM>.md`，精确到分钟**（如 `audit-20260802-0604.md`），不得省略分钟；同名文件已存在时追加 `-2` 序号，永不覆盖。
-- 报告语言中文；代码标识符、测试名、字段名、提交哈希保留原文。
-- 报告不完整不得结束——四维缺失、未满足项遗漏、证据缺失时继续补齐。

package/template/.pi/prompts/issue-audit.md

@@ -1,114 +0,0 @@
----
-description: 审计 feature 的 issue 完成情况（四维：完成度 / spec 遵守 / ADR 遵守 / 文档一致性），输出完整报告，只审计不修改
-argument-hint: "<feature-slug>"
----
-
-# Issue Audit：`$ARGUMENTS`
-
-对 feature `$ARGUMENTS` 执行完整 issue 审计（对应目录 `.scratch/$ARGUMENTS/`），按以下流程执行。
-
-## 铁律（不可违背）
-
-- **不修改任何现有文档与代码。** issue 文件、spec.md、README*、src-rust/、webui/ 等一切现有文件禁止改动。
-- **唯一允许的写入**：新建审计报告 `.scratch/$ARGUMENTS/audit-<YYYYMMDD-HHMM>.md`（时间戳文件名，保留多次审计历史）。不覆盖、不修改任何其他文件，不生成其他产物。
-- **不勾选验收标准、不改 Status、不做 triage 流转。** 状态机是 triage 技能的职责；审计只产出事实结论。
-- **输入无效立即失败（fail-fast）**：`.scratch/$ARGUMENTS/` 不存在或为空、缺少 `spec.md`、`issues/` 下没有任何 issue 文件时，不进入审计流程，直接输出失败报告（逐项列出缺失内容）并结束。
-- 审计与被审计分离：发现问题不修复、不流转，只在报告中记录（阻断项附"需要什么"），处置由用户决定。
-- 只读 git 命令（status/log/diff/show/rev-parse/ls-files/grep）用于收集提交历史证据；任何写操作命令一律不执行。
-- 报告语言中文；代码标识符、测试名、字段名、提交哈希保留原文。
-
-## 输入来源
-
-- `.scratch/$ARGUMENTS/spec.md`（Implementation Decisions、Testing Decisions、Out of Scope）
-- `.scratch/$ARGUMENTS/issues/*.md`（每票验收标准、Blocked by 依赖）
-- `.scratch/$ARGUMENTS/audit-*.md`（历史审计报告，读取最新一份作为对比基线；无则标注"无历史基线"）
-- `docs/adr/*.md`（架构决策，审计对象）
-- `CONTEXT.md`（术语表；违反术语视为 spec 遵守问题）
-- 当前工作树代码 + 只读 git 历史（提交哈希作为"确实做过"的证据）
-
-## 为什么分四维（不可合并重排）
-
-四维是相互独立的审计轴：完成度（验收标准逐条）可以全绿，而 spec 决策被违背、ADR 被绕过或文档已过期。任一维的通过不得被其他维的结论掩盖，也不得用一维的发现解释掉另一维的未满足项；报告按维呈现、逐维给出最严重问题，由用户综合处置。
-
-## 四维审计
-
-1. **完成度**：逐票核对每个 issue 的验收标准（checkboxes）——逐条判定满足/未满足，引用代码位置、单测名、提交哈希作为证据。Blocked by 依赖未满足的票不计入完成度。
-2. **Spec 遵守**：spec.md 的 Implementation Decisions 是否被落实、是否违背；Testing Decisions 的测试是否真实存在（非空头声明）；**Out of Scope 是否被越过**（实现做了 spec 明说不做的事 = 阻断项）。
-3. **ADR 遵守**：每个 `docs/adr/NNNN-*.md` 的决策在当前实现中是否被遵守。
-4. **文档一致性**：README.md / README_ZH.md（及受影响的其他用户文档）与当前实现是否一致——无过期信息、无声称未实现的功能（如 feature 中某 UI 尚未实现，文档不得声称其存在）、命令示例与界面描述与实际一致。
-
-## 证据分级（下结论的纪律）
-
-- **L1 静态**（默认）：读代码、读 git 提交记录、核对单测存在性与断言内容。
-- **L2 测试套件**：运行仓库完整测试套件（本项目：`cargo test --lib` 于项目根；如有 JS 侧测试一并运行）。每次审计必跑。
-- **L3 端到端**：仅在以下情形升级——① 某验收标准明确要求"链路可用/端到端"；② L1 静态核对发现不一致、仅靠静态无法定案。**审计执行内不执行 L3**；判定需要升级后，将条目列入报告「待主 agent 隔离验证」清单（注明升级条件与需验证内容），由主 agent 在隔离环境（临时 HOME + mock 上游）执行。
-- **弱证据不足**：间接、缺失、仅一致的证据不足以支撑"通过"结论；无法取证到位的条目标为非阻断疑点并注明"需要升级证据"。
-
-## 问题分级
-
-- **阻断项（must-fix）**：验收标准未达成、违反 ADR、越过 Out of Scope、违背 spec 决策。
-- **非阻断项（should-note）**：文档措辞、建议性改进、证据仅间接的疑点。
-- feature 结论 = 阻断项数 + 非阻断项数；**阻断为 0 才判定通过**。
-
-## 执行步骤（顺序自包含）
-
-1. 校验输入（fail-fast）：确认 `.scratch/$ARGUMENTS/` 存在且非空、`spec.md` 存在、`issues/` 下至少有一个 issue 文件；任一项不满足 → 输出失败报告（逐项列出缺失内容）并结束，不进入审计、不生成审计报告文件。校验通过后列出 spec、全部 issue、历史审计报告（若有）。
-2. 收集约定：读 spec.md、全部 issues、`docs/adr/`、CONTEXT.md。
-3. 逐票核对（维度 1）：每票验收标准逐条判定，记录证据。
-4. 维度 2：以 spec 决策与 Out of Scope 对照当前代码实现。
-5. 维度 3：以每个 ADR 对照当前实现。
-6. 维度 4：对照 README 等文档与当前实现。
-7. 跑 L2 测试套件（`cargo test --lib`），记录通过数/失败数。
-8. 判定 L3 升级条件，必要时列出待主 agent 隔离验证清单。
-9. 读取最新历史报告（若有）作基线，对比阻断项变化。
-10. 汇总四维报告：对话输出完整报告，并写入 `.scratch/$ARGUMENTS/audit-<YYYYMMDD-HHMM>.md`。
-    - **文件名必须精确到分钟**（如 `audit-20260802-0604.md`），格式为 `audit-` + 年(4)月(2)日(2)-时(2)分(2) + `.md`。不得省略分钟、不得用其他命名。
-    - 同分钟重跑导致同名时追加 `-2`、`-3` 序号（如 `audit-20260802-0604-2.md`），永不覆盖已有文件。
-
-## 报告原则（逐条独立可验证）
-
-- **逐条独立可验证**：每个验收标准、每个未满足项自成一条并附证据（文件:行号、测试名、提交哈希），不合并成模糊结论——读者可逐条复核。
-- **行为性表述**：阻断项写"违反了什么 + 需要什么"，不做过程性修复指示（如"应该打开 X 文件改 Y"）；证据引用（文件:行号）仅为定位证据，不作修复指令。
-- **不合并重排**：四维结论按维呈现、互不遮盖（见「为什么分四维」）。
-
-## 报告模板（强制，四维缺失视为未完成）
-
-```markdown
-# Issue 审计报告：$ARGUMENTS
-
-审计时间：<YYYY-MM-DD HH:MM>（精确到分钟）｜基线：<上次报告文件名 或 "无历史基线">
-
-## 结论总览
-- 阻断项：N 项 / 非阻断项：M 项 → 通过 / 未通过
-- 每维最严重问题：维度1：<票号+一句> ｜ 维度2：<一句> ｜ 维度3：<一句> ｜ 维度4：<一句>（该维无问题写"无"）
-- 与上次审计对比：新增解决 k 项 / 新引入 j 项 / 持续未满足 i 项（无历史基线时写"本次为首份报告"）
-
-## 维度 1 · 完成度（逐票）
-- 01 <标题>：满足 / 未满足（验收标准逐条 + 证据：文件:行号、测试名、提交哈希）
-
-## 维度 2 · Spec 遵守
-- 满足 / 违反（引用 spec 行号 + 代码证据；Out of Scope 检查结果）
-
-## 维度 3 · ADR 遵守
-- 0001 <标题>：遵守 / 违反（证据）
-
-## 维度 4 · 文档一致性
-- README.md：一致 / 过期信息（引用行 + 实现事实）
-
-## 未满足项清单（显式记录）
-- [阻断] <票号> <内容>：原因 + 需要什么
-- [非阻断] <内容>：原因
-
-## 待主 agent 隔离验证（L3 条目，如无则写"无"）
-- <条目>：升级条件 + 需验证内容
-
-## 备注
-- 证据级别说明（哪些条目用了 L1/L2/L3）
-- 本次审计为只读审计，仅新建本报告文件，未修改任何现有文档
-```
-
-## 出口条件（强制）
-
-- 输入无效按 fail-fast 出口：直接输出失败报告（逐项列出缺失内容），不生成审计报告文件。
-- 正常审计：四维全部给出结论、每维最严重问题列出、未满足项逐条列出、证据引用齐全 → 才可结束。
-- 报告不完整（缺维、未满足项遗漏、证据缺失）→ **继续补齐，不得提前结束**。