soft-skills：AI Agent 工具实践指南

工作中遇到相关需求时，soft-skills值得先读说明，因为它主要用于用于倦怠人类和协作的通信工具包 AI。从日常自动化的使用方式看，输入边界、依赖和失败处理如果不清楚就很难稳定复用是采用前必须回答的问题。与其反复读介绍，不如用一项范围明确的真实任务完成最小试跑，再依据配置时间、输出质量、异常信息和维护痕迹做取舍。对愿意先做小范围验证并复查原始文档的团队来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

soft-skills

用于倦怠人类和 AI 协作的通信工具包。

AI 代理擅长编码，不擅长沟通。 soft-skills 解决了这个问题。

这听起来可能很熟悉

你的经纪人向你汇报（有点像小孩）：

• 一堵文字墙，是从它自己的头脑中写出来的。
• 术语是一小时前发明的。
• 断章取义毫无意义。
• 实现细节你不关心。
• 决定它应该自己做出，并向你显现。

你的代理人合作得不好：

• 主代理对子代理进行微观管理，削弱它，并破坏任何附加值。
• 它重播子代理的工作，“只是为了确保。”

前后：AI 向人类报告工作

之前

通过中间件 shim 将 TokenBucketV2 有线连接到 RL_STRICT 后面。修复了不稳定的 test_burst_window（夹具中的时钟偏差）。当我在那里时还重构了 limits.py 并碰撞了 redis-py。滑动窗口边缘情况仍然是 TBD 但应该没问题。想让我也...

之后

公共 API 上存在速率限制：每个客户端每分钟 100 个请求。

您的一个决定：付费客户是否应该获得更高的限额？我推荐1000个。

前后：AI 至 AI

主代理需要一个浏览器子代理来查找代码库中发生速率限制的位置。

之前

查找实施速率限制的位置。您在 MUST 中搜索 ONLY 这些 EXACT 位置：server/middleware.py、server/limits.py、config/redis.yaml。 NOT 看看其他地方吗？

如果它知道去哪里查找，就不需要子代理。

之后

我即将更改公共 API 限制客户端的方式。查找发生速率限制的位置及其涉及的所有内容。

这个想法

soft-skills 建立在 心理理论 之上：

在心理学和哲学中，心理理论（通常缩写为 ToM）是通过将心理状态归因于其他个体来理解他人的能力。心理理论包括理解他人的信念、欲望、意图、情感和思想可能与自己的不同。拥有功能性心理理论对于人类日常社交互动的成功至关重要。人们在分析、判断和推断他人行为时使用心理理论。

AI 代理迫使您在他们的理解和您的理解之间架起一座桥梁。 soft-skills 通过让他们为您执行此操作来解决此问题。

它教什么

特工→人类

• 结果第一。 每份报告都会让您重新审视你们共同做出的最后决定。
• 每件事都有一个名称。没有私人术语。
• 了解信号和噪音。只有什么会改变您的下一个决定。剩下的就处理好了。
• 带有上下文的问题。发生了什么变化，排除了选项，提出了建议。
• 简单的英语。 对于疲倦的大脑来说，简短的句子需要兼顾十几节课程。

soft-skills 应用认知心理学、内容和信息设计的原理以及 ASD-STE100 等经过验证的协议。

代理→代理

• 向下，各位代表。 简要说明原因以及它如何适应更大的背景。描述您需要的结果，而不是如何实现该结果。然后信任他们，让他们做他们擅长的事情。
• 向上，向领导者汇报。 仅升级需要判断的内容。了解哪些决定现在要做出并稍后报告，哪些决定值得暂停浮出水面。
• 侧面向同行。分享发现。绝不指导。

另外，权衡指南：

• 何时委托。
• 子代理与团队。
• 何时以及何时不分叉会话的上下文窗口。
• 代理领导代理。
• 在没有人观看的情况下运行几个小时。
• 快速模型与慢速智能模型。
• 管理代表及其自身的背景，以保持船舶的平稳运行。

你得到什么

• 您做出重大决定。当您阅读 AI 回复时，您的大脑就会停止疼痛。
• 在更长、更清晰的会话中获得更好的代理性能。 升级后的上下文管理可以发挥作用。
• 特工不会陷入兔子洞。他们会在正确的时间举起旗帜。
• 一个真正工作的团队。 不需要保姆。代理感觉就像您喜欢一起工作的同事。

技能

代理会在情况合适时自行加载这些内容。

如果满足以下条件， soft-skills 就是 NOT：

• 您可以轻松理解代理人告诉您的一切。
• 你不知道什么是“克劳迪什”。
• 你永远不会有“兄弟你现在在说什么”的时刻。
• 您永远不会忘记您在其他 AI 会话中所做的事情。
• 您一次最多运行一个会话。

安装

克劳德·代码

/plugin marketplace add giladbarnea/soft-skills
/plugin install soft-skills@soft-skills

法典

codex plugin marketplace add giladbarnea/soft-skills
codex plugin add soft-skills@soft-skills

Pi

pi install npm:soft-skills

然后开始一个新的 Pi 会话。

仅降价

没有 MCP 服务器，没有代码，没有网络调用，没有钩子，没有后台进程。您的笔记本电脑可能会对丢失的守护进程感到失望。