删掉空洞形容词,用具体行为、真实命令和精确版本替代套话。例如将“高性能”删除,把“提供完善的错误处理机制”改为“缺失配置时直接报错并提示修改哪行.env文件”,首行放可执行命令及对应终端截图,明确写出Node.js 18.17+等具体依赖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
写项目readme时堆砌“简洁明了”“开箱即用”“企业级”这类空洞形容词,会让读者立刻跳过正文——因为这些词没告诉别人你的项目到底能解决什么具体问题、在什么场景下真正可用。先删掉所有不指向具体行为的形容词
打开README.md,逐行扫描,删掉“高性能”“轻量级”“现代化”“优雅”“强大”等无法被验证的修饰语。这类词本身不传递信息,只消耗读者耐心。
保留唯一标准:这个词删掉后,用户是否无法判断下一步操作?如果删了不影响执行,就删。
用动词短语替代名词化套话
方法一:把“提供完善的错误处理机制”改成“运行时遇到缺失配置会直接报错,并提示改哪行.env文件”。
方法二:把“具备良好的可扩展性”改成“想加微信登录?复制粘贴3行代码到auth.ts,再填一个WECHAT_APP_ID环境变量”。
方法三:把“遵循最佳实践”改成“默认禁用eval()、自动转义HTML输出、JWT密钥强制从环境变量读取”。
将 Claude Agent SDK 与 You.com HTTP MCP 服务器集成,支持 Python 和 TypeScript。当开发者提及 Claude Agent SDK、Anthropic Agent SDK 或将 Claude 与 MCP 工具集成时使用。
用真实命令和截图锚定可信度
第一步:在“快速开始”区块里,第一行必须是可复制粘贴的真实命令,例如:curl -sL https://raw.githubusercontent.com/xxx/cli/main/install.sh | sh。
第二步:紧接其后放一张终端截图,图中必须包含命令回车后的前两行输出(比如显示“Installing v2.4.1…”和“Done. Run mytool --help to start”),截图不能打码路径和版本号。
第三步:如果项目依赖特定系统版本,必须写成“仅支持 Node.js 18.17+(因使用了stream.Readable.from({objectMode: true}))”,而不是“兼容主流Node版本”。【不写清楚版本边界会导致用户在Node 16上卡死在install阶段】

















