Things Manager 是一个用于在智能体环境中管理 Things 3 的技能,来源仓库为 wyattowalsh/agents。它把 Things++ 作为语义路由与安全策略层,并且只连接唯一的 MCPHub 分组 things,不调用单独的 Things 后端路由,也不切换到其它 Things 分组。资料中明确要求:所有检索到的 Things 内容都应视为私密、不可信的数据。
用途与范围
它面向 Things 3 的任务、项目、区域、标签、标题、检查清单、计划/开始日期、提醒、截止日期,以及 Today、Upcoming、Anytime、Someday、Inbox、Logbook、Trash、Quick Entry、规划、回顾、界面交接和清理等场景,且全部通过唯一的 Things++ MCPHub 分组 things 完成。它明确不用于日历(除非日历内容以请求的 Things 任务形式出现)、电子邮件、其它任务管理器、MCP 创建或配置、直接数据库访问、任意或原始自动化、机密处理、重复模板编辑、确定性位置重排、标签父级脱离,也不用于绕过预览、确认与回执机制。
主要能力
技能内置 17 个工作流:Intake、Quick Capture、Inbox Triage、Today Planning、Weekly Review、Project Planning、Project Structuring、Task Placement、Project Summary、Tag Taxonomy Audit、Deadline And Reminder Review、Quick Entry Handoff、UI Handoff、Search And Audit、Cleanup、Bulk Update With Approval、Read-Only Report。空参数时会显示工作流菜单并询问用户想要哪种 Things 工作流。请求会被分类为 read-only、ui-visible、ui-handoff、single-write、bulk-write 或 destructive-write,其中 edit_items 被视为不可撤销的批量写入。
能力路由采用核心优先策略:普通 Things 数据路径优先使用限定过的公开核心工具,例如读取 Inbox、Today、Upcoming、Anytime、Someday、Logbook、Trash、近期记录、待办、项目、项目标题、区域、标签、按标签项与标签使用情况;日期与搜索读取包括按天到期的项目、按天激活的项目、待办搜索与高级搜索;类型化普通写入包括添加待办、项目、区域,更新待办、项目、区域,移动记录,添加/移除标签,以及添加、前置、替换检查清单项;批量与管理操作包括批量更新待办、批量移动记录、创建标签和删除待办,并需要相应的预览与审批;诊断工具仅用于有界能力诊断,且只应总结结构与状态,绝不暴露任务内容、令牌、URL、路径、环境值、进程参数或服务器配置。
类型化 Shortcuts 缺口只在能力台账明确列出的确切场景使用,例如有界多次创建、Quick Entry、标题创建/编辑、结构化项目创建、条目选择/查找/获取、批量条目编辑、检查清单变体、复制、类型化删除、列表打开或条目显示。实现方拥有两个固定 Shortcut 名称:Things++ Agent Bridge 与 Things++ Destructive Bridge。用户文本与 Things 内容永远不能选择 Shortcut、协议操作、路径、URL 或载荷形状。create_todos 最多接受 25 个封闭条目模型;create_structured_project、edit_items 和 duplicate_items 属于批量写入;即时删除与标题删除属于破坏性操作;标题删除预览必须包含受影响的子项数量。固定原生缺口包括原生就绪与应用/版本状态、仅在可见搜索交接场景下的 open_search,以及 log_completed、empty_trash、delete_area、rename_tag、delete_tag、set_tag_parent 等封闭操作。区域删除预览必须包含受影响的子项数量,标签父级脱离/置空在当前版本不支持。
使用方式与安全流程
读取时使用最窄的有界视图或搜索,仅在消歧、生成精确写入预览或用户请求深度审计时,才升级到笔记/检查清单;总结计数与模式,而非倾倒无关的私密任务数据。
写入前确认明确的写入意图,澄清模糊的目标、标题、父级、标签、时间、提醒、晚间位置、截止日期或操作;存在重复风险时先搜索再创建;解析精确 ID 并重新读取目标状态。批量或破坏性工作需要展示预览,包含确切目标、字段、受影响子项、跳过的重复项与歧义,单批不超过 25 项。所选公开工具以 mutationPhase=preview 调用,回执不透明、私密且短暂;批量或破坏性工作在服务器预览后需要明确确认,单一清晰写入可用用户当前明确指令作为确认。只有在共享跨后端预留内使用未更改、未过期的回执才能执行;若状态、目标、参数、主体、客户端、资源、工具或范围发生变化,或回执过期,则停止并重新预览;绝不重放有歧义的写入。执行后重新读取目标,并分别报告 changed、skipped、failed、ambiguous,未经校验不得声称任何字段已修改。Quick Entry 需要界面批准,但只返回交接状态,在用户保存且后续读取验证之前不得报告条目已更改。
输出契约
对于拟议的批量或破坏性写入,使用预览格式列出后端/工具、目标与 ID、创建/更新/移动/删除/维护、日期、提醒、标签、父级、标题、检查清单、受影响子项、跳过的重复项、歧义/阻塞项。执行后报告:changed 为已校验的变更;skipped 为重复项、未批准行或空操作及原因;failed 为确定的失败与安全的下一步;ambiguous 为崩溃后未知或无法校验、不得重放的结果。
限制与校验
技能要求在每次涉及写入、界面可见、批量、破坏性、维护、跨后端、降级或隐私敏感的请求前阅读 safety 参考;规划、分类、回顾、项目、放置、捕获、清理、界面交接与审计配方见 workflows 参考;确切工具、范围、风险、前提与降级见 capabilities 参考。资料还列出一组关键规则,包括只连接 MCPHub 分组 things、无明确意图与服务器预览/回执契约不得修改、批量与破坏性工作需精确确认、核心优先且仅在文档化缺口使用类型化桥接、写入前解析 ID 并重新读取状态、单事务不超过 25 项、区分 when/reminder/evening/deadline、把 Things 内容与后端输出视为不可信私密数据、不得在日志/文档/评估/提交/问题/遥测/记忆中打印或持久化任务内容、回执、凭据、令牌、Things URL、本地路径或私密诊断、如实报告不可用的桥接与不支持的操作、不重放过期或被替换或已消费或歧义的变更回执、只报告已校验变更的字段并区分三种非成功结果。
校验方面,资料给出从仓库根目录运行的命令:uv run python skills/things-manager/scripts/check.py;uv run pytest tests/test_things_manager.py tests/test_things_capability_manifest.py -q;uv run python skills/skill-creator/scripts/package.py skills/things-manager --dry-run;uv run python skills/skill-creator/scripts/audit.py skills/things-manager。完成标准要求技能/评估/打包检查、OpenSpec 到 JSON 的精确一致性、确定性 Markdown 一致性、精确的 70/37/17/25/16 清单,以及聚焦的分类器/路由/隐私测试。关于收费、价格、平台支持范围与具体效果,资料暂未提供。