@heihei0299/matt-skills 3.0.12 → 3.0.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +11 -2
- package/bin/cli.js +1 -1
- package/package.json +1 -1
- package/template/AGENTS.md +0 -2
package/README.md
CHANGED
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
面向项目仓库的 Agent skills 与配置模板。模板包含项目 skeleton、`AGENTS.md`、项目上下文占位文件，以及 pi / opencode 所需的项目配置；共享 Skills 由 CLI 从 Workspace 的 canonical source 直接组装到目标项目。
|
|
4
4
|
|
|
5
|
+
当前发布版本：`v3.0.12`。
|
|
6
|
+
|
|
7
|
+
## 环境要求
|
|
8
|
+
|
|
9
|
+
- Node.js `>=18`。
|
|
10
|
+
- npm（随 Node.js 提供，用于安装和运行 CLI；也可通过 `npx` 直接调用）。
|
|
11
|
+
- Git（`sync`、`check` 和发布流程需要）。
|
|
12
|
+
|
|
5
13
|
## 模板内容
|
|
6
14
|
|
|
7
15
|
```text
|
|
@@ -15,6 +23,7 @@ template/
|
|
|
15
23
|
共享 Skills 不作为 Template Snapshot 的持久化副本；`init`、普通 `sync` 和项目级 `install` 都从 Workspace 的 canonical source 分发到唯一的 `.agents/skills/`。`.pi/skills/`、`.opencode/skills/` 和 `.claude/skills/` 仅用于项目自定义 skills。
|
|
16
24
|
|
|
17
25
|
- `PROJECT.md` 描述项目是什么；操作规则放在 `AGENTS.md`。
|
|
26
|
+
- 分发的 `AGENTS.md` 提供通用工作流；项目专用规则、命令、测试方式和完成标准由目标项目更具体的 `AGENTS.md` 补充。
|
|
18
27
|
- `.opencode/CONTEXT.md` / `.pi/CONTEXT.md` 保存领域术语与边界。
|
|
19
28
|
- `.agents/skills/` 承载共享 skills；同步只处理可分发 skill 名称，不删除额外的项目自定义 skills。
|
|
20
29
|
- `ci-guard`、`commit-check` 是本仓库维护用的 repo-local skills，不会分发到目标项目。
|
|
@@ -55,7 +64,7 @@ npx @heihei0299/matt-skills sync --all # 同步全部可分发 skills
|
|
|
55
64
|
npx @heihei0299/matt-skills sync --dry-run --json
|
|
56
65
|
```
|
|
57
66
|
|
|
58
|
-
`init` 默认保护已有 `AGENTS.md`；需要刷新完整模板时使用 `init --all`。默认 `sync`
|
|
67
|
+
`init` 默认保护已有 `AGENTS.md`；需要刷新完整模板时使用 `init --all`。默认 `sync` 保留已有 `AGENTS.md` 和项目规则，`sync --all` 才将其整体刷新为当前分发模板。`sync` 不删除目标项目的额外文件或自定义 skills。
|
|
59
68
|
|
|
60
69
|
默认 programming 范围中的 4 个独有 skills 是 `tdd-implement`、`diagnose-fix`、`grill-to-spec`、`show-me`。
|
|
61
70
|
|
|
@@ -100,7 +109,7 @@ npx @heihei0299/matt-skills sync --all # 同步全部可分发范围
|
|
|
100
109
|
|
|
101
110
|
## 发布
|
|
102
111
|
|
|
103
|
-
|
|
112
|
+
最近发布：`v3.0.12`。推送 `v*` 标签会触发 GitHub Actions：全量测试、模板检查和 npm 发布。
|
|
104
113
|
|
|
105
114
|
```sh
|
|
106
115
|
npm test
|
package/bin/cli.js
CHANGED
|
@@ -74,7 +74,7 @@ Sync options:
|
|
|
74
74
|
--help, -h Show this help
|
|
75
75
|
项目 skills：${PROJECT_SKILL_DIRS}
|
|
76
76
|
|
|
77
|
-
说明：默认不带 --all 增量同步默认 programming skill
|
|
77
|
+
说明：默认不带 --all 增量同步默认 programming skill，并保留现有 AGENTS.md；--all 时同步全部可分发 skill 并强制刷新 AGENTS.md。
|
|
78
78
|
|
|
79
79
|
提示：matt-skills --help 查看全量
|
|
80
80
|
`;
|
package/package.json
CHANGED
package/template/AGENTS.md
CHANGED