@heihei0299/matt-skills 3.0.27 → 3.0.29

package/README.md

@@ -51,7 +51,7 @@ repo-local skills 不会通过 `init`、`install`、`sync` 分发到用户项目
 在目标仓库根目录执行：
 
 ```sh
-npx @heihei0299/matt-skills init              # 安装默认 programming skills
+npx @heihei0299/matt-skills init              # 安装默认 workflow skills
 npx @heihei0299/matt-skills init --all       # 安装全部可分发 skills
 ```
 
@@ -65,7 +65,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。
 
-默认 programming 范围中的 5 个独有 skills 是 `tdd-implement`、`diagnose-fix`、`grill-to-spec`、`show-me`、`initialize-project`。
+默认 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` 获取。
 
 ## CLI
 
@@ -79,7 +79,7 @@ npx @heihei0299/matt-skills check [--all] [--json] [--upstream <url>] [--ref <re
 
 常用选项：
 
-- `--all`：包含全部可分发 skills，默认范围只包含 programming skills；不会隐式刷新 `AGENTS.md`。
+- `--all`：包含全部可分发 skills，默认范围只包含 workflow skills；不会隐式刷新 `AGENTS.md`。
 - `--refresh-agents`：显式刷新目标 `AGENTS.md`；与 `--all`、`--dry-run` 可组合。
 - `--dest <dir>`：指定目标目录。
 - `--tools <list>`：选择 `codex`、`pi`、`opencode` 或 `claude`；项目级 skills 统一写入 `.agents/skills/`，全局安装仍使用各工具目录。

package/bin/cli.js

@@ -15,18 +15,11 @@ import { loadSkillSet } from './skill-config.js';
 
 const SKILLS_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '.agents', 'skills');
 const TEMPLATE_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'template');
-const ENGINEERING_PATH = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'config', 'engineering.json');
-const REQUIRED_PATH = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'config', 'required.json');
-let ENGINEERING_SKILLS = null;
-async function loadEngineeringSkills() {
-  if (!ENGINEERING_SKILLS) ENGINEERING_SKILLS = await loadSkillSet(ENGINEERING_PATH, 'engineering');
-  return ENGINEERING_SKILLS;
-}
-
-let REQUIRED_SKILLS = null;
-async function loadRequiredSkills() {
-  if (!REQUIRED_SKILLS) REQUIRED_SKILLS = await loadSkillSet(REQUIRED_PATH, 'required');
-  return REQUIRED_SKILLS;
+const DEFAULT_PATH = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'config', 'default.json');
+let DEFAULT_SKILLS = null;
+async function loadDefaultSkills() {
+  if (!DEFAULT_SKILLS) DEFAULT_SKILLS = await loadSkillSet(DEFAULT_PATH, 'default');
+  return DEFAULT_SKILLS;
 }
 process.stdout.on('error', (err) => {
   if (err.code === 'EPIPE') process.exit(0);
@@ -55,7 +48,7 @@ Usage:
 
 Init options:
   --dest <path>   Target directory (default: current directory)
-  --all           Include all distributable skills; default only default programming skills
+  --all           Include all distributable skills; default only default workflow skills
   --help, -h      Show this help
 提示：已有 AGENTS.md 时 init 始终跳过；需要更新已有项目请使用 sync。
 
@@ -76,7 +69,7 @@ Sync options:
   --help, -h         Show this help
   项目 skills：${PROJECT_SKILL_DIRS}
 
-说明：默认同步默认编程 skill 并保留现有 AGENTS.md；--all 只扩大技能范围。
+说明：默认同步默认 workflow skill 并保留现有 AGENTS.md；--all 只扩大技能范围。
       --refresh-agents 与 --all、--dry-run 可组合；上游检查请使用 check。
 
 提示：matt-skills --help 查看全量
@@ -88,7 +81,7 @@ Usage:
   matt-skills list [--all] [--json]
 
 List options:
-  --all           List all distributable skills (default only default programming skills)
+  --all           List all distributable skills (default only default workflow skills)
   --json          Output as JSON
   --help, -h      Show this help
 
@@ -117,7 +110,7 @@ Usage:
 
 Install options:
   --tools <a,b>   Install for the given tools (codex, pi, opencode, claude); skips tool selection
-  --all           Install all distributable skills (default only default programming); skips skill selection
+  --all           Install all distributable skills (default only default workflow); skips skill selection
   --force         Overwrite existing skills
   --global        Install to the user's global skill directories
   --project       Install to project skill directories (default)
@@ -160,8 +153,7 @@ async function listSkillNames({ onlyProgramming = false } = {}) {
   return resolveSkillNames({
     availableNames: await listAvailableSkillNames(),
     mode: onlyProgramming ? 'default' : 'all',
-    engineering: onlyProgramming ? await loadEngineeringSkills() : [],
-    required: onlyProgramming ? await loadRequiredSkills() : [],
+    defaults: onlyProgramming ? await loadDefaultSkills() : [],
   });
 }
 
@@ -317,11 +309,11 @@ async function promptTools() {
 
 async function promptSkills(skills) {
   const res = await prompts({
-    type: 'multiselect',
+    type: 'autocompleteMultiselect',
     name: 'skills',
     message: '选择要安装的技能',
     choices: skills.map((s) => ({ title: s.name, value: s.name })),
-    instructions: '空格勾选，回车确认',
+    instructions: '输入过滤，空格勾选，回车确认',
   });
   return Array.isArray(res?.skills) ? res.skills : [];
 }
@@ -410,17 +402,17 @@ async function initCommand({ dest, all }) {
     installed = entries.filter((e) => e.isDirectory() && !e.name.endsWith('.bak') && e.name !== '.git' && e.name !== 'skill-creator' && !isRepoLocalSkill(e.name)).length;
   } catch {}
   const allSkillsFull = await listSkills({ onlyProgramming: false });
-  const programmingSkills = await listSkills({ onlyProgramming: true });
-  const programmingCount = programmingSkills.length;
+  const defaultSkills = await listSkills({ onlyProgramming: true });
+  const defaultCount = defaultSkills.length;
   const upstreamFull = allSkillsFull.filter((s) => !PROPRIETARY_SKILLS.has(s.name)).length;
-  const upstreamProg = programmingSkills.filter((s) => !PROPRIETARY_SKILLS.has(s.name)).length;
-  const displayTotal = onlyProgramming ? programmingCount : allSkillsFull.length;
-  const displayUpstream = onlyProgramming ? upstreamProg : upstreamFull;
+  const upstreamDefault = defaultSkills.filter((s) => !PROPRIETARY_SKILLS.has(s.name)).length;
+  const displayTotal = onlyProgramming ? defaultCount : allSkillsFull.length;
+  const displayUpstream = onlyProgramming ? upstreamDefault : upstreamFull;
   if (path.resolve(skillsDir) === path.resolve(SKILLS_DIR)) {
-    process.stdout.write(`技能：已装 ${installed}、跳过 0（可分发 ${allSkillsFull.length}，含上游 ${upstreamFull}；默认编程 ${programmingCount}，含上游 ${upstreamProg}）\n`);
+    process.stdout.write(`技能：已装 ${installed}、跳过 0（可分发 ${allSkillsFull.length}，含上游 ${upstreamFull}；默认 workflow ${defaultCount}，含上游 ${upstreamDefault}）\n`);
   } else {
     if (onlyProgramming) {
-      process.stdout.write(`技能：已装 ${installed}（默认编程 ${displayTotal}，含上游 ${displayUpstream}；可分发 ${allSkillsFull.length}，含上游 ${upstreamFull}）\n`);
+      process.stdout.write(`技能：已装 ${installed}（默认 workflow ${displayTotal}，含上游 ${displayUpstream}；可分发 ${allSkillsFull.length}，含上游 ${upstreamFull}）\n`);
     } else {
       process.stdout.write(`技能：已装 ${installed}（可分发 ${displayTotal}，含上游 ${displayUpstream}）\n`);
     }
@@ -454,7 +446,7 @@ async function compareDryRunTrees(target, stage) {
 function formatTargetComparison({ target, result, onlyProgramming, refreshAgents }) {
   const lines = [
     `目标: ${target}`,
-    `范围: ${onlyProgramming ? '默认编程' : '全部可分发'}${refreshAgents ? '；刷新 AGENTS.md' : ''}`,
+    `范围: ${onlyProgramming ? '默认 workflow' : '全部可分发'}${refreshAgents ? '；刷新 AGENTS.md' : ''}`,
     '',
   ];
   const totalDiff = result.added.length + result.updated.length + result.removed.length;
@@ -635,7 +627,7 @@ async function syncCommand({ dest, all, dryRun, json, refreshAgents, quiet = fal
   if (preservedRepoLocal.length) {
     output(`迁移提示：${preservedRepoLocal.join(', ')} 已不再分发，现有副本已保留\n`);
   }
-  const modeLabel = onlyProgramming ? '默认编程' : '全部可分发';
+  const modeLabel = onlyProgramming ? '默认 workflow' : '全部可分发';
   output(`技能：新增 ${installed}、更新 ${updated}（${modeLabel} ${allSkills.length}）\n`);
   output(`目标路径：${target}\n`);
 }

package/bin/skill-selection.js

@@ -1,25 +1,16 @@
-import {
-  DEFAULT_PROPRIETARY_SKILLS,
-  isDistributableSkill,
-} from './skill-boundaries.js';
+import { isDistributableSkill } from './skill-boundaries.js';
 
 function asSet(value) {
   return value instanceof Set ? new Set(value) : new Set(value ?? []);
 }
 
-export function resolveSkillNames({ availableNames, mode = 'default', engineering, required }) {
+export function resolveSkillNames({ availableNames, mode = 'default', defaults }) {
   if (mode !== 'default' && mode !== 'all') {
     throw new Error(`unknown skill selection mode: ${mode}`);
   }
 
   const available = asSet(availableNames);
-  const candidates = mode === 'all'
-    ? available
-    : new Set([
-      ...asSet(engineering),
-      ...asSet(required),
-      ...DEFAULT_PROPRIETARY_SKILLS,
-    ]);
+  const candidates = mode === 'all' ? available : asSet(defaults);
 
   return [...candidates]
     .filter((name) => available.has(name) && isDistributableSkill(name, available))

package/config/default.json

@@ -0,0 +1,13 @@
+[
+  "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

@@ -23,9 +23,7 @@
   ],
   "default": [
     "tdd-implement",
-    "diagnose-fix",
     "grill-to-spec",
-    "show-me",
     "initialize-project"
   ]
 }

package/config/required.json

@@ -1,5 +1,4 @@
 [
   "grilling",
-  "grill-me",
   "handoff"
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heihei0299/matt-skills",
-  "version": "3.0.27",
+  "version": "3.0.29",
   "description": "Agent skills + 项目配置模板：一条命令初始化 opencode / pi-agent 项目（含 mattpocock/skills 上游技能）",
   "type": "module",
   "bin": {
@@ -13,6 +13,7 @@
     "scripts/sync-upstream.js",
     "scripts/codex-smoke.js",
     "config/proprietary.json",
+    "config/default.json",
     "config/engineering.json",
     "config/required.json",
     "README.md"