@heihei0299/matt-skills 3.0.18 → 3.0.20
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/package.json +1 -1
- package/template/AGENTS.md +20 -71
package/package.json
CHANGED
package/template/AGENTS.md
CHANGED
|
@@ -1,79 +1,28 @@
|
|
|
1
|
-
<!-- matt-skills:managed:start -->
|
|
2
|
-
# AGENTS.md
|
|
3
|
-
|
|
4
1
|
## Workflow
|
|
5
|
-
|
|
6
2
|
按任务选择最匹配的 skill / 工具：
|
|
7
|
-
|
|
8
|
-
*
|
|
9
|
-
* 多来源调研 / 方案比较 / 技术选型 → `research`
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
* 领域建模 → `domain-modeling`
|
|
14
|
-
* 其他 → `ask-matt`
|
|
15
|
-
|
|
16
|
-
`research` 仅用于多来源综合分析；事实、实时信息和单一资料查询直接使用对应工具。
|
|
17
|
-
|
|
18
|
-
仅当歧义影响接口、数据、安全、范围或验收结果时询问用户。
|
|
19
|
-
|
|
3
|
+
* 代码理解 / 定位 / 调用链 / 依赖关系 / 数据流 → `codegraph explore`
|
|
4
|
+
* 行为修改 / 功能实现 / bug 修复 / 逻辑调整 → `tdd`
|
|
5
|
+
* 多来源调研 / 方案比较 / 技术选型 / 最佳实践 / 外部实现 → `research`
|
|
6
|
+
`research` 仅用于多来源综合；单一资料、官方文档和实时事实直接查询。
|
|
7
|
+
未命中 skill 时直接执行。明确不改变行为的文案、注释、格式和机械修改无需 `tdd`。
|
|
8
|
+
仅当关键歧义无法从仓库事实解决，且会改变实现、范围、风险或验收结果时询问用户。
|
|
20
9
|
## Context
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
```bash
|
|
31
|
-
codegraph explore "<问题>"
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
已锁定符号时：
|
|
35
|
-
|
|
36
|
-
```bash
|
|
37
|
-
codegraph node "<符号>"
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
需要索引且适合写入时可执行 `codegraph init`。
|
|
41
|
-
|
|
42
|
-
从最小必要上下文开始，只补充缺失信息，不重复探索已确认内容。CodeGraph 不可用时降级到 `rg` 和最小文件读取。
|
|
43
|
-
|
|
44
|
-
## Development
|
|
45
|
-
|
|
46
|
-
行为或逻辑实现默认使用 `tdd`：
|
|
47
|
-
|
|
48
|
-
* 先建立最小测试或可重复复现，再做最小实现。
|
|
49
|
-
* 无适用自动化测试时，使用最小可验证方式证明行为正确。
|
|
50
|
-
* 复用现有抽象、接口和依赖方向，不创建平行实现或扩大范围。
|
|
51
|
-
* 文案、格式、注释、机械重命名和不改变行为的配置可直接修改。
|
|
52
|
-
|
|
53
|
-
## Validation & Review
|
|
54
|
-
|
|
55
|
-
优先验证原问题复现路径、新增或直接相关测试及直接受影响模块。
|
|
56
|
-
|
|
57
|
-
修复后只复验失败项及新增修改；仅当公共 API、共享抽象、依赖方向、跨模块调用链或影响面扩大时扩大验证范围。
|
|
58
|
-
|
|
59
|
-
不重复仍然有效的等价验证，不因普通修改自动运行全量测试；更具体规则要求的检查除外。
|
|
60
|
-
|
|
61
|
-
变更审查默认聚焦本轮 diff、修改文件和直接受影响调用链；任务本身要求更广范围时按任务范围审查。
|
|
62
|
-
|
|
10
|
+
以当前代码、配置、测试和版本化文档为事实来源；更具体的项目指令优先。
|
|
11
|
+
代码理解优先使用 `codegraph explore`；已锁定符号时使用 `codegraph node`。
|
|
12
|
+
只获取完成任务所需的最小上下文；信息充分后停止探索。CodeGraph 不足时降级到 `rg` 和必要文件读取。
|
|
13
|
+
实现时复用现有抽象、接口和依赖方向，不创建平行实现或无关扩展。
|
|
14
|
+
## Validation
|
|
15
|
+
验证应足以证明修改正确且未破坏直接受影响行为。
|
|
16
|
+
优先验证原问题、相关测试和直接受影响模块；不重复已有有效证据。
|
|
17
|
+
公共 API、共享抽象、跨模块调用链或局部验证不足时扩大验证范围；普通修改不自动运行全量测试。
|
|
63
18
|
## Git
|
|
64
|
-
|
|
65
19
|
* 仅在用户要求时 commit。
|
|
66
|
-
* commit 前检查 diff
|
|
67
|
-
* 只 stage 本次任务文件。
|
|
20
|
+
* commit 前检查 diff，只 stage 本次任务文件。
|
|
68
21
|
* 禁止 `git add .` / `git add -A`。
|
|
69
|
-
*
|
|
70
|
-
|
|
22
|
+
* 不覆盖、回滚或混入已有未提交修改。
|
|
71
23
|
## Security
|
|
72
|
-
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
|
|
24
|
+
* 不读取、输出或提交未经授权的真实 secrets。
|
|
25
|
+
* 按现有 lockfile 恢复依赖可直接执行。
|
|
26
|
+
* 新增/升级依赖、部署、发布、`git push`、远程写入和破坏性操作必须明确授权。
|
|
76
27
|
## Completion
|
|
77
|
-
|
|
78
|
-
完成时说明改动或审查结论、已执行验证、未执行验证及原因、剩余风险；如有 commit，报告 commit hash。
|
|
79
|
-
<!-- matt-skills:managed:end -->
|
|
28
|
+
完成时简要说明结果和验证；有重要未验证项、限制或风险时说明；有 commit 时报告 hash。
|