chore: governance - tighten repo hygiene

skills/auto-skill/assets/AGENTS.md

@@ -0,0 +1,9 @@
+# skills/auto-skill/assets/ Agent 指南
+
+本目录保存 `auto-skill` 的可复用资产。
+
+## 约束
+
+- 不存放临时输出、下载缓存或未整理的原始材料。
+- 资产命名必须能说明用途。
+- 资产被脚本或文档引用时，同步更新对应路径。

skills/auto-skill/assets/README.md

@@ -0,0 +1,9 @@
+# skills/auto-skill/assets
+
+`auto-skill` 的长期资产目录，用于保存模板、示例、schema 或可复用静态材料。
+
+## 维护规则
+
+- 只放 `auto-skill` 执行时需要复用的资产。
+- 大文件、生成物和临时抓取结果不得放入本目录。
+- 新增资产后在 `skills/auto-skill/README.md` 或 `SKILL.md` 中补充引用。

skills/auto-skill/references/AGENTS.md

@@ -0,0 +1,9 @@
+# skills/auto-skill/references/ Agent 指南
+
+本目录保存 `auto-skill` 的参考资料和操作细则。
+
+## 约束
+
+- 参考资料应服务于 `SKILL.md` 的渐进式展开，不要把主入口写成超长文档。
+- 外部事实变更时优先更新引用来源和日期。
+- 删除或重命名参考文件时，同步检查 `SKILL.md`、`README.md` 和脚本引用。

skills/auto-skill/scripts/AGENTS.md

@@ -0,0 +1,10 @@
+# skills/auto-skill/scripts/ Agent 指南
+
+本目录维护 `auto-skill` 的执行脚本和外部工具软链接入口。
+
+## 约束
+
+- 不把外部仓库源码复制进脚本目录；需要暴露时使用软链接或 submodule。
+- 不在脚本中硬编码本地绝对路径、Token 或账号信息。
+- 修改 shell 脚本后检查可执行位和基本语法。
+- `Skill_Seekers-development` 相关路径视为外部工具入口，主仓门禁不深入检查其内部链接。

skills/auto-skill/scripts/README.md

@@ -0,0 +1,16 @@
+# skills/auto-skill/scripts
+
+`auto-skill` 的辅助脚本目录。
+
+## 当前内容
+
+- `create-skill.sh` - 创建 skill 骨架。
+- `validate-skill.sh` - 校验 skill 结构。
+- `skill-seekers-*.sh` - Skill Seekers 相关适配脚本。
+- `Skill_Seekers-development`、`skill-seekers-src`、`skill-seekers-configs` - 指向外部仓库内容的软链接入口。
+
+## 维护规则
+
+- 软链接入口属于外部工具暴露面，不直接修改其目标内容。
+- 脚本应保持可重复执行，并在失败时输出明确原因。
+- 修改脚本后运行对应 `--help`、dry-run 或最小校验命令。