写权限:仅可写入目标 Skill 的 README.md、README.en.md(英文时)。禁止改 SKILL.md、scripts/、references/ 等其它文件;禁止为 README 跑安装/格式化命令。
上下文隔离:每一轮新目标 Skill 须独立收集材料;禁止沿用对话中其它 Skill 的措辞、章节或产品名。同一 Skill 续写时可读已有 README 做增量修改。
权威来源(优先级从高到低):
souce)references/readme_formate.md 第一节大纲 + 第三节正文模版SKILL.md(name、description、用户向能力描述;非 Agent 执行链)_meta.json / metadata、目标 references/(数据口径等硬事实)assets/*.md:仅语气与排版参考,不得抄其中的商店名/变量名生成产品介绍向用户说明,不是技术文档或 Agent 手册。
| 要写 | 不写(除非用户显式要求或材料有硬事实) |
|---|---|
| ---- | -------------------------------------- |
| 用户价值、怎么说、得到什么 | 脚本参数、内部字段、实现链路、运行环境/依赖安装 |
| 大纲表【必选】节 + 材料满足纳入条件的【可选】节 | FAQ、注意事项、更新日志、特色亮点、重要数据说明 |
| 固定格式节(密钥)逐行复刻第三节 | 同义改写固定 bullet、无材料填空、文末「详见 references…」 |
防脑补总则:第三节模版中有占位符的节,无对应可核材料则整节或整子块删除,不留空壳标题。description 只用于简介开篇一句(用户未提供一句话简介时);禁止用 description 自动生成「功能介绍」或扩写 FAQ。
用户本条指令优先于默认。
| 模式 | 触发 | 行为 |
|---|---|---|
| ---- | ---- | ---- |
| 仅补密钥 | 已有 README(或用户提供全文)且只要求加 apikey / REDFOX_API_KEY / 红狐密钥等 | 只插入/替换 ## 密钥获取与安全说明(6 条固定 bullet);不改其它章节;跳过模版确认 |
| 仅中文 | 「只要中文」「不要英文」等 | 只写 README.md |
| 要英文 | 「英文版」「README.en」等 | 以当前 README.md 全文重译 README.en.md;默认不改中文 |
| 默认 | 未声明上述 | 先 README.md,再译 README.en.md |
英文:README.en.md 结构与中文完全一致,整篇重译(禁止 patch 旧英文、禁止从 SKILL.md 另写结构)。一级标题 # [英文名] / [skill-id],skill-id = name 原文。「红狐 hub」固定译 RedFoxHub。
触发:须同时满足「已有文档」+「意图仅为补密钥」(见上表触发词:apikey、REDFOX_API_KEY、红狐密钥等;不含「生成 readme」「优化全文」)。
落盘:
assets/demo.README.md 的 6 条红狐 bullet(souce 默认 github)## 功能特性 与 ## 使用指南 之间readme_formate.md 第一节~第三节(产出英文时加第四节)name、用户本条补充、是否写密钥节、souce;按需读 _meta.json、目标 references/@ 了目标 Skill 并明确要求写 README → 直接落盘,不提问;否则简短说明后默认 A(约 10 秒无选 B 视为 A)| 章节 | 规则 |
|---|---|
| ---- | ---- |
| 一级标题 | # [中文名] / [skill-id],skill-id = name 原文,禁止改 |
| 简介 | 开篇一句 + 核心价值 + 适用对象;功能介绍子块仅用户本条提供时写入 |
| 核心功能 | 仅写 SKILL.md 中用户可感知的能力点;禁止脚本名与内部步骤;不凑条数 |
| 特色亮点 | 默认删除;仅材料有明确 2~4 条差异化卖点时写入 |
| 密钥获取与安全说明 | 材料或用户本条有 API Key / REDFOX_API_KEY 需求时写入 6 条固定块 |
| 使用指南 | 必选;话术/速查表来自 SKILL.md 示例或用户场景,禁止编造命令 |
| 使用场景 | 材料有场景信息则写四列表格;无实质则并入简介或删除 |
| FAQ / 注意事项 / 更新日志 / 技术附录 | 仅用户显式要求 |
简介、功能、使用指南、场景:通俗、面向用户。技术词替换(中英文同理):HTML→可视化页面;API/接口→服务/数据能力;抓取/解析→获取/读取;JSON/Python/脚本→按语境用「数据处理/自动执行」。
README.md / README.en.mdskill-id 未改[占位符];无 FAQ/注意事项等默认禁写节(除非用户要求)souce 默认 github;英文 RedFoxHub| 路径 | 用途 |
|---|---|
| ---- | ---- |
references/readme_formate.md | 大纲、占位符、正文模版(权威) |
assets/demo.README.md | 密钥块与语气参考 |
共 3 个版本