@heihei0299/matt-skills 2.1.7 → 2.1.8

package/README.md

@@ -117,7 +117,7 @@ npm test
 npm run build:template
 ```
 
-测试位于 `test/`；模板由 `scripts/build-template.js` 从工作区生成，提交前应确保模板同步测试通过。
+测试位于 `test/`；模板由 `scripts/build-template.js` 生成，`template/AGENTS.md` 的独立源是 `config/template-AGENTS.md`。提交前应确保模板同步测试通过。
 
 ## 许可证
 

package/package.json

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

package/template/AGENTS.md

@@ -1,61 +1,86 @@
-## 路由
-命中即执行，并简短声明使用的 skill / 工具。
+# AGENTS.md
+
+## Workflow
+
+按任务目标选择 skill / 工具，并用一行声明：
+
 * 理解 / 定位 / 调用链 → `codegraph explore`
-* 外部调研 / 方案比较 → `research`
+* 多来源调研 / 方案比较 / 技术选型 → `research`
 * 原型 / PoC → `prototype`
-* 简单修改 → 直接实现
-* 实现 + 独立验收闭环 → `implement-review-loop`
-* TDD / 集成测试 → `tdd`
+* 实现 + 独立验收 → `implement-review-loop`
 * 代码审查 → `code-review`
 * 设计质询 → `grilling`
 * 领域建模 → `domain-modeling`
 * 无法归类 → `ask-matt`
-\仅当关键歧义会改变结果时询问用户。
+  `research` 仅用于需要多来源检索并综合分析的任务；事实、实时信息、单一资料查询直接使用对应工具。
+  仅当歧义会影响接口、数据、安全、范围或验收结果时询问用户。
+## Context
+
+按需读取：
+
+* `README.md`
+* `PROJECT.md`
+* `.opencode/CONTEXT.md`
+  以当前代码、配置、测试和版本化文档为事实来源。
+
+## Code Navigation
 
-## 项目上下文
-开始任务前按需读取：
-- `PROJECT.md`（若存在）：项目目标、范围和主要入口
-- `README.md`（若存在）：用户视角的使用与开发说明
-- `.opencode/CONTEXT.md`（若存在）：领域术语与边界
+仓库内代码理解优先使用：
 
-## CodeGraph
-仓库内代码理解首先使用：
 ```bash
 codegraph explore "<问题>"
 ```
-无 `.codegraph/` 时：
+
+已锁定符号时使用：
+
 ```bash
-codegraph init
-codegraph explore "<问题>"
+codegraph node "<符号>"
 ```
-* 从最小必要上下文开始；返回完整源码即视为已读。
-* 信息不足时只针对缺口继续 `explore`；已锁定符号时使用 `codegraph node`。
-* CodeGraph 无法提供必要信息时，才降级到最小必要的读取 / 搜索。
-* `research` 只用于仓库外信息。
-## 执行
-默认闭环：
-```text
-定位 → 实现 → 验证 → 修正
-```
-* 以仓库当前代码、类型、配置、测试和版本化文档为事实来源。
+
+无 `.codegraph/` 且允许写入时先执行 `codegraph init`。
+
+* 从最小必要上下文开始。
+* 信息不足时只补充缺口。
+* 不重复探索已确认的信息。
+* CodeGraph 不可用时降级到 `rg` 和最小文件读取。
+* `research` 不用于仓库内代码理解。
+
+## Development
+
+涉及行为或逻辑实现时默认使用 `tdd`。
+
+* 先建立最小测试或复现，再做最小实现。
 * 优先复用现有抽象、接口和依赖方向。
 * 不创建平行实现，不扩大任务范围。
-* 简单任务直接执行；复杂任务需要时形成最小可执行计划。
-* 仅在需要用户判断或授权时中断闭环。
-## 验证
-服从全局授权规则。
-* 默认只验证本次修改及直接受影响路径；优先相关单测、单文件测试、模块测试和原复现路径。
-* 修复什么就测试什么；根据反馈继续修正，不重复等价检查。
-* 不因每个小步骤自动扩大测试范围。
-* 仅当修改跨模块、触及公共接口/核心基础设施、局部验证不足以证明正确、进入发布/合并最终验收，或用户明确要求时，才考虑更大范围验证。
+* `implement-review-loop` 的实现阶段同样使用 `tdd`。
+* 文案、格式、注释、机械重命名及不改变行为的配置可直接实现。
+
+## Validation
+
+优先验证：
+
+1. 原问题复现路径
+2. 新增或直接相关测试
+3. 直接受影响模块
+   修复后只复验失败项和新修改影响的检查。
+   公共 API、共享抽象、依赖方向或跨模块调用链变化时，扩大到受影响测试集。
+   不因普通修改自动运行全量测试，不重复仍然有效的等价验证。
+
 ## Review
-* 默认只 review 本轮 diff、修改文件及直接受影响调用链。
-* 修复后只复验新增修改和此前未通过项，不重复审查无关代码。
-* 仅在影响面明显扩大、局部 review 无法建立信心、进入发布/合并最终验收，或用户明确要求时扩大 review 范围。
-## Harness
-同类问题反复出现时，优先将约束落实到测试、lint、类型、工具或代码结构，而不是继续扩充本文件。
+
+默认只 review 本轮 diff、修改文件和直接受影响调用链。
+修复后只复验新增修改和此前未通过项。
+仅在影响面扩大或局部 review 不足时扩大范围。
+
 ## Git
-有实际改动且满足全局规则时，每个用户请求最多一次 commit。
-* 提交前检查 diff。
+
+* 仅在用户要求时 commit。
+* 同一请求最多一个 commit。
+* commit 前检查 diff。
 * 只 stage 本次任务文件。
 * 不使用 `git add .` / `git add -A`。
+* 不混入已有未提交修改。
+
+## Completion
+
+有实际修改时说明：改动、验证、未验证项 / 风险、commit hash（如有）。