# 卡 > **能力、身份和访问的便携式令牌。** 卡片是模板。将它们放在[房间]()中“玩”以激活它们。 > [!TIP] **英雄故事。** 演员。智慧的安全指引。没有冒充的风险，只有致敬、讲故事、分享技能和创作。 ** ** ## 📑 索引 **架构** * 卡牌架构——最重要的部分！ * 推荐部分顺序 * 什么去哪里 * 方法之前的广告 * 方法放置规则 **卡片类型** * 什么是卡？ * 边车模式 * 卡类型 **力学** * 激活记录 * 卡状态 * 收藏 ** ** ## 卡架构 > **关键见解：卡片是激活触发器，而不是激活处理程序。** 这是MOOLLM卡设计中最重要的概念。 ### 根本区别 |卡.yml |技能.md ---|---|--- **目的** |决定该技能是否适用 |解释如何执行 **角色** |激活触发器|激活处理程序 **内容** |可嗅探接口|完整文档 **尺寸** | ~150-200 行 |根据需要 **法学硕士阅读** |一、决定|二、如果激活 CARD 问道：“这种情况需要我吗？” SKILL.md 回答：“这里是实际操作方法。” ### 推荐部分顺序订购最佳 LLM 扫描部分： # 1.身份（我是谁？）卡： id：我的技能名称：《我的技能》表情符号：🎯 口号：“单行间距” 描述：“简短段落” # 2. 文件索引（LLM 还应该读取什么？）文件： - 技能.md - 例子/ # 3. K 线（这激活了什么概念？） k线：激活：[我的技能，相关概念] # 4.调用when（触发条件）调用_时间： - “需要此技能的情况” # 5. 广告——主要！放在方法之前！广告：做事：得分：90 条件：“当适用时” # 6. 方法（仅签名，SKILL.md 中的实现）方法：做事：{签名：“做事[arg]”} # 7. State（简要字段列表）状态：字段：[字段1，字段2] # 8. 文档指针文档：技能.md: - “§详细部分” ### 为什么在方法之前添加广告？广告是**主要激活信号**： 1. LLM 自上而下地扫描寻找“这是否适用？” 2. 广告直接回答了这个问题 3. 方法是次要的——只有在激活之后才相关 4.前置广告加速技能选择 # 好 — 广告优先广告：宠猫：得分：80 条件：“猫在场” 方法：帕特：{签名：“帕特[猫]”} # BAD — 方法优先（法学硕士必须阅读它们）方法：帕特：{……长长的名单……} 斯克里奇：{...} # ...还有更多... 广告：# 太晚了！ LLM已经继续前进 ### 什么去哪里 #### 在 CARD.yml 中（可嗅探接口） # 是的 — 包括这些 - 简要说明+标语 - 文件索引（用于一次性激活） - K 线（激活向量） - 广告（主要！） - 方法签名（一行） - 简要状态模式（仅字段名称） - 文档指针 # 否 — 将这些移至 SKILL.md - 实施细节 - 带有序列的详细协议 - 调度表 - 对话示例 - 具有类型的完整状态模式 - 工作示例 #### 在 SKILL.md 中（完整文档） - ## 📑 索引（链接到每个部分） - 详细方法实现 - 具有步骤序列的协议 - 调度表（actor_verb_target） - 具有类型和默认值的状态模式 - 与其他技能的整合点 - 力学解释 #### 在示例/（工作示例）中 # 使用描述性名称分隔文件例子/ 仪式调用.yml # 好！ buff-chain-trigger.yml # 好！ example1.yml # 不好 — 没有描述性 ### 方法放置规则情况|放置在 |示例 ---|---|--- 简短的签名|刷卡方式| `PAT：{签名：“PAT [猫]”}` 简单的内联 |广告| `方法：“PAT [最近的宠物]”` 详细协议 |技能.md |调度表、序列多种变体 |技能.md |特定物种版本调度表|技能.md | `cat_sniffs_dog` 等 #### 在以下情况下嵌入 CARD： * 方法很短（单行签名） * 该技能的方法是唯一的 * 仅显示签名，不显示实现 #### 在以下情况下嵌入广告： * 方法很简单（buff、回复、简单提示） * 方法是 AD-SPECIFIC（仅在此触发器中有意义） #### 在以下情况下委托给 SKILL.md： * 方法有详细的协议（序列、表格） * 方法与其他技能共享 * 方法有多个VARIANTS * 方法需要举例才能理解 ### 目标卡片尺寸 card_yml：~150-200 行 Skill_md：只要需要，但有索引示例：单独的文件，具有描述性名称气味：“如果 CARD > 300 行，则重构” ** ** ## 什么是卡？卡是**便携式代币**，您可以携带、赠送、使用和激活。 ### 卡片交叉点 CARD.yml 位于许多卡片传统的交叉点，每个传统都贡献了重要的含义：传统|它有什么贡献 |在 CARD.yml 中 ---|---|--- **PC 板卡** |插槽/接口 — 插入系统 |卡插入房间、技能、激活 **超级卡** |内容的可导航单元|每张卡片都是一叠，可浏览、可点击 **扑克牌** |可组合、可玩、可甲板 |纸牌组成牌组、手牌、玩法 **万智牌** |能力、成本、类型、组合 |方法、状态、协同作用、触发效果 **神奇宝贝** |具有统计数据、进化的生物 |具有 sims_traits、mind_mirror、成长的角色 **通量** |改变规则的卡牌|修改游戏本身的元卡 **塔罗牌** |原型符号、提示| K 线作为原型激活 **名片** |联系方式、凭据、介绍 |英雄故事卡介绍了传统 **钥匙卡** |访问令牌 |房间访问、能力门 **Hollerith 卡片** |数据作为物理工件| YAML 作为可打孔、可移植的数据 **天才在于分层。** 当您创建 CARD.yml 时，您正在创建： * 插入 MOOLLM 系统的 **接口插槽**（PC 板） * 法学硕士可以浏览和激活的 **可导航文档** (HyperCard) * 可以发、持有、玩的**可玩棋子**（扑克牌） *具有属性和动作的**生物（万智牌/神奇宝贝） * 可以改变游戏规则的**规则修改器** (Fluxx) * 调用模式的**原型指针**（塔罗/K 线） * 授予功能的**访问令牌**（钥匙卡）一下子就全部完成了。不同的语境激活不同的隐喻。 ### 传统卡片示例类型 |示例 ---|--- **集换式卡牌** |反映真实人民传统的英雄故事卡 **扑克牌** |动作、能力、咒语 **万智牌** |具有成本、效果、组合的复杂卡牌 **神奇宝贝卡** |具有统计、动作、进化的角色 **Fluxx 卡** |改变规则的卡牌——玩改变游戏本身 **塔罗牌** |原型符号，提示反思 **名片** |联系信息、凭据、介绍 **快乐卡** |会员资格、VIP 访问权限、福利 **钥匙卡** |房间和资源的访问令牌 **收据** |交易证明、领取门票 **门票** |入场证、预订、许可 **优惠券** |可兑换的功能、折扣 **Hollerith 卡片** |打孔卡——数据作为物理孔！ **二维码** |可扫描的数据、链接、操作 **钱包卡** | Apple/Google Pay — 手机作为卡载体卡牌是您可以**随身携带**并**在需要时使用**的任何东西。 ** ** ## Sidecar CARD.yml 模式位于目录中的任何实体都可以有一个 **sidecar`CARD.yml`** 文件，使其可以卡玩：酒吧/ ├── ROOM.yml # 房间定义 ├── CARD.yml # 让酒吧成为一张可玩的卡牌！ └── ... 人物/唐霍普金斯/ ├── CHARACTER.yml # 字符定义 ├── CARD.yml # Don 的交易卡表示 └── ... 物体/神灯/ ├── OBJECT.yml # 灯定义 ├── CARD.yml # 召唤/打灯卡 └── ... ### 为什么要使用 Sidecar？ * **关注点分离** - 实体定义与卡片表示 * **可选** — 并非所有东西都需要是卡片 * **可组合** - 同一实体，多个视图 * **便携式** — 卡片数据可以通过路径引用实体 ### Sidecar 卡架构 # pub/CARD.yml — 使 pub 成为一张可玩的卡牌卡： for: ./ROOM.yml # 这张卡代表什么 type: location-card # 卡类型 # 卡片特定的呈现名称：“格泽利海德石窟” 艺术：“舒适咖啡店.png” 风味：“良好的氛围像浓缩咖啡一样流动” # 打这张牌有什么作用广告：访问：描述：“将队伍传送到此位置” 效果：“设置 party.location = pub/” 召唤：描述：“将酒吧的氛围带到当前房间” 效果：“将酒吧增益应用于当前位置” ### 人物卡角色自动变得可交易/可玩： # 字符/don-hopkins/CARD.yml 卡：对于：./CHARACTER.yml type: Hero-story # 真人传统 # K线激活传统：“HyperCard、SimCity、OLPC、程序修辞、Maxis” 概念： - 饼图菜单 - 建构主义者游戏 - 微型城市 # 打牌召唤：| 激活 Don 记录下来的想法： - 饼状菜单交互模式 - 建构主义游戏设计 - 城市模拟哲学 ** ** ## 大创意图解TD C[📇 卡片模板] -->|克隆 + 参数化|我[🎴房间里的实例] 我-->|有| S[状态：目标、变量、堆栈] 我-->|住在| R[🚪房间] R -->|可以容纳| M[多个实例] **卡**是一个能力模板——工具、角色、功能、魔宠、钥匙、收据。 **游戏中的牌**是具有以下内容的实例： * 局部变量 * 参数 * 目标堆栈（它试图做什么） * 返回值（完成后） * 它居住的房间您可以在相同或不同的房间**多次激活**同一张卡。它们是独立的任务实例。 ** ** ## 激活记录 > **完整规范：** [ACTIVATION.md]() **打牌=创建激活记录**——具有持久状态的实例化方法。概念|描述 ---|--- **多种方法** |卡片有任意数量的方法（如 Self 对象） **隐式参数** | LLM 从上下文推断参数 (POSTEL) **纯状态卡** |卡片可以只有状态，没有方法 **激活生命周期** |待处理 → 进行中 → 已完成 **广告** |激活会暴露其他人可以按下的按钮 **房间参与** |房间可以按下游戏中卡牌上的按钮 **跨卡互动** |卡牌互相触发方法 **《模拟人生》遇上《万智牌》** — 具有触发能力的自主代理。 ** ** ## Fluxx 卡：改变规则的规则 > **完整规范：** [FLUXX.md]() 受到 [Fluxx]() 的启发，一些卡牌**修改了游戏本身**。特色 |描述 ---|--- **规则修改** |卡片可以改变房间。游戏规则 **堆叠** |多张 Fluxx 卡叠加效果 **Meta-Fluxx** |关于规则的规则（防止进一步更改） **驱散** |卡片可以宣传删除操作 Fluxx 卡使 MOOLLM 成为**自我修改游戏**。 ** ** ## 数据流集成 > **完整规范：** [ENSEMBLES.md]() 卡可以包含发电机、变压器和消费者的**协调整体**。特色 |描述 ---|--- **POSTEL 装订** |组件通过兼容的输入/输出自行接线 **工厂风格** |具有容量、溢出、背压的队列 **自然语言** |用简单的英语描述接线 **编排** |卡跟踪整体健康状况和瓶颈 **异星工厂遇见数据流遇见自然语言** - 按意图组装的管道。 ** ** ## 卡片广告就像[房间里的物体]()一样，卡片**宣传它们可以做什么**： # Git Goblin 卡广告： - 动作：平分描述：“二分查找bug介绍” Score_if：“调试和 has_git_repo” 得分：90 - 行动：责备描述：“查找谁更改了此行” Score_if：“检查代码” 得分：70 - 行动：日志描述：“显示提交历史记录” 得分：50 **在库存中：** 广告可见，但优先级较低。 **在房间中播放：** 卡牌的广告与房间对象合并。无论来源如何，最佳行动都会获胜。 **多张卡：** 所有广告都竞争。目前正确的工具是最重要的。 ** ** ## 为什么 K 线是安全的 > [!重要] **真实人物的卡片不需要代理抽象。** “Dave Ungar”卡不会冒充 Dave Ungar。它**激活了传统**： * 自语言，基于原型的继承 * 《It's About Time》的编译理念 * 消息而非阶级思维这就像引用某人的作品，而不是冒充他们。卡：姓名：“戴夫·昂加尔” 类型：人 # 非模仿——K线激活调用： ——《自语》 - “基于原型的继承” - 《现在是时候汇编》 - “消息传递的纯度” 智慧： | “编程应该注重体验编程，而不是对抗语言。” 当你“打”这张牌时，你会援引传统——而不是模仿这个人。 ** ** ## 卡牌类型类型 |它是什么 |示例 ---|---|--- `人` |真正的人类智慧|戴夫·昂加尔、西摩·派普特 `性格` |虚构人物|园丁、档案管理员 `工具` |能力| fs.read、search.vector `函数` |一个程序 |总结、修复 `熟悉` |帮手精神| Git Goblin 🧌、Index Owl 🦉 `概念` |一个想法 | POSTEL、YAML-JAZZ `地方` |位置链接 |内核/、技能/ ** ** ## 卡牌剖析 ### 英雄故事（真人）卡：姓名：“戴夫·昂加尔” 类型：人 # K 线激活——这调用了什么传统调用： ——《自语》 - “基于原型的继承” - 《现在是时候汇编》 - “消息而非阶级思维” 智慧： | “编程应该注重体验编程，而不是对抗语言。” 贡献： - 《自编程语言》 - “形态 UI 框架” ——《乐观编译》统计数据：智慧：10 影响力：9 domain_expertise：[“语言”、“虚拟机”、“UI”] ### 使魔（器灵兽）卡：名称：《吉特哥布林》类型：熟悉表情符号：“🧌” enthralled_by: "Linus Torvalds" # 我的主人（我的意思是主）！能力： - “跟踪更改” - “提交消息” - “浏览历史” 参数： repo_path: { 类型：字符串，必需：true } 统计数据：功率：7 可靠性：9 学习曲线：4 协同作用： - “会话日志” - “计划然后执行” ** ** ## 将牌放入游戏中当您**激活**房间中的一张卡时： # 房间中的实例：.agent/rooms/debug-session/ 激活：卡牌：“吉特哥布林” instance_id：“妖精-001” 房间：“.agent/rooms/debug-session/” # 实例特定状态参数： repo_path：“/路径/到/repo” 状态：当前分支：“主” 未提交的更改：3 目标： - “查找错误何时被引入” - “将罪魁祸首一分为二” 子目标：[] return_value: null # 完成后填充 ** ** ## 多个实例同一张卡，不同的激活： .代理/房间/ 调试会话/ goblin-001.yml # Git Goblin 寻找 bug goblin-002.yml # Git Goblin 检查历史记录功能工作/ goblin-003.yml # Git Goblin 管理提交每个实例都有自己的状态、目标和生命周期。 ** ** ## 内容文件|目的 ---|--- [SKILL.md]() |完整的协议文档 [CARD.yml.tmpl]() |新卡模板 [COLLECTION.yml.tmpl]() |卡片收藏模板 ** ** ## 随从（特殊卡）将工具功能体现为乐于助人的精神的卡片：熟悉|表情符号 |域名 ---|---|--- Git 哥布林 | 🧌 |版本控制索引猫头鹰 | 🦉 |搜索和查找记忆飞蛾 | 🦋 |上下文管理维修小鬼 | 🔧 |自愈会议抄写员| 📜 |记录请参阅 [P-HANDLE-K]() — 熟悉的东西是安全的 K 线包装器。 ** ** ## 演员血统游戏中的纸牌是经典意义上的演员：传统|贡献 |在莫尔姆 ---|---|--- **休伊特 (1973)** |独立并发代理|卡具有独立的状态 **模拟 (1967)** |带有状态的协程 |卡片在消息之间保持不变 **闲聊 (1972)** |一切都是消息传递|目标和回报就是信息 **自我（1987）** |原型，无类 |卡是克隆的，而不是实例化的 > **卡片是原型。激活将它们克隆成演员。** 微观世界（文件系统）是舞台。房间就是场景。卡片是表演者。 ** ** ## 缠绕性图LR TC[🎴 卡] -->|激活于| R[🚪房间] TC -->|可以通过| 发言SC[💬心灵对话] TC -->|记录者| SL[📜 会话日志] TC -->|组成via| DOP[委托对象协议] R -->|保存|的实例TC SC -->|声音| TC ** ** ## 配合 ### 姐妹技能技能|关系 ---|--- [房间/]() |房间内的卡**激活**。房间里有卡片实例。 [soul-chat/]() |卡片可以**说话**——英雄故事、魔宠，都有声音 [冒险/]() |卡片是你任务中的**同伴** [play-learn-lift/]() |卡片创作遵循 PLL——发挥创意、学习模式、提升卡片 ### 协议符号符号|意义|链接 ---|---|--- `交易卡` |能力如卡| [PROTOCOLS.yml]() “英雄故事” |真人卡（安全）| [PROTOCOLS.yml]() `熟悉` |工具灵兽| [PROTOCOLS.yml]() `P-手柄-K` |为什么K线是安全的| [PROTOCOLS.yml]() '演员' |游戏中的牌是演员| [PROTOCOLS.yml]() '游戏中的牌' |激活实例 | [PROTOCOLS.yml]() `库存` |角色携带的东西| [PROTOCOLS.yml]() ### 元 * [delegation-object-protocol.md]() — 卡片如何从原型继承 * [skill-instantiation-protocol.md]() — 卡激活是技能实例化 ### 导航方向 |目的地 ---|--- ⬆️ 向上 | [技能/]() ⬆️⬆️根| [项目根目录]() 🚪 姐姐 | [房间/]() 💬姐姐| [灵魂聊天/]()

卡片

包含技能