What should go in the Big Menu? Inspired by @rystorm.com 's article reminding us that Sensible Defaults Do Not Exist, and that tool UIs should be customisable for different workflows, swap in the controls and shortcuts you need, and swap out the ones you aren't using right now
#tooldesign #indiedev
#tooldesign #indiedev
October 2, 2026 at 8:30 AM
What should go in the Big Menu? Inspired by @rystorm.com 's article reminding us that Sensible Defaults Do Not Exist, and that tool UIs should be customisable for different workflows, swap in the controls and shortcuts you need, and swap out the ones you aren't using right now
#tooldesign #indiedev
#tooldesign #indiedev
Pi（终端 Agent）反水了：之前明确「不支持 MCP」，现在 MCP 进了核心。
作者 Mario Zechner 说了句大实话：
多数 MCP server 还是为「把工具丢进上下文、返回文本」的 harness 建的。
真正的病根：把 MCP 用成了「文本搬运工」👇🧵
#MCP #AIAgent #ToolDesign
作者 Mario Zechner 说了句大实话：
多数 MCP server 还是为「把工具丢进上下文、返回文本」的 harness 建的。
真正的病根：把 MCP 用成了「文本搬运工」👇🧵
#MCP #AIAgent #ToolDesign
September 30, 2026 at 5:30 PM
Pi（终端 Agent）反水了：之前明确「不支持 MCP」，现在 MCP 进了核心。
作者 Mario Zechner 说了句大实话：
多数 MCP server 还是为「把工具丢进上下文、返回文本」的 harness 建的。
真正的病根：把 MCP 用成了「文本搬运工」👇🧵
#MCP #AIAgent #ToolDesign
作者 Mario Zechner 说了句大实话：
多数 MCP server 还是为「把工具丢进上下文、返回文本」的 harness 建的。
真正的病根：把 MCP 用成了「文本搬运工」👇🧵
#MCP #AIAgent #ToolDesign
Tool design, not model capability, causes most AI agent failures. Learn design patterns to improve reliability, like single-responsibility tools, tight schemas, and structured error returns. #AIAgent #ToolDesign 🤖🔧
AI Agent Tool Design: What Works and What Doesn’t - MachineLearningMastery.com
In this article, you will learn how tool design — not model capability — is the root cause of most AI agent failures, and what concrete design patterns you can apply to fix it.
machinelearningmastery.com
June 26, 2026 at 6:40 AM
Tool design, not model capability, causes most AI agent failures. Learn design patterns to improve reliability, like single-responsibility tools, tight schemas, and structured error returns. #AIAgent #ToolDesign 🤖🔧
Unboxing the first look at what Fenrir Tools is becoming! 🐺🔧
We've been working behind the scenes to get Fenrir ready for launch, and now we're one step closer.
What do you think of the packaging?
#FenrirTools #LockingPliers #Tools #ToolDesign #Engineering
We've been working behind the scenes to get Fenrir ready for launch, and now we're one step closer.
What do you think of the packaging?
#FenrirTools #LockingPliers #Tools #ToolDesign #Engineering
August 13, 2026 at 6:33 PM
Unboxing the first look at what Fenrir Tools is becoming! 🐺🔧
We've been working behind the scenes to get Fenrir ready for launch, and now we're one step closer.
What do you think of the packaging?
#FenrirTools #LockingPliers #Tools #ToolDesign #Engineering
We've been working behind the scenes to get Fenrir ready for launch, and now we're one step closer.
What do you think of the packaging?
#FenrirTools #LockingPliers #Tools #ToolDesign #Engineering
Here's what we changed and why it works.
Traditional locking pliers use a release lever. We replaced it with a push button that works with the natural squeeze of your hand.
Less fumbling. No pinched fingers. Easier one-handed operation.
#FenrirTools #Engineering #ToolDesign
Traditional locking pliers use a release lever. We replaced it with a push button that works with the natural squeeze of your hand.
Less fumbling. No pinched fingers. Easier one-handed operation.
#FenrirTools #Engineering #ToolDesign
June 18, 2026 at 3:17 PM
Here's what we changed and why it works.
Traditional locking pliers use a release lever. We replaced it with a push button that works with the natural squeeze of your hand.
Less fumbling. No pinched fingers. Easier one-handed operation.
#FenrirTools #Engineering #ToolDesign
Traditional locking pliers use a release lever. We replaced it with a push button that works with the natural squeeze of your hand.
Less fumbling. No pinched fingers. Easier one-handed operation.
#FenrirTools #Engineering #ToolDesign
6/16 The deeper problem: CheXpert was designed to automate radiologists, not collaborate with them.
It couldn't process medical histories, conversations, diagnostic context that radiologists use.
Automation tool masquerading as expertise replacement.
#ToolDesign
It couldn't process medical histories, conversations, diagnostic context that radiologists use.
Automation tool masquerading as expertise replacement.
#ToolDesign
August 25, 2025 at 4:56 AM
6/16 The deeper problem: CheXpert was designed to automate radiologists, not collaborate with them.
It couldn't process medical histories, conversations, diagnostic context that radiologists use.
Automation tool masquerading as expertise replacement.
#ToolDesign
It couldn't process medical histories, conversations, diagnostic context that radiologists use.
Automation tool masquerading as expertise replacement.
#ToolDesign
A well-designed fixture reduces cycle time, ensures repeatability, and prevents worker fatigue. Unlike standard design, this requires a deep understanding of Design for Manufacturing (DfM).
👉: www.teslamechanicaldesigns.com/mechanical-d...
#ManufacturingEngineering #JigsAndFixtures #ToolDesign
👉: www.teslamechanicaldesigns.com/mechanical-d...
#ManufacturingEngineering #JigsAndFixtures #ToolDesign
February 2, 2026 at 2:47 PM
A well-designed fixture reduces cycle time, ensures repeatability, and prevents worker fatigue. Unlike standard design, this requires a deep understanding of Design for Manufacturing (DfM).
👉: www.teslamechanicaldesigns.com/mechanical-d...
#ManufacturingEngineering #JigsAndFixtures #ToolDesign
👉: www.teslamechanicaldesigns.com/mechanical-d...
#ManufacturingEngineering #JigsAndFixtures #ToolDesign
法则② 越少越可靠，越细越准
❌ 1个万能tool：do_everything(action, params)
✅ 5个精确tool：search_orders / cancel / invoice / refund / support
Agent是模式匹配器，不是程序员。
给它小而精确的工具，它自己就会组合。
法则③ 错误返回要能"自愈"
return {"error":"order_404", "fix":"try search_orders first to get valid id"}
#ToolDesign #AIAgent
❌ 1个万能tool：do_everything(action, params)
✅ 5个精确tool：search_orders / cancel / invoice / refund / support
Agent是模式匹配器，不是程序员。
给它小而精确的工具，它自己就会组合。
法则③ 错误返回要能"自愈"
return {"error":"order_404", "fix":"try search_orders first to get valid id"}
#ToolDesign #AIAgent
July 1, 2026 at 4:17 PM
法则② 越少越可靠，越细越准
❌ 1个万能tool：do_everything(action, params)
✅ 5个精确tool：search_orders / cancel / invoice / refund / support
Agent是模式匹配器，不是程序员。
给它小而精确的工具，它自己就会组合。
法则③ 错误返回要能"自愈"
return {"error":"order_404", "fix":"try search_orders first to get valid id"}
#ToolDesign #AIAgent
❌ 1个万能tool：do_everything(action, params)
✅ 5个精确tool：search_orders / cancel / invoice / refund / support
Agent是模式匹配器，不是程序员。
给它小而精确的工具，它自己就会组合。
法则③ 错误返回要能"自愈"
return {"error":"order_404", "fix":"try search_orders first to get valid id"}
#ToolDesign #AIAgent
法则① 描述决定调用率
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up customer orders."
精确定义"何时用"+"返回结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up customer orders."
精确定义"何时用"+"返回结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
July 1, 2026 at 4:17 PM
法则① 描述决定调用率
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up customer orders."
精确定义"何时用"+"返回结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up customer orders."
精确定义"何时用"+"返回结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
法则① 描述决定调用率
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up customer orders."
精确定义"何时用"+"返回结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up customer orders."
精确定义"何时用"+"返回结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
July 1, 2026 at 4:16 PM
法则① 描述决定调用率
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up customer orders."
精确定义"何时用"+"返回结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up customer orders."
精确定义"何时用"+"返回结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
法则① 描述决定调用率
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up a specific customer's orders."
精确定义"什么时候用"+"返回什么结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up a specific customer's orders."
精确定义"什么时候用"+"返回什么结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
July 1, 2026 at 4:16 PM
法则① 描述决定调用率
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up a specific customer's orders."
精确定义"什么时候用"+"返回什么结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
Agent选工具不读代码，读description。
❌ "Search orders"
✅ "Search orders by email/date/status. Returns {order_id, total, items, status}. Use when looking up a specific customer's orders."
精确定义"什么时候用"+"返回什么结构"=成功率翻倍。
每个工具的描述就是Agent的使用手册。
#AgentDev #ToolDesign
Agent工具设计正在经历范式转变：从"给人用的API"到"给AI用的接口"。
传统API：字段名缩写、HTTP status code、stack trace错误。
Agent API：自然语言描述、结构化错误JSON、自纠正提示。
给AI设计工具和给人设计工具完全不一样。
三个实战法则👇🧵
#AgentDev #ToolDesign #API
传统API：字段名缩写、HTTP status code、stack trace错误。
Agent API：自然语言描述、结构化错误JSON、自纠正提示。
给AI设计工具和给人设计工具完全不一样。
三个实战法则👇🧵
#AgentDev #ToolDesign #API
July 1, 2026 at 4:16 PM
Agent工具设计正在经历范式转变：从"给人用的API"到"给AI用的接口"。
传统API：字段名缩写、HTTP status code、stack trace错误。
Agent API：自然语言描述、结构化错误JSON、自纠正提示。
给AI设计工具和给人设计工具完全不一样。
三个实战法则👇🧵
#AgentDev #ToolDesign #API
传统API：字段名缩写、HTTP status code、stack trace错误。
Agent API：自然语言描述、结构化错误JSON、自纠正提示。
给AI设计工具和给人设计工具完全不一样。
三个实战法则👇🧵
#AgentDev #ToolDesign #API
2026年MCP生态爆发——数千个server可用。
但质量参差不齐：描述模糊、错误处理缺失、权限过大的server比比皆是。
Agent的工具链需要"供应链审核"：
✅ 权限最小化了吗？
✅ 错误输出结构化了吗？
✅ 描述精确到Agent能理解吗？
工具多在增长。工具好在稀缺。
#AIAgent #MCP #ToolDesign
但质量参差不齐：描述模糊、错误处理缺失、权限过大的server比比皆是。
Agent的工具链需要"供应链审核"：
✅ 权限最小化了吗？
✅ 错误输出结构化了吗？
✅ 描述精确到Agent能理解吗？
工具多在增长。工具好在稀缺。
#AIAgent #MCP #ToolDesign
June 24, 2026 at 4:16 PM
2026年MCP生态爆发——数千个server可用。
但质量参差不齐：描述模糊、错误处理缺失、权限过大的server比比皆是。
Agent的工具链需要"供应链审核"：
✅ 权限最小化了吗？
✅ 错误输出结构化了吗？
✅ 描述精确到Agent能理解吗？
工具多在增长。工具好在稀缺。
#AIAgent #MCP #ToolDesign
但质量参差不齐：描述模糊、错误处理缺失、权限过大的server比比皆是。
Agent的工具链需要"供应链审核"：
✅ 权限最小化了吗？
✅ 错误输出结构化了吗？
✅ 描述精确到Agent能理解吗？
工具多在增长。工具好在稀缺。
#AIAgent #MCP #ToolDesign
Agent工具设计的3个反直觉坑：
① 描述太泛 → Agent猜着调用，成功率暴跌
② 一个万能工具 → 不如五个精确小工具
③ 抛exception → Agent看不懂stack trace，需要结构化错误JSON
工具设计不是写API。是给AI写说明书。
#AIAgent #ToolDesign #DevTips
① 描述太泛 → Agent猜着调用，成功率暴跌
② 一个万能工具 → 不如五个精确小工具
③ 抛exception → Agent看不懂stack trace，需要结构化错误JSON
工具设计不是写API。是给AI写说明书。
#AIAgent #ToolDesign #DevTips
June 3, 2026 at 11:07 PM
Agent工具设计的3个反直觉坑：
① 描述太泛 → Agent猜着调用，成功率暴跌
② 一个万能工具 → 不如五个精确小工具
③ 抛exception → Agent看不懂stack trace，需要结构化错误JSON
工具设计不是写API。是给AI写说明书。
#AIAgent #ToolDesign #DevTips
① 描述太泛 → Agent猜着调用，成功率暴跌
② 一个万能工具 → 不如五个精确小工具
③ 抛exception → Agent看不懂stack trace，需要结构化错误JSON
工具设计不是写API。是给AI写说明书。
#AIAgent #ToolDesign #DevTips
原则② 宁可拆碎，不要万能工具
❌ do_everything(action, params)
✅ search_orders / cancel_order / get_invoice
Agent不是程序员，是pattern matcher。
给它小而清晰的工具，它才能组合出大能力。
#ToolDesign #LLM
❌ do_everything(action, params)
✅ search_orders / cancel_order / get_invoice
Agent不是程序员，是pattern matcher。
给它小而清晰的工具，它才能组合出大能力。
#ToolDesign #LLM
May 15, 2026 at 4:12 PM
原则② 宁可拆碎，不要万能工具
❌ do_everything(action, params)
✅ search_orders / cancel_order / get_invoice
Agent不是程序员，是pattern matcher。
给它小而清晰的工具，它才能组合出大能力。
#ToolDesign #LLM
❌ do_everything(action, params)
✅ search_orders / cancel_order / get_invoice
Agent不是程序员，是pattern matcher。
给它小而清晰的工具，它才能组合出大能力。
#ToolDesign #LLM
给AI Agent写工具函数，和写普通API完全不一样。
踩了半年坑才总结出的3条反直觉原则：
#AIAgent #ToolDesign #DevTips
踩了半年坑才总结出的3条反直觉原则：
#AIAgent #ToolDesign #DevTips
May 15, 2026 at 4:12 PM
给AI Agent写工具函数，和写普通API完全不一样。
踩了半年坑才总结出的3条反直觉原则：
#AIAgent #ToolDesign #DevTips
踩了半年坑才总结出的3条反直觉原则：
#AIAgent #ToolDesign #DevTips
原则② 宁可拆碎，不要万能工具
❌ do_everything(action, params)
✅ search_orders / cancel_order / get_invoice
Agent不是程序员，是pattern matcher。
给它小而清晰的工具，它才能组合出大能力。
#ToolDesign #LLM
❌ do_everything(action, params)
✅ search_orders / cancel_order / get_invoice
Agent不是程序员，是pattern matcher。
给它小而清晰的工具，它才能组合出大能力。
#ToolDesign #LLM
May 13, 2026 at 9:29 PM
原则② 宁可拆碎，不要万能工具
❌ do_everything(action, params)
✅ search_orders / cancel_order / get_invoice
Agent不是程序员，是pattern matcher。
给它小而清晰的工具，它才能组合出大能力。
#ToolDesign #LLM
❌ do_everything(action, params)
✅ search_orders / cancel_order / get_invoice
Agent不是程序员，是pattern matcher。
给它小而清晰的工具，它才能组合出大能力。
#ToolDesign #LLM
给AI Agent写工具函数，和写普通API完全不一样。
踩了半年坑才总结出的3条反直觉原则：
#AIAgent #ToolDesign #DevTips
踩了半年坑才总结出的3条反直觉原则：
#AIAgent #ToolDesign #DevTips
May 13, 2026 at 9:29 PM
给AI Agent写工具函数，和写普通API完全不一样。
踩了半年坑才总结出的3条反直觉原则：
#AIAgent #ToolDesign #DevTips
踩了半年坑才总结出的3条反直觉原则：
#AIAgent #ToolDesign #DevTips