@heihei0299/matt-skills 3.0.10 → 3.0.12

package/README.md

@@ -12,11 +12,11 @@ template/
 └── .pi/                      pi prompts、docs 与项目自定义 skills 占位
 ```
 
-共享 Skills 不作为 Template Snapshot 的持久化副本；`init`、普通 `sync` 和 `install` 从 Workspace 的 canonical source 分发到各工具的默认项目目录：Codex 为 `.agents/skills/`、pi 为 `.pi/skills/`、opencode 为 `.opencode/skills/`、Claude 为 `.claude/skills/`。
+共享 Skills 不作为 Template Snapshot 的持久化副本；`init`、普通 `sync` 和项目级 `install` 都从 Workspace 的 canonical source 分发到唯一的 `.agents/skills/`。`.pi/skills/`、`.opencode/skills/` 和 `.claude/skills/` 仅用于项目自定义 skills。
 
 - `PROJECT.md` 描述项目是什么；操作规则放在 `AGENTS.md`。
 - `.opencode/CONTEXT.md` / `.pi/CONTEXT.md` 保存领域术语与边界。
-- 各工具默认项目目录承载共享 skills；同步只处理可分发 skill 名称，不删除额外的项目自定义 skills。
+- `.agents/skills/` 承载共享 skills；同步只处理可分发 skill 名称，不删除额外的项目自定义 skills。
 - `ci-guard`、`commit-check` 是本仓库维护用的 repo-local skills，不会分发到目标项目。
 
 ## 独有 skill 分发边界
@@ -73,13 +73,13 @@ npx @heihei0299/matt-skills check [--all] [--json] [--upstream <url>] [--ref <re
 
 - `--all`：包含全部可分发 skills，默认范围只包含 programming skills。
 - `--dest <dir>`：指定目标目录。
-- `--tools <list>`：选择 `codex`、`pi`、`opencode` 或 `claude`；项目级 skills 写入所选工具的默认目录。
+- `--tools <list>`：选择 `codex`、`pi`、`opencode` 或 `claude`；项目级 skills 统一写入 `.agents/skills/`，全局安装仍使用各工具目录。
 - `--global`：写入用户级 skills 目录。
 - `--dry-run`：只检查差异，不写入；`--json` 输出机器可读结果。
 
 ## Codex CLI 支持
 
-Codex 的项目级 skills 位于 `.agents/skills/`；全局 skills 位于 `~/.codex/skills`。`init` 和普通 `sync` 默认同时分发到四个工具的项目目录。
+Codex 的项目级 skills 位于 `.agents/skills/`；全局 skills 位于 `~/.codex/skills`。`init`、普通 `sync` 和项目级 `install` 共用 `.agents/skills/`，避免同一共享 skill 在多个项目目录产生镜像。
 
 ```sh
 npm run codex:smoke

package/bin/cli.js

@@ -33,7 +33,7 @@ process.stdout.on('error', (err) => {
   throw err;
 });
 
-const PROJECT_SKILL_DIRS = '.agents/skills、.pi/skills、.opencode/skills、.claude/skills';
+const PROJECT_SKILL_DIRS = '.agents/skills';
 
 const HELP_GLOBAL = `matt-skills — install and manage this skill collection
 
@@ -222,13 +222,18 @@ const TOOLS = ['codex', 'pi', 'opencode', 'claude'];
 
 const PROJECT_DIRS = {
   codex: '.agents/skills',
-  pi: '.pi/skills',
-  opencode: '.opencode/skills',
-  claude: '.claude/skills',
+  pi: '.agents/skills',
+  opencode: '.agents/skills',
+  claude: '.agents/skills',
 };
 
 function projectSkillTargets(target) {
-  return TOOLS.map((tool) => ({ tool, dir: path.resolve(target, PROJECT_DIRS[tool]) }));
+  const targets = new Map();
+  for (const tool of TOOLS) {
+    const dir = path.resolve(target, PROJECT_DIRS[tool]);
+    if (!targets.has(dir)) targets.set(dir, { tool, dir });
+  }
+  return [...targets.values()];
 }
 
 const GLOBAL_DIRS = {

package/package.json

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

package/template/.opencode/skills/README.md

@@ -1,4 +1,3 @@
 # 项目技能（opencode）
 
-此目录用于存放项目 skills（共享或 project-local）。
-共享技能默认在 `.opencode/skills/`；同步不会删除额外的项目自定义 skills。
+此目录仅用于存放 opencode 的项目自定义 skills。共享技能统一分发到 `.agents/skills/`；同步不会删除额外的项目自定义 skills。

package/template/.pi/skills/README.md

@@ -1,4 +1,3 @@
 # 项目技能（pi）
 
-此目录用于存放项目 skills（共享或 project-local）。
-共享技能默认在 `.pi/skills/`；同步不会删除额外的项目自定义 skills。
+此目录仅用于存放 pi 的项目自定义 skills。共享技能统一分发到 `.agents/skills/`；同步不会删除额外的项目自定义 skills。

package/template/AGENTS.md

@@ -1,28 +1,27 @@
 # AGENTS.md
 
 <!-- matt-skills:managed:start -->
-
 ## Workflow
 
-按任务目标选择 skill / 工具，并用一行声明：
+按任务选择最匹配的 skill / 工具：
 
-* 理解 / 定位 / 调用链 → `codegraph explore`
+* 代码理解 / 定位 / 调用链 → `codegraph explore`
 * 多来源调研 / 方案比较 / 技术选型 → `research`
 * 原型 / PoC → `prototype`
 * 代码审查 → `code-review`
 * 设计质询 → `grilling`
 * 领域建模 → `domain-modeling`
-* 无法归类 → `ask-matt`
-  `research` 仅用于需要多来源检索并综合分析的任务；事实、实时信息、单一资料查询直接使用对应工具。
-  仅当歧义会影响接口、数据、安全、范围或验收结果时询问用户。
+* 其他 → `ask-matt`
+
+`research` 仅用于多来源综合分析；事实、实时信息和单一资料查询直接使用对应工具。
+
+仅当歧义影响接口、数据、安全、范围或验收结果时询问用户。
+
 ## Context
 
-按需读取：
+按需读取 `README.md`、`PROJECT.md`、`CONTEXT.md`。
 
-* `README.md`
-* `PROJECT.md`
-* `CONTEXT.md`
-  以当前代码、配置、测试和版本化文档为事实来源。
+以当前代码、配置、测试和版本化文档为事实来源；项目特定规则、命令和完成标准以更具体的 `AGENTS.md` 为准。
 
 ## Code Navigation
 
@@ -32,56 +31,49 @@
 codegraph explore "<问题>"
 ```
 
