@heihei0299/matt-skills 3.0.29 → 3.1.0

package/bin/project/template.js

@@ -0,0 +1,101 @@
+import { cp, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { mergeManagedAgents, syncManagedAgents } from './agents.js';
+import { pathExists, sameTree } from './filesystem.js';
+
+const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), '../..');
+export const TEMPLATE_DIR = path.join(ROOT, 'template');
+const DRY_RUN_PATHS = ['AGENTS.md', 'AGENTS.md.bak', '.opencode', '.pi', '.agents/skills', '.claude/skills'];
+
+function shouldCopyTemplatePath(src) {
+  const relative = path.relative(TEMPLATE_DIR, src);
+  const parts = relative.split(path.sep);
+  return !(parts[0] === '.agents' && parts[1] === 'skills');
+}
+
+export async function copyTemplate(target) {
+  await cp(TEMPLATE_DIR, target, {
+    recursive: true,
+    force: true,
+    filter: shouldCopyTemplatePath,
+  });
+}
+
+export async function copyDryRunInputs(target, stage) {
+  for (const relative of DRY_RUN_PATHS) {
+    const source = path.join(target, relative);
+    if (!await pathExists(source)) continue;
+    const destination = path.join(stage, relative);
+    await mkdir(path.dirname(destination), { recursive: true });
+    await cp(source, destination, { recursive: true, force: true });
+  }
+}
+
+export async function compareDryRunTrees(target, stage) {
+  const result = { added: [], updated: [], removed: [] };
+  for (const relative of DRY_RUN_PATHS) {
+    const before = path.join(target, relative);
+    const after = path.join(stage, relative);
+    const beforeExists = await pathExists(before);
+    const afterExists = await pathExists(after);
+    if (!beforeExists && afterExists) result.added.push(relative);
+    else if (beforeExists && !afterExists) result.removed.push(relative);
+    else if (beforeExists && afterExists && !await sameTree(before, after)) result.updated.push(relative);
+  }
+  return result;
+}
+
+export function formatTargetComparison({ target, result, onlyProgramming, refreshAgents }) {
+  const lines = [
+    `目标: ${target}`,
+    `范围: ${onlyProgramming ? '默认 workflow' : '全部可分发'}${refreshAgents ? '；刷新 AGENTS.md' : ''}`,
+    '',
+  ];
+  const totalDiff = result.added.length + result.updated.length + result.removed.length;
+  if (totalDiff === 0) {
+    lines.push('✅ 无需更新');
+    return lines.join('\n');
+  }
+  if (result.added.length) lines.push(`新增 (${result.added.length}): ${result.added.join(', ')}`);
+  if (result.updated.length) lines.push(`更新 (${result.updated.length}): ${result.updated.join(', ')}`);
+  if (result.removed.length) lines.push(`删除 (${result.removed.length}): ${result.removed.join(', ')}`);
+  return lines.join('\n');
+}
+
+export async function refreshAgentsFile(targetFile) {
+  const templateFile = path.join(TEMPLATE_DIR, 'AGENTS.md');
+  const current = await readFile(targetFile, 'utf8');
+  const template = await readFile(templateFile, 'utf8');
+  const merged = mergeManagedAgents(current, template);
+  if (merged !== null) {
+    if (merged !== current) await writeFile(targetFile, merged);
+    return 'managed';
+  }
+  await cp(targetFile, `${targetFile}.bak`, { force: true });
+  await cp(templateFile, targetFile, { force: true });
+  return 'full';
+}
+
+export async function syncTemplate({ target, refreshAgents }) {
+  const marker = path.join(target, 'AGENTS.md');
+  if (!(await pathExists(marker))) {
+    await copyTemplate(target);
+    return { initialized: true, agentsManaged: false, agentsRefreshed: false, agentsRefreshMode: null };
+  }
+
+  let agentsManaged = false;
+  let agentsRefreshed = false;
+  let agentsRefreshMode = null;
+  if (refreshAgents) {
+    agentsRefreshMode = await refreshAgentsFile(marker);
+    agentsRefreshed = true;
+  } else {
+    try {
+      agentsManaged = await syncManagedAgents(marker, path.join(TEMPLATE_DIR, 'AGENTS.md'));
+    } catch {}
+  }
+  await cp(path.join(TEMPLATE_DIR, '.opencode'), path.join(target, '.opencode'), { recursive: true, force: true });
+  await cp(path.join(TEMPLATE_DIR, '.pi'), path.join(target, '.pi'), { recursive: true, force: true });
+  return { initialized: false, agentsManaged, agentsRefreshed, agentsRefreshMode };
+}

