# 开花-blockery-cli 在操作 Blooming Blockery CLI (`blooming-blockery`) 以及将内容塑造成树结构以获得更好的 LLM 上下文质量时，请使用此技能。主要目标：将 Blooming Blockery 视为基于树结构的设计文档编辑器。将信息组织成逻辑上正确的树，以便每个块都承载一个连贯的想法，而不相关的材料被分成单独的分支。这个技巧不仅仅是命令语法参考。它是一个结构和上下文指南，用于决定信息应位于树中的位置。 ## 动机：从模糊的想法到实施使用树从不确定性转向精确性： 1. 从广泛的项目想法或高级概念开始。 2. 将想法分解为更小的设计决策和范围边界。 3. 将决策细化为明确的规范，例如“要求”、“确保”和不变量。 4. 继续将规范块细化为可实施的单元。 5. 将实现步骤连接回它们满足的确切规范分支。使用此技能的代理应尽可能保留这种自上而下的细化流程。 ## 何时使用 * 用户询问如何从终端脚本使用 Blooming Blockery CLI (`blooming-blockery`)。 * 用户需要将混合或超载的音符重组为更清晰的树。 * 用户需要围绕特定块的 LLM 就绪上下文。 * 用户遇到块 ID、安装格式或面板状态的 CLI 解析错误。 * 用户需要可复制的命令模式来重复创作工作流程。 ## 心理模型：每个块的上下文包络从 `src/llm/context.rs` 中，一个块的 LLM 上下文是一个由以下部分组成的 `BlockContext`： * `lineage`：从根到目标的有序链，其中最后一项是目标块本身。 * `existing_children`：仅限直接子点文本。 * `friend_blocks`：与可选的`perspective`、可选的朋友血统望远镜和可选的朋友儿童望远镜的交叉引用。对使用此技能的代理的影响： * 保持每个区块的重点。如果一个块混合了不相关的关注点，请将其拆分。 * 更喜欢让孩子分解一个主题。 * 对于不相关的话题，更喜欢兄弟姐妹或新的根源。 * 更喜欢朋友之间相关但不分层的交叉链接。 * 当好友关系不明确时添加`--perspective`。 * 仅在需要时才有意使用望远镜标志来扩展朋友上下文。 ## 树编辑的上下文卫生规则 1. 一个区块，一个意图。 2. 如果两个陈述不能共享相同的直接设计问题，则将它们分开。 3. 保持严格的父子逻辑：每个子节点都应该完善、证明或执行父节点。 4. 将实现细节保留在相关设计/规范父级下。 5. 不要将不相关的决定深埋在另一个主题的血统中。 6. 保留细化顺序：概念 -> 规范（`requires`/`ensures`/invariants） -> 实现。 7. 使用 `blooming-blockery context ` 在 LLM 草案命令之前检查上下文。 8. 检查放置是否正确时使用“blooming-blockery nav lineage ”。 9. 使用 `blooming-blockeryfriend add` 而不是跨主题链接的强制树嵌套。 ## 当树结构困难时，使用友元块有些内容本质上是交叉的，不能完全适合一个单一的父分支。在这些情况下： * 保持主树逻辑干净。 * 使用 `blooming-blockeryfriend add ` 进行远程引用。 * 添加 `--perspective` 来解释为什么远程块对目标很重要。 * 仅当确实需要额外的朋友血统/孩子时才启用望远镜标志。好友块是有用上下文的逃生口，不应扭曲核心树语义。 ## CLI 调用约定 Blooming Blockery 是一个单一的二进制文件：无需使用子命令来启动 GUI，也可以使用用于 CLI 自动化的子命令来运行。以下所有示例均使用完整形式：开花块状... 在指令和自动化脚本中使用 `blooming-blockery ...`。 ## 全局标志所有命令都支持这些全局标志： * `--store `：块存储文件的路径（默认为应用程序数据路径） * `--verbose`: 启用详细输出（当前保留） * `--output `: 输出格式 - `table` (默认) 或 `json` ## 区块ID格式块 ID 使用干净的格式，如“1v1”、“2v3”，其中： * 第一个数字 = 商店中的槽索引 * `v` = 分隔符 * 第二个数字 = 生成计数器（重用时增量）支持批处理的命令还接受单个 ID 参数中以逗号分隔的 ID：绽放-blockery秀1v1,2v1,3v1 blooming-blockery tree add-child 1v1,2v1“共享子文本” 批处理执行是错误时继续的：尝试所有目标并在处理完成后报告错误。 ## 上下文优先工作流程模式 ### 1) 将不相关的信息拆分到单独的分支中 # 当主题在同一层次结构级别发生变化时添加同级 blooming-blockery 树 add-sibling “新主题” # 引入新的组织父级时包装当前块开花块树包装“父概念” # 将放错位置的内容移到正确的父项下开花块树移动 --under ### 2) 在询问 LLM 功能之前检查上下文开花块导航血统开花块上下文 --输出 json blooming-blockery 好友列表 --输出 json ### 3) 保持交叉引用明确 blooming-blockery 好友添加 \ --perspective“参考架构约束”\ --望远镜谱系仅当特定 LLM 任务需要添加的好友范围时，才使用“--telescope-lineage”和“--telescope-children”。 ## 命令参考 ### 查询命令 # 列出所有根块ID 开花块状根开花块根--输出 json # 显示区块详细信息盛开的街区表演开花块显示 1v1 --输出 json # 按文本搜索块（不区分大小写的子字符串）开花块找到“搜索查询” 开花块找到“TODO”--限制10 # 编辑块的文本内容 blooming-blockery点“新文本内容” 开花块点1v1“更新文本” ### 树结构命令 # 在父块下添加子块（父块不能是挂载点）开花块树添加子“文本内容” blooming-blockery 树 add-child 1v1“我的新想法” # 在块后添加同级 blooming-blockery 树 add-sibling “文本内容” 开花块树添加兄弟姐妹1v1“下一个兄弟姐妹” # 用新的父块包裹一个块开花块树包装“父文本” blooming-blockery 树包装 1v1“新父部分” # 复制子树开花块树重复开花块树复制 1v1 # 删除子树（删除块和所有后代）开花块树删除开花块树删除1v1 # 相对于目标移动方块开花块树移动 --before 开花块树移动 --after 开花块树移动 --under ### 导航命令 # 按 DFS 顺序获取下一个可见块盛开-blockery 导航下一个盛开-blockery 导航接下来 1v1 # 获取前一个可见块开花块导航上一个盛开-blockery 导航上一页 2v1 # 获取谱系（祖先链）开花块导航血统盛开-blockery 导航血统 1v1 # 搜索感知导航开花块导航查找下一个“查询” 开花块导航查找上一个“查询”--no-wrap ### 草案命令（法学硕士建议） # 设置放大草案（重写+提议的子项） blooming-blockery 草稿放大 --rewrite "精炼文本" --children "子 1" "子 2" Blooming-Blockery Draft amplify 1v1 --children “只是孩子” # 设置蒸馏草稿（精简版） blooming-blockery 草稿蒸馏 --reduction "压缩文本" --redundant-children 2v1 3v1 # 设置指令草稿（用户编写的LLM指令） blooming-blockery 草稿指令 --text "让这个更简洁" # 设置探测草稿（LLM 响应询问） blooming-blockery 草案探针 --response“关键的见解是......” # 列出一个区块的所有草稿开花块草稿列表 # 清除草稿（使用 --all 或特定标志）开花块草稿清除 --all 开花块草稿清除 --amplify 开花块草稿清除 --distill --instruction ### 折叠（折叠）命令 # 切换折叠状态开花块折叠切换 # 获取折叠状态开花块折叠状态 ### Friend（交叉引用）命令 # 添加具有可选视角的好友块 blooming-blockery 好友添加 --perspective "相关设计" blooming-blockery 好友添加 --telescope-lineage --telescope-children # 删除好友 blooming-blockery 好友删除 # 列出好友 blooming-blockery 好友列表 ### 挂载（外部文件）命令 # 设置挂载路径（块必须是叶子，没有子块） blooming-blockery 安装集 [--format json|markdown] 开花块安装集 1v1 /data/external.json blooming-blockery 安装集 1v1 /notes/notes.md --format markdown # 扩展挂载（加载外部文件）开花块安装扩展 # 折叠挂载（删除已加载的块，恢复挂载节点）开花块安装崩溃 # 移动挂载支持文件并更新元数据开花块安装移动 # 将安装的内容内联到当前存储中内联blooming-blockery挂载 # 在子树下递归内联所有挂载开花块安装内联递归 # 将子树提取到外部文件 blooming-blockery mount extract --output [--format json|markdown] blooming-blockery 安装提取 1v1 --output /backup/notes.json # 将所有扩展挂载保留到其源文件盛开-blockery挂载保存 # 显示挂载信息开花块挂载信息 ### 面板命令 # 设置块面板状态 blooming-blockery 面板集朋友 blooming-blockery面板设置指令 # 获取块面板状态 blooming-blockery 面板获取 # 清除块面板状态开花块面板清除 ### 上下文命令 # 获取一个块的LLM上下文（血统、孩子、朋友）开花块上下文开花块上下文 1v1 ## 常见错误模式 * `UnknownBlock`: 在商店中找不到区块 ID * `无效操作`: * 父级是坐骑（不能添加子级） * 源是目标的祖先（移动中的循环） * 块有孩子（无法设置安装） * 尝试将自己添加为好友 * `IoError`: 读取/写入挂载文件失败 ## 代理指导：有意选择结构在帮助用户编写规范/文档时，优先考虑以下决定： * 如果内容回答不同的设计问题，则分成兄弟分支。 * 如果内容详细阐述了一项父项声明，请将其放置为子项。 * 保持逻辑链可见：概念 -> 规范 -> 实现。 * 鼓励在需要大量实现的分支之前使用“requires”、“ensures”和不变量来明确规范节点。 * 如果两个分支应保持独立但相互相关，请通过朋友链接。 * 如果朋友的意思不清楚，请立即添加`--perspect`。 * 在生成草稿之前，使用“blooming-blockery context”进行检查并确保沿袭指向预期范围。 ## 实用技巧 1.使用`--output json`进行脚本编写和解析结果 2. 区块ID不区分大小写 3.挂载格式默认为`json`，但支持`markdown` * `mount extract --format` 覆盖路径扩展名推断 4. 批处理命令支持逗号分隔的 ID： * `显示`, `点` * `树添加子|添加兄弟|换行|重复|删除|移动` * `导航下一个|上一个|谱系` * `好友添加|删除` * `折叠切换|状态` * `草稿指令|探测|列表|清除` * `安装集|展开|折叠|移动|提取|内联|内联递归|信息` * `上下文` * 对于`mount set|move|extract`批处理模式，传递一个类似目录的路径（`existing/dir`或不带扩展名的路径），每个目标将使用该目录下的`.`。 5. 面板状态为“朋友”或“指令” 6. 运行“blooming-blockery”，无需 GUI 子命令；带有 CLI 子命令 7. 如果用户报告 LLM 响应质量低，请先修复树位置和朋友/望远镜范围，然后再重写提示

Blooming Blockery CLI

包含技能