@heihei0299/matt-skills 1.1.0 → 1.1.1

package/README.md

@@ -9,7 +9,7 @@ template/
 ├── AGENTS.md         项目级全局配置（行为路由 + 分文件指针）
 ├── .pi/              pi-agent 项目配置（pi 标准结构：`.pi/skills/` 直放独有技能，自动发现）
 └── .opencode/        分发内容（目标仓库的 opencode 项目配置）
-    ├── skills/       4 个独有技能（tdd-implement、grill-to-spec、diagnose-fix、commit-check）
+    ├── skills/       5 个独有技能（tdd-implement、grill-to-spec、diagnose-fix、commit-check、instance-test）
     ├── agents/       issue-audit 子代理定义
     ├── commands/     issue-audit + 9 个显式触发技能命令（grill-to-spec/wayfinder/to-spec/to-tickets/triage/improve-codebase-architecture/teach/handoff/writing-great-skills）
     ├── docs/agents/  5 个分文件（运行时纪律 / 技能设计 / issue tracker / triage labels / domain）
@@ -160,8 +160,11 @@ npm publish
 ## 开发
 
 ```sh
-npm test
+npm test                          # 全量测试 122 项
+npm run build:template            # 从单源生成 template/.opencode/.pi（config/proprietary.json 为单一事实源）
 ```
 
-交互模式依赖 `prompts`（见 `package.json`）；测试见 `test/cli.test.js`。
+交互模式依赖 `prompts`（见 `package.json`）；测试见 `test/cli.test.js`、`test/cli-init.test.js`、`test/template-sync.test.js`。
+
+用户手动触发的功能测试：`/instance-test`（见 `.agents/skills/instance-test/SKILL.md`）——在隔离 `temp dir` 跑 prompt 实例验实际功能，`references/instances.md` 为通用模板。
 

package/bin/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readdir, readFile, cp, stat } from 'node:fs/promises';
+import { readdir, readFile, cp, stat, writeFile, mkdir } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -88,6 +88,21 @@ async function backupIfExists(p) {
   return bak;
 }
 
+async function ensureSkillsGitignore(skillsDir) {
+  try {
+    await mkdir(skillsDir, { recursive: true });
+    const gi = path.join(skillsDir, '.gitignore');
+    const content = '# matt-skills backup — pi skips .bak via explicit filter + this fallback\n*.bak\n*.bak/\n';
+    if (await pathExists(gi)) {
+      const cur = await readFile(gi, 'utf8');
+      if (cur.includes('*.bak')) return;
+      await writeFile(gi, cur.endsWith('\n') ? `${cur}${content}` : `${cur}\n${content}`);
+    } else {
+      await writeFile(gi, content);
+    }
+  } catch {}
+}
+
 const TOOLS = ['codex', 'pi', 'opencode', 'claude'];
 
 const PROJECT_DIRS = {
@@ -219,6 +234,7 @@ async function initCommand({ dest, force }) {
   } else {
     process.stdout.write(`上游技能：已装 ${installed}、跳过 ${skipped}\n`);
   }
+  await ensureSkillsGitignore(skillsDir);
   process.stdout.write(`目标路径：${target}\n`);
 }
 
@@ -275,6 +291,7 @@ async function syncCommand({ dest, force }) {
   } else {
     process.stdout.write(`上游技能：新增 ${installed}、更新 ${updated}\n`);
   }
+  await ensureSkillsGitignore(skillsDir);
   process.stdout.write(`目标路径：${target}\n`);
 }
 

package/package.json

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