package/bin/{skill-boundaries.js → skills/boundaries.js}

@@ -2,7 +2,7 @@ import { readFileSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
 const CONFIG_PATH = path.join(ROOT, 'config', 'proprietary.json');
 const config = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
 

package/bin/skills/discovery.js

@@ -0,0 +1,63 @@
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveSkillNames } from './selection.js';
+import { loadSkillSet } from './config.js';
+
+const ROOT = path.join(path.dirname(fileURLToPath(import.meta.url)), '../..');
+export const SKILLS_DIR = path.join(ROOT, '.agents', 'skills');
+const DEFAULT_PATH = path.join(ROOT, 'config', 'default.json');
+let DEFAULT_SKILLS = null;
+
+async function loadDefaultSkills() {
+  if (!DEFAULT_SKILLS) DEFAULT_SKILLS = await loadSkillSet(DEFAULT_PATH, 'default');
+  return DEFAULT_SKILLS;
+}
+
+export function parseFrontmatter(text) {
+  const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return {};
+  const fields = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const m = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!m) continue;
+    let value = m[2].trim();
+    if (value.startsWith('"') && value.endsWith('"')) {
+      value = value.slice(1, -1).replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+    }
+    fields[m[1]] = value;
+  }
+  return fields;
+}
+
+export async function listAvailableSkillNames() {
+  const entries = await readdir(SKILLS_DIR, { withFileTypes: true });
+  return entries
+    .filter((entry) => entry.isDirectory())
+    .filter((entry) => !entry.name.endsWith('.bak'))
+    .filter((entry) => entry.name !== 'skill-creator' && entry.name !== '.git')
+    .map((entry) => entry.name);
+}
+
+export async function listSkillNames({ onlyProgramming = false } = {}) {
+  return resolveSkillNames({
+    availableNames: await listAvailableSkillNames(),
+    mode: onlyProgramming ? 'default' : 'all',
+    defaults: onlyProgramming ? await loadDefaultSkills() : [],
+  });
+}
+
+export async function listSkills({ onlyProgramming = false } = {}) {
+  const skills = [];
+  for (const name of await listSkillNames({ onlyProgramming })) {
+    let content;
+    try {
+      content = await readFile(path.join(SKILLS_DIR, name, 'SKILL.md'), 'utf8');
+    } catch {
+      continue;
+    }
+    const { description } = parseFrontmatter(content);
+    if (description) skills.push({ name, description });
+  }
+  return skills.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+}

package/bin/{skill-selection.js → skills/selection.js}

@@ -1,4 +1,4 @@
-import { isDistributableSkill } from './skill-boundaries.js';
+import { isDistributableSkill } from './boundaries.js';
 
 function asSet(value) {
   return value instanceof Set ? new Set(value) : new Set(value ?? []);

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.1.0",
   "description": "Agent skills + 项目配置模板：一条命令初始化 opencode / pi-agent 项目（含 mattpocock/skills 上游技能）",
   "type": "module",
   "bin": {

package/scripts/sync-upstream.js

@@ -5,8 +5,8 @@ import { spawnSync } from 'node:child_process';
 import path from 'node:path';
 import os from 'node:os';
 import { fileURLToPath } from 'node:url';
-import { PROPRIETARY_SKILLS } from '../bin/skill-boundaries.js';
-import { loadSkillSet } from '../bin/skill-config.js';
+import { PROPRIETARY_SKILLS } from '../bin/skills/boundaries.js';
+import { loadSkillSet } from '../bin/skills/config.js';
 
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 const LOCAL_SKILLS_DIR = path.join(ROOT, '.agents', 'skills');

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` 序号，永不覆盖。
-- 报告语言中文；代码标识符、测试名、字段名、提交哈希保留原文。
-- 报告不完整不得结束——四维缺失、未满足项遗漏、证据缺失时继续补齐。