Update #350-2025.09.08.md

Author: zhangferry

Reports/2025/#350-2025.09.08.md

@@ -52,7 +52,31 @@
 
 [@Damien](https://github.com/ZengyiMa)：作者重启搁置的 ActionBuilder 项目，通过扫描 Package.swift 实现零配置生成 GitHub Actions tests.yml，借 Swiftly 自动识别 Swift 版本并调度 Linux/macOS  runner，对 iOS 等 Apple 平台则调用 Xcode 构建且已适配 Swift 6.0-6.2，未来将以轻量 CLI 取代插件，可直接嵌入 Xcode build phase 随编译自动更新工作流。
 
-
+### 🐎 [What makes Claude Code so damn good (and how to recreate that magic in your agent)!?](https://minusx.ai/blog/decoding-claude-code/)
+
+[@zhangferry](zhangferry.com)：在编程领域为什么总感觉 Claude Code 比其他 Agent 要强不少？除了模型本身的差异，更重要的是对 Agent 的设计逻辑上，本文罗列了几点值得借鉴的 Agent 设计原则。
+
+1. 控制逻辑设计
+   
+* 只保留一个主循环，最多增加一个处理分支。过多分支路径下既容易出错，还不容易调试
+* 一些简单工作比如读文件、总结记录等交给小模型处理
+
+2. Prompts 设计
+  
+* 要有一个整体的配置文件（类似 claude.md）以记录用户偏好，比如跳过某些文件夹，使用特定的库。来自 MinusX 的实践，在 AI 首次遇到一些不了解的专有名词时，会自动提醒要不要补充信息到该配置文件。
+* 一些标记或者示例，可以使用 XML 标签或者 Markdown 语法，以强化提醒
+
+3. Tools 设计
+  
+* 在内容搜索时使用 jq、find 这类轻量工具而不是 RAG 这种重工具
+* 给工具分类，低级工具（bash 命令、读文件）、中级工具（grep、glob）、高级工具（网页搜索等 MCP），每个工具都注明其适用场景
+* 让 AI 自己管理 todo list。长任务里，AI 容易忘事，就让它自己写待办、随时看，还能中途改，避免做到一半 “跑偏”
+
+4. 可控性设计
+  
+* 语气和风格限制，使得 AI 回答更简洁
+* 对于重要的规则，使用这些关键字 `IMPORTANT`，`NEVER` 会很有效
+* 「什么时候该做什么，不该做什么」不易过多，因为他们容易冲突，处理逻辑的关键步骤需补充一些启发式的方法和处理策略
 
 ## 工具