-已锁定符号时使用：
+已锁定符号时：
 
 ```bash
 codegraph node "<符号>"
 ```
 
-无 `.codegraph/` 且允许写入时先执行 `codegraph init`。
+需要索引且适合写入时可执行 `codegraph init`。
 
-* 从最小必要上下文开始。
-* 信息不足时只补充缺口。
-* 不重复探索已确认的信息。
-* CodeGraph 不可用时降级到 `rg` 和最小文件读取。
-* `research` 不用于仓库内代码理解。
+从最小必要上下文开始，只补充缺失信息，不重复探索已确认内容。CodeGraph 不可用时降级到 `rg` 和最小文件读取。
 
 ## Development
 
-涉及行为或逻辑实现时默认使用 `tdd`。
+行为或逻辑实现默认使用 `tdd`：
 
-* 先建立最小测试或复现，再做最小实现。
-* 优先复用现有抽象、接口和依赖方向。
-* 不创建平行实现，不扩大任务范围。
-* 文案、格式、注释、机械重命名及不改变行为的配置可直接实现。
+* 先建立最小测试或可重复复现，再做最小实现。
+* 无适用自动化测试时，使用最小可验证方式证明行为正确。
+* 复用现有抽象、接口和依赖方向，不创建平行实现或扩大范围。
+* 文案、格式、注释、机械重命名和不改变行为的配置可直接修改。
 
-## Validation
+## Validation & Review
 
-优先验证：
+优先验证原问题复现路径、新增或直接相关测试及直接受影响模块。
 
-1. 原问题复现路径
-2. 新增或直接相关测试
-3. 直接受影响模块
-   修复后只复验失败项和新修改影响的检查。
-   公共 API、共享抽象、依赖方向或跨模块调用链变化时，扩大到受影响测试集。
-   不因普通修改自动运行全量测试，不重复仍然有效的等价验证。
+修复后只复验失败项及新增修改；仅当公共 API、共享抽象、依赖方向、跨模块调用链或影响面扩大时扩大验证范围。
 
-## Review
+不重复仍然有效的等价验证，不因普通修改自动运行全量测试；更具体规则要求的检查除外。
 
-默认只 review 本轮 diff、修改文件和直接受影响调用链。
-修复后只复验新增修改和此前未通过项。
-仅在影响面扩大或局部 review 不足时扩大范围。
+变更审查默认聚焦本轮 diff、修改文件和直接受影响调用链；任务本身要求更广范围时按任务范围审查。
 
 ## Git
 
 * 仅在用户要求时 commit。
 * commit 前检查 diff。
 * 只 stage 本次任务文件。
-* 不使用 `git add .` / `git add -A`。
+* 禁止 `git add .` / `git add -A`。
 * 不混入已有未提交修改。
 
-## Completion
+## Security
+
+* 不读取或提交 secrets。
+* 安装或升级依赖、部署、发布、`git push`、远程写操作及破坏性命令，必须获得用户对当前操作的明确授权。
 
-有实际修改时说明：改动、验证、未验证项 / 风险、commit hash（如有）。
+## Completion
 
+完成时说明改动或审查结论、已执行验证、未执行验证及原因、剩余风险；如有 commit，报告 commit hash。
 <!-- matt-skills:managed:end -->