@heihei0299/matt-skills 3.0.30 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heihei0299/matt-skills",
-  "version": "3.0.30",
+  "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');