@heihei0299/matt-skills 3.0.10 → 3.0.11

package/package.json

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

package/template/AGENTS.md

@@ -1,6 +1,12 @@
 # AGENTS.md
 
 <!-- matt-skills:managed:start -->
+<!-- 本区块由 matt-skills 管理；sync 会覆盖其中内容。项目专用规则请写在标记外或更具体路径的 AGENTS.md 中。 -->
+
+## Scope
+
+本区块定义受控本机开发环境中的跨项目通用项目级工作流。
+项目专用的技术栈、命令、目录、测试方式和完成标准由标记外规则或更具体路径下的 `AGENTS.md` 定义；这些规则可补充或覆盖一般工作流，但不得隐式覆盖安全授权边界。
 
 ## Workflow
 
@@ -13,8 +19,10 @@
 * 设计质询 → `grilling`
 * 领域建模 → `domain-modeling`
 * 无法归类 → `ask-matt`
-  `research` 仅用于需要多来源检索并综合分析的任务；事实、实时信息、单一资料查询直接使用对应工具。
-  仅当歧义会影响接口、数据、安全、范围或验收结果时询问用户。
+
+`research` 仅用于需要多来源检索并综合分析的任务；事实、实时信息、单一资料查询直接使用对应工具。
+仅当歧义会影响接口、数据、安全、范围或验收结果时询问用户。
+
 ## Context
 
 按需读取：
@@ -22,7 +30,8 @@
 * `README.md`
 * `PROJECT.md`
 * `CONTEXT.md`
-  以当前代码、配置、测试和版本化文档为事实来源。
+
+以当前代码、配置、测试和版本化文档为事实来源。
 
 ## Code Navigation
 
@@ -50,7 +59,7 @@ codegraph node "<符号>"
 
 涉及行为或逻辑实现时默认使用 `tdd`。
 
-* 先建立最小测试或复现，再做最小实现。
+* 先建立项目支持的最小测试或可重复复现，再做最小实现；项目没有适用的自动化测试入口时，使用能够证明行为正确的最小可验证方式。
 * 优先复用现有抽象、接口和依赖方向。
 * 不创建平行实现，不扩大任务范围。
 * 文案、格式、注释、机械重命名及不改变行为的配置可直接实现。
@@ -62,9 +71,10 @@ codegraph node "<符号>"
 1. 原问题复现路径
 2. 新增或直接相关测试
 3. 直接受影响模块
-   修复后只复验失败项和新修改影响的检查。
-   公共 API、共享抽象、依赖方向或跨模块调用链变化时，扩大到受影响测试集。
-   不因普通修改自动运行全量测试，不重复仍然有效的等价验证。
+
+* 修复后只复验失败项和新修改影响的检查。
+* 公共 API、共享抽象、依赖方向或跨模块调用链变化时，扩大到受影响测试集。
+* 不因普通修改自动运行全量测试，不重复仍然有效的等价验证。
 
 ## Review
 
@@ -80,8 +90,13 @@ codegraph node "<符号>"
 * 不使用 `git add .` / `git add -A`。
 * 不混入已有未提交修改。
 
+## Security
+
+* 不读取或提交 secrets。
+* 依赖安装或升级、部署、发布、`git push`、远程系统写操作及破坏性命令，须获得针对当前操作的用户明确授权。
+
 ## Completion
 
-有实际修改时说明：改动、验证、未验证项 / 风险、commit hash（如有）。
+完成时说明改动或审查结论、已执行验证、未执行验证及剩余风险；如有 commit，再报告 commit hash。
 
 <!-- matt-skills:managed:end -->