mcpField
B
box

box

github.com/prathamdby开发6630 次安装5 天前更新
代码仓库

关于 box

用于克隆或搜索本地仓库并报告发现的 Skill，仅在请求时写入持久内容。它划分准备、搜索和写入职责，并将沙盒置于工作仓库之外。

主要功能

  1. 01按需克隆仓库
  2. 02列出现有克隆
  3. 03搜索本地文件并提供证据
  4. 04按范围拆分委派任务
  5. 05按请求写入 AGENTS.md

适用场景

  1. 01在克隆的仓库中查找信息
  2. 02列出克隆并识别过时副本
  3. 03将获准的发现写入工作仓库的 AGENTS.md

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/prathamdby/skills --skill box

安装后在 Claude Code 中输入/box确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

REFERENCE.md
references/
agents-md-template.md
persist.md
prepare.md

详细介绍

Box

选项与所有权

默认按需克隆／搜索／报告；仅在用户要求时才持久化。 “Update”／“pull first”会先快进；“list”会报告克隆并停止。 “Persist”／“add to AGENTS.md”会在搜索后启用写入。 “No subagents”／“in this thread”，或无法委派时，选择 Direct； 否则选择 Delegated。明确保留此模式切换，不要根据规模推断。 list/search 冲突或缺少必要 URL 时停止。

解析此技能的绝对锚点、sandbox/manifest.json、sandbox/， 以及工作仓库中的 AGENTS.md。沙盒必须位于工作仓库之外。 Direct 执行阶段约定。Delegated 使用一名 Prepare 写入者、多个互不重叠的 只读 Search 工作器，以及一名 Persist 写入者；父级只负责派发／汇总。 工作器失败时停止；工作器不能继续委派。 记录 mode | slug/URL/path | prepare | search scopes/evidence | persist | current | terminal。

1. 检测与准备

仅列出／list：缺少 manifest 时视为空；报告 slug、URL、路径和过期克隆， 然后停止。URL slug 是去掉 .git 后的最后一段；名称区分大小写。 匹配结果为零个或多个时，需要提供 URL。发送列表或确定身份后即为完成。

对于搜索，使用绝对路径输入运行／派发 references/prepare.md。等待 验证完成后再搜索。部分克隆不得写入 manifest； 不得删除未知目录。克隆 origin 与 manifest 一致后即为完成。

2. 搜索

按互不重叠的子树／问题分配任务，并提供绝对克隆路径。只搜索本地文件， 且只读；未指定问题时，搜索 README／清单／目录结构／条目。 要求提供路径:行号证据或限定范围内无匹配的结果、上下文，以及 遗漏项。任务说明须包含锚点、身份、阶段、写入边界、输入、 输出，且不得嵌套委派。每个范围都返回证据后即为完成。

3. 汇总与持久化

按主题作答，引用去重，并指出未搜索的区域。 仅当用户要求持久化且搜索已完成时，运行／派发 references/persist.md；它唯一的目标是工作仓库中的 AGENTS.md。 答案附有引用且任何经授权的标记块恰好存在一次后，即为完成。

恢复时，验证 manifest／克隆／结果／标记；从最早未完成的条件重新开始， 重新派发缺失的搜索。报告身份／路径、准备情况、 搜索范围／无匹配结果、持久化情况。SUCCESS/BLOCKED/NO_MATCHES（所有范围均为空）。 不得提交／推送克隆，不得根据 URL 猜测，也不得让写入所有权重叠。

评论

支持 Markdown