连接 AI 文档

Appearance

第一次任务示例 ​

适用对象：已经完成基础测试，但还不知道第一次该让 Agent 做什么的新手用户。

预计耗时：5-10 分钟。

先用临时目录练习 ​

第一次不要在重要项目里练习。请先新建一个临时目录，只放练习文件。

Windows PowerShell：

powershell
mkdir lianjieai-agent-test
cd lianjieai-agent-test

macOS/Linux：

bash
mkdir lianjieai-agent-test
cd lianjieai-agent-test

然后在这个目录里打开你已配置的编程助手，先确认当前模型属于连接AI，再进行练习。

示例 1：只让 Agent 解释，不修改文件 ​

发送：

text
请先不要修改任何文件。请用三句话告诉我：你现在能看到当前目录吗？如果能看到，请说明当前目录里有什么。

你要确认：

  • Agent 没有直接改文件。
  • Agent 能描述当前目录。
  • Agent 如果看不到目录，会直接说明原因。

示例 2：创建一个安全练习文件 ​

发送：

text
请在当前目录创建一个 hello.txt，内容写入：hello lianjieai agent。

完成后打开 hello.txt，确认内容是：

text
hello lianjieai agent

如果工具要求你先确认文件修改，请先看清楚文件名，再点击同意。

示例 3：让 Agent 先给计划 ​

发送：

text
请帮我把 hello.txt 改成两行内容。先只给操作计划，不要修改文件。

你要确认：

  • Agent 先解释它准备怎么改。
  • 没有直接修改文件。
  • 计划只涉及 hello.txt。

确认计划没问题后，再发送：

text
可以按这个计划修改 hello.txt。

示例 4：让 Agent 分析报错 ​

如果你遇到报错，可以先让 Agent 只分析，不让它动文件。

发送：

text
下面是我看到的报错，请先解释可能原因，并告诉我下一步该检查什么。不要修改文件。

报错内容：
401 Unauthorized

你要确认：

  • Agent 优先提醒检查 API Key。
  • Agent 不要求你贴出完整 API Key。
  • Agent 给出的是下一步检查项，而不是让你盲目重装工具。

示例 5：在真实项目里只做小改动 ​

临时目录练习成功后，再进入真实项目。第一次真实项目任务建议只做一件很小的事。

推荐发送：

text
请先阅读 README，不要修改文件。用中文告诉我这个项目如何启动，以及你建议我先检查哪一个命令。

如果确实要修改文件，推荐这样写：

text
请只修改 README.md，补充一段“本地启动方式”。修改前先说明计划，修改后告诉我改了哪些内容。

不推荐的新手提示词 ​

这些提示词范围太大，第一次使用时不建议直接发送：

不推荐写法风险
帮我重构整个项目影响范围太大，你很难检查
把所有报错都修了Agent 可能改很多文件
直接提交并推送你还没有检查改动就进入远端
这是我的 .env，帮我看看可能泄露 API Key、Token 或数据库密码
随便改，只要能跑目标不清楚，容易产生无关改动

怎么检查 Agent 改了什么 ​

如果当前目录是 Git 项目，修改后先运行：

bash
git status --short

再查看具体差异：

bash
git diff

你要确认：

  • 改动文件是你允许 Agent 修改的文件。
  • 没有把 .env、API Key、Token 写进文件。
  • 没有出现你看不懂的大段无关改动。
  • 如果项目有测试命令，先运行测试再提交。

小白判断法

如果你看不懂 Agent 改了什么，就先不要提交。可以让 Agent 用中文逐条解释改动原因。

下一步 ​

完成检查 ​

  • 已在临时目录完成一次只读任务。
  • 已在临时目录完成一次创建或修改文件任务。
  • 知道修改后用 git status --short 或工具界面检查改动。
  • 知道不要把完整 API Key、.env、Token 发给 Agent 或别人。
  • 第一次真实项目任务会限制文件范围，并要求 Agent 先说明计划。