文档

发布 skill

解读技能是一份文字说明,用来调整解释方式、表达风格和反思问题。排盘、抽牌和起卦仍由 fate 的本地引擎完成。当前采用人工提交与审核流程。

  1. 选择一种现有方法,写清技能能帮助解读什么。
  2. 在一个文件夹中准备四个必需文件,可另附参考文字。
  3. 按示例填写 skill.json,核对方法与 engine 一一对应。
  4. 在 SKILL.md 写解读规则,保留全部已给出的事实。
  5. 补齐完整许可证、署名、来源和修改说明,再自行发邮件提交。
  6. 收到审核反馈后修改;维护者核对授权并取得明确发布许可,才随服务版本发布。

1. 准备文件

使用能保存 UTF-8 纯文本的编辑器。保留文件名和扩展名;不要保存成 Word、富文本或程序文件。

  • skill.json:技能标识、方法、版本及文字解读配置。
  • SKILL.md:实际解读规则与表达方式。
  • LICENSE:你允许公开使用的完整许可证及版权声明。
  • SOURCE.md:原作者、可核实的来源、固定版本及你做的修改。
  • references/:可选参考文字;只接受安全文件名的 .md,例如 cards.md。
my-skill/
  skill.json
  SKILL.md
  LICENSE
  SOURCE.md
  references/
    cards.md

2. 填写技能信息

复制下方 JSON 示例,替换 your-name 为自己的公开作者标识,再修改名称和版本。JSON 使用双引号,不加注释或额外字段。

{
  "id": "your-name/tarot-reflection",
  "method": "tarot",
  "version": "1.0.0",
  "displayName": "Tarot reflection",
  "engine": "deepfate/tarot@v1",
  "aliases": [
    "reflection",
    "card-reflection"
  ],
  "interpret": {
    "kind": "prompt-only",
    "path": "SKILL.md"
  },
  "trust": "third-party"
}
  • id:作者标识/技能名,只用英文字母、数字、下划线或连字符;保持稳定,不冒用官方标识。
  • method:从下表选一个;技能只解释该方法已有的事实。
  • version:使用 1.0.0 这样的三段数字,不带预发布后缀或多余前导零。
  • displayName:用户看到的名称,最多120个字符。
  • engine:按下表原样填写,不指定程序、网站接口或其他引擎。
  • aliases:可选、不重复的别名,最多20个,每个最多120个字符。
  • interpret:文字模式为 prompt-only,正文路径保持 SKILL.md。
  • trust:提交的社区扩展用 third-party;此字段不授予官方身份。

方法与本地引擎

method方法与本地引擎engine
bazi八字deepfate/bazi@lizhun-v1
tarot塔罗deepfate/tarot@v1
qimen奇门遁甲deepfate/qimen@v1
liuyao六爻deepfate/liuyao@v1
ziwei紫微斗数deepfate/ziwei@v1

若选其他方法,同时更改 method 和对应 engine。保持牌名、位置、正逆位、四柱、卦象等已给出的数据;缺失信息要说明,不能补造时辰、重新抽牌、掷币或替换本地排盘结果。

3. 写解读正文

先说明采用的解释方式,再说明如何把给定事实联系到用户问题。可参考下面的小模板。医疗、法律、金融或危机问题应保留专业帮助边界。

# 塔罗反思

只解释 fate 已提供的牌阵事实,保留牌名、位置和正逆位。
把事实、可能的解释和不确定性分开说明。
联系用户的问题,提出两个本人可以回答的反思问题。
给出一个本人可以选择的小步骤,用用户的界面语言表达。
不增加抽牌、不补造事实、不调用外部工具,不要求登录或付款。
  • 正文与参考文件只包含解读文字,不加入脚本、可执行文件或模型工具调用。
  • 当前文字扫描会拒绝 read、write、edit、bash、grep、find 这几个独立英文词;不要把它们作为指令或别名。英文稿可使用 explain、describe、interpret 等表达。
  • 文件中不放真实命主资料、用户聊天记录、会员凭据或 API Key。示例使用虚构内容。

4. 核对许可与来源

公开目录目前接受 MIT 或 Apache-2.0。选用你有权提供的完整许可证;仅写许可证名称不足以替代正文。

原创内容可参考下方 MIT 模板,替换年份和公开版权人姓名;如使用上游内容,保留原版权声明、作者与许可,并说明修改。

SOURCE.md 记录出处、固定提交或版本及你的贡献。只有获授权的文字才提交;维护者会核对来源,并确定目录中的可追溯来源页面。

LICENSE · MIT
MIT License

Copyright (c) [year] [your public name]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
SOURCE.md
# Source

- Author and publisher: [your public name].
- Skill ID and version: your-name/tarot-reflection, 1.0.0.
- Origin: [original text, or exact upstream sources and revisions].
- License: MIT; full terms are included in LICENSE.
- Attribution and modifications: [authors credited and changes made].

文件和包限制

  • 最多32个文件,包含四个必需文件与参考文字。
  • 每个文件最多128 KiB(131072字节),按 UTF-8 字节计算。
  • 维护者生成的原始 JSON 文本包最多512 KiB(524288字节),包含包装、路径和转义;各文件大小相加不代表最终包大小。
  • 所有内容为非空且有效的 UTF-8 纯文本;换行与制表符可以保留,不加入其他控制字符。
  • 参考文件使用 references/cards.md 这样的路径;文件名只用英文字母、数字、下划线或连字符,不包含父路径、链接、嵌套目录或程序。

5. 自行发送提交邮件

使用自己的邮件客户端发送到 service@mail.faleme.ai。下面的链接只打开邮件草稿;请核对收件人和内容,附上文件,再由你自行发送。

在邮件中填写希望公开的作者名、技能ID与版本、所用方法、简短说明、来源/许可和更新内容。说明你有权提交这些文字,以及允许发布的许可证。

逐一附上四个必需纯文本文件;有参考文件时,在邮件中标明 references/ 相对路径。不要发送账号密码、API Key或用户私密资料。

打开提交邮件草稿 →
公开作者名:
技能ID与版本:
方法:
简短说明:
来源与许可证:
修改内容:
我有权提交这些文字;希望维护者按声明的许可审核其公开发布。

6. 审核与发布

维护者会检查格式、事实边界、内容、作者与授权,并反馈需修改的地方。随后核对发布版本与完整性;获得明确发布许可后,才生成固定版本包并随服务发布,官网重新构建。

发布完成后,目录和详情会提供版本固定的桌面预览入口。扩展安装需要 Plus;用户在 fate 中查看内容后确认安装。提交邮件本身不代表审核已完成。

更新已有技能

保持原id、方法与发行类型;修改已发布文字时增加version,例如1.0.0→1.0.1。已有版本的内容和摘要不能覆盖。

用同一流程提交新版本,说明修改及来源变化。用户会看到替换说明并自行确认更新;已安装内容和默认选择会保留。

常见退回原因

  • JSON多了未知字段、方法与engine不匹配、版本格式错误或别名重复:按示例修正。
  • 遗漏许可/来源、文件过大、参考路径不合规或正文包含脚本/工具指令:补齐材料或精简文字。
  • 内容重算或改写事实、增加随机选择、宣称没有依据的能力或含用户资料:修订为对已提供事实的文字解读。