服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- ModSmith 是 Dan McAteer 的第三方项目；2026 年 10 月 3 日的仓库提交增加整包安装入口，不代表六款 Mod 都已完成真实环境验证。
- quiz 和 supervisor 会在符合条件的回合额外调用模型；supervisor 的触发条件还包括至少 8 次工具调用，因此较长的只读研究也可能触发。
- 把自动检查关闭、把插件停用、把整包卸载是不同操作；先确定希望停止哪一部分，再检查依赖与加载状态。
先分清 skill、整包和运行环境
ModSmith 来自 DannyMac180/skills 仓库，由 Dan McAteer 维护，并非 Anthropic 自家插件。作者在 2026 年 10 月 3 日提交 modsmith-all 整包入口；这次变化让现成组件更容易安装，不能据此认定所有组件已成熟。
当前 marketplace 将 modsmith 和 modsmith-all 标为 0.2.0。前者提供协助设计、检查 Mod 的 skill；后者依赖该 skill，以及 quiz-after、next-steps-supervisor、assumption-ledger、mode-registry、effort-modes、artifact-dashboard 六款 Mod。不要把整包版本套用到每个组件。
先在终端运行 claude --version，确认不低于 2.1.287。建议首次在交互终端验收；官方也支持 Desktop Code 的相应界面，但 Desktop 的 WSL 会话不加载插件，VS Code 聊天面板不绘制 Mod 界面。组织还可能限制哪些 Mod 可以加载。
选择整包装好，或只安装一个需要的组件
在 Claude Code 会话里先输入 /plugin marketplace add DannyMac180/skills。想安装整包，再输入 /plugin install modsmith-all@modsmith；这些以斜杠开头的命令应放在 Claude Code 输入框中。
安装命令会进入插件详情，先核对名称，再选择安装范围。第一次试用建议选择仅自己在当前仓库使用的 local 范围。阅读安装摘要，按提示激活；若要求重载就照提示处理，也可以开启新会话后继续检查。
只想试答题功能，可改用 /plugin install quiz-after@modsmith；想检查任务完成情况，可单装 /plugin install next-steps-supervisor@modsmith。只有需要 ModSmith skill 时，再安装 /plugin install modsmith@modsmith。以上是按需选择，不需要把整包与单装流程全部执行一遍。
其他组件同样可以单独选择；其中 effort-modes 会带上 mode-registry。建议先写下一项具体需要，例如复盘刚完成的代码修改；有明确用途后再增装，发生问题时也更容易找到对应组件。
安装验收先看加载，再做一个小任务
进入 /plugin 查看活动 Mod 名单，确认需要的组件确实加载。安装记录与活动名单要分别看：找不到组件时，先核对安装范围、会话是否重载及组织提示；仅凭没有出现提示条，还不能判断安装失败。
建议在可丢弃的练习项目中，明确要求修改一个示例文件并说明完成结果。先只开启一种检查，等回合正常结束后观察；不要用重要工程的大规模改动作为第一次验收。本文的步骤依据文档整理，未在本机运行这些 Mod。
保留客户端版本、组件名称、触发前做过什么及屏幕显示的结果。若需要反馈作者，这些信息比一句“装好没反应”更有用；记录中应删去项目敏感内容。
额外用量看触发条件，不能只看有没有改文件
quiz-after 在主会话正常结束、存在非只读且非记账类工具调用时发起一次 fork，即基于当前会话的额外模型请求。它还会判断任务是否完成：如果答案是未完成，就不显示题目，但请求已经发生。纯聊天、只读或中断回合不会按这套自动规则触发；主会话启动子代理也可能计入非只读调用。
supervisor 的条件更宽：主回合存在非只读工具调用，或累计至少 8 次工具调用，就可能进行一次检查；只统计主循环，因此不能把子代理内部每次调用都加进来。长时间只读检索也可能达到门槛。两者同时开启且各自符合条件时，各做各的请求。
使用缓存仍有用量。建议查看提示条中的 cached、new、out 数字，分别观察缓存输入、新输入和输出，而不是把 cached 理解成免费。作者给出的预计开销不能当成你的实际账单，也不适合据此承诺固定节省比例。
题目或按钮没反应时，先检查这几处
quiz 没出现时，先核对上一节的条件和任务是否已完成。首次观察建议等检查结束再发新提示，避免把旧结果被丢弃误认为程序没运行。不要连续用手动检查来试探；这会增加请求，也让问题更难复现。
作者 10 月 3 日的修正调整了 quiz 的 Save、Dismiss 位置，并补充提示条需要先获得焦点。可以先点击提示条，再尝试按钮；终端也可按文档的 Ctrl+X、Tab 顺序切换焦点。若保存失败，核对 explain-this 的 memory 目录是否已经存在，插件不会替你创建整个卡片库。
supervisor 的下一步按钮会把该步骤作为你的新提示提交。点击前先读完整动作：例如建议运行测试，应确认命令与当前工程相符。它给出的是模型复核意见，仍需查看实际测试输出、改动和失败原因，才能判断工作是否完成。
先关闭自动检查，再按依赖关系停用
只想停止自动检查，可在会话里分别输入 /quiz off 和 /supervisor off，设置会跨会话保存。此时插件仍然加载；带 now 的手动检查命令即使在关闭状态也可以发起请求，因此不要用它来验证是否已经省掉自动调用。
若要停用某一款 Mod，进入 /plugin 处理插件本身。通过整包安装的用户，应先卸载 modsmith-all@modsmith，再停用或卸载不需要的单体。整包仍启用时，它的依赖关系可能阻止单独停用。卸载整包后，已自动安装的组件会留下，不会同时消失。
例如只想保留 quiz：先移除整包，再逐一确认其他组件是否仍被需要，处理完后重新查看活动名单。遇到另一个插件仍依赖目标组件的提示，应按提示先处理依赖方；不要直接删除整个插件目录或其他项目的设置。
哪些已确认，哪些还应当作试用
quiz 的 DECISIONS 记录：作者在 2026 年 10 月 3 日的 Desktop Code 2.1.287 会话中看到了后台请求完成和题目提示条；同一记录仍将按钮、快捷键、保存卡片和真实单次用量列为尚未现场确认。界面出现与按钮可靠是两项不同的验收。
supervisor 也记录了首次请求和提示条展示，同时保留按钮、快捷键、fork 是否本来就能看到最终回复，以及实际用量等待确认事项。这些是作者公开的验证边界，不能用来宣称其余四款也已获得相同程度的验证。
建议试用结束后只回答三个问题：需要的结果是否出现，额外调用是否符合预期，停用后是否确实停止。若其中一项还无法确认，就先保留最小安装范围和复现记录，等待修复或补充证据后再扩大使用。
资料来源
常见问题
第一次用 ModSmith，应该全部装上吗？
建议从一个具体需求开始，先单装对应组件。这样更容易确认界面、额外调用和停用行为，之后再决定是否需要整包。
为什么没有改代码，supervisor 仍然运行？
检查这一回合的主循环工具调用次数：其规则还包括至少 8 次调用，较长的只读研究可能达到条件。不要只根据文件有没有变化判断触发是否正常。
卸载整包后还能看到组件，是卸载失败吗？
不一定。整包移除后依赖组件会保留，需要在 /plugin 继续选择哪些停用或卸载。先核对活动名单和依赖提示，再判断是否异常。