@heihei0299/matt-skills 3.1.2 → 3.1.3

package/README.md

@@ -66,6 +66,8 @@ 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。
 
+默认 `init` / `sync` 不分发 `.pi` 与 `.opencode`；需要完整 harness 配置时使用 `--all`。
+
 默认 workflow 范围固定为 9 个入口及依赖 skills，包含 `initialize-project`、`setup-matt-pocock-skills`、`grill-with-docs`、`to-spec`、`to-tickets`、`grilling`、`domain-modeling`、`tdd` 和 `diagnosing-bugs`；其中默认独有 skills 是 `initialize-project`。
 
 ## CLI

package/bin/cli.js

@@ -34,7 +34,7 @@ Usage:
 
 Init options:
   --dest <path>   Target directory (default: current directory)
-  --all           Include all distributable skills; default only default workflow skills
+  --all           Include all distributable skills and .pi/.opencode; default workflow skills only
   --help, -h      Show this help
 提示：已有 AGENTS.md 时 init 始终跳过；需要更新已有项目请使用 sync。
 
@@ -47,7 +47,7 @@ Usage:
   matt-skills sync [--all|--dry-run|--refresh-agents] [--dest <path>]
 
 Sync options:
-  --all              同步全部可分发技能；不改变 AGENTS.md 刷新策略
+  --all              同步全部可分发技能和 .pi/.opencode；不改变 AGENTS.md 刷新策略
   --refresh-agents   显式刷新 AGENTS.md；无受管区块时先备份为 AGENTS.md.bak
   --dry-run          预演目标项目变化，只比对不写盘
   --json             仅与 --dry-run 一起使用，输出机器可读结果

package/bin/commands/init.js

@@ -31,7 +31,7 @@ export async function runInit(args) {
   if (await pathExists(marker)) {
     process.stdout.write('模板已存在（AGENTS.md），跳过\n');
   } else {
-    await copyTemplate(target);
+    await copyTemplate(target, { includeHarness: all });
     const selectedSkills = await listSkillNames({ onlyProgramming });
     await distributeProjectSkills({ target, sourceDir: SKILLS_DIR, skillNames: selectedSkills });
     process.stdout.write(`模板：已复制（AGENTS.md、skills：${PROJECT_SKILLS_DIR}）\n`);

package/bin/commands/sync.js

@@ -55,7 +55,7 @@ async function syncCommand({ dest, all, dryRun, json, refreshAgents, quiet = fal
   }
 
   const target = dest ? path.resolve(process.cwd(), dest) : process.cwd();
-  const template = await syncTemplate({ target, refreshAgents });
+  const template = await syncTemplate({ target, refreshAgents, includeHarness: all });
   if (template.initialized) {
     output('未检测到现有项目（AGENTS.md 不存在），将执行全新初始化\n');
     output(`模板：已复制（AGENTS.md、skills：${PROJECT_SKILLS_DIR}）\n`);

package/bin/project/template.js

@@ -8,17 +8,18 @@ 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) {
+function shouldCopyTemplatePath(src, includeHarness) {
   const relative = path.relative(TEMPLATE_DIR, src);
   const parts = relative.split(path.sep);
-  return !(parts[0] === '.agents' && parts[1] === 'skills');
+  if (parts[0] === '.agents' && parts[1] === 'skills') return false;
+  return includeHarness || (parts[0] !== '.pi' && parts[0] !== '.opencode');
 }
 
-export async function copyTemplate(target) {
+export async function copyTemplate(target, { includeHarness = true } = {}) {
   await cp(TEMPLATE_DIR, target, {
     recursive: true,
     force: true,
-    filter: shouldCopyTemplatePath,
+    filter: (src) => shouldCopyTemplatePath(src, includeHarness),
   });
 }
 
@@ -77,10 +78,10 @@ export async function refreshAgentsFile(targetFile) {
   return 'full';
 }
 
-export async function syncTemplate({ target, refreshAgents }) {
+export async function syncTemplate({ target, refreshAgents, includeHarness = true }) {
   const marker = path.join(target, 'AGENTS.md');
   if (!(await pathExists(marker))) {
-    await copyTemplate(target);
+    await copyTemplate(target, { includeHarness });
     return { initialized: true, agentsManaged: false, agentsRefreshed: false, agentsRefreshMode: null };
   }
 
@@ -95,7 +96,9 @@ export async function syncTemplate({ target, refreshAgents }) {
       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 });
+  if (includeHarness) {
+    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/package.json

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