docs: standardize skill-template and add development guide

references/README.md

@@ -0,0 +1,30 @@
+---
+description: "这是规范化的新技能模板说明，不直接作为业务技能使用。复制后请替换技能名、平台名、CLI 示例与 service 实现。"
+---
+
+# 技能模板说明
+
+这个仓库是**给开发者复制的新技能模板**，不是终端用户直接调用的业务 skill。
+
+## 它提供什么
+
+- 标准目录结构
+- 最小 CLI 入口
+- 发布型技能常见的日志表骨架
+- `service` 层占位模块
+- 与现有规范 skill 一致的发布脚本与 GitHub workflow
+
+## 复制后你需要改什么
+
+- `SKILL.md` 中的名称、描述、slug、触发说明
+- `references/CLI.md` 里的命令示例
+- `scripts/util/constants.py` 中的 slug / 版本 / logger 名
+- `scripts/service/` 下的真实业务实现
+
+## 不建议再保留的旧结构
+
+- 旧模板里的 `docs/`
+- 旧模板里的 `optional/`
+- 旧入口 `scripts/skill_main.py`
+
+新模板统一使用 `scripts/main.py` 作为入口。