---
title: 我需要给我的 AI 工具设置提示词吗
navTitle: AI 提示词设置
---
# 我需要给我的 AI 工具设置提示词吗

需要，但不建议把所有规则都写成很长的个人提示词。更推荐把团队共同规则写在项目文档或 AI 规则文件中，个人提示词只补充当前任务目标和限制。

## 什么时候需要提示词{#when}

以下场景建议明确提示 AI：

1. 只允许修改某个项目、目录或文件。
2. 不允许推送服务器或执行 SQL。
3. 不允许修改权限、流程、数据范围等敏感内容。
4. 需要先解释影响范围，再开始修改。
5. 修改完成后需要列出文件清单和验证建议。

## 推荐写法{#recommended}

可以这样写：

```text
请在当前 SuccApp 工作区中查找和客户明细页面相关的元数据文件。
先不要修改。请说明候选文件、判断依据和可能影响范围。
```

确认范围后再写：

```text
请只修改客户明细页面标题，不要修改字段名、资源 ID、权限、流程和脚本逻辑。
修改后请列出变更文件，并提醒我需要检查哪些 diff。
```

## 团队规则放在哪里{#team-rules}

团队长期规则不建议只放在个人对话中。可以考虑放在：

1. 项目 README。
2. 团队实施规范文档。
3. `AGENTS.md`、`CLAUDE.md` 或 `.github/copilot-instructions.md` 这类 AI 工具支持的项目级规则文件。
4. 当前任务的需求说明或变更说明。

执行 `succapp workspace init` 后，SuccApp 会初始化常见 AI 协作入口和目录；官方离线文档同步成功后，才会写入 `.agents/skills/succapp-docs/`：

```text
workspace/
├── AGENTS.md
├── CLAUDE.md
├── .github/
│   └── copilot-instructions.md
└── .agents/
    ├── README.md
    ├── plans/
    ├── reviews/
    ├── reports/
    ├── rules/
    ├── skills/
    │   └── succapp-docs/
    └── tmp/
```

其中 `AGENTS.md` 是主要规则入口，`CLAUDE.md` 默认引用 `AGENTS.md`，`.github/copilot-instructions.md` 用于给 GitHub Copilot 提供仓库级说明。长期规则和 AI 产物建议统一放到 `.agents/`：

| 目录 | 用途 |
| :--- | :--- |
| `.agents/plans/` | 实施计划、迁移计划、多步骤任务计划 |
| `.agents/reviews/` | Code Review、设计评审、变更评审 |
| `.agents/reports/` | 调查报告、分析报告、验证报告 |
| `.agents/rules/` | 团队长期 AI 协作规则 |
| `.agents/skills/succapp-docs/` | 官方离线文档 skill，同步成功后生成，包含 SuccApp 手册索引、示例和配套资料 |
| `.agents/tmp/` | 临时脚本、草稿和一次性排查文件 |

`.agents/plans/`、`.agents/reviews/`、`.agents/reports/` 和 `.agents/tmp/` 默认忽略其中的文件，避免未确认的 AI 草稿进入 Git。需要长期保留的计划、评审或报告，应由团队确认后再调整忽略规则或移动到约定位置。

## 不建议交给 AI 自行决定的内容{#risks}

以下内容需要人工确认：

1. 是否推送生产环境。
2. 是否强制覆盖服务器变化。
3. 是否删除大量元数据文件。
4. 是否修改权限、流程、数据范围。
5. 是否执行高风险 SQL。

更多 AI 修改流程请阅读[任务驱动](../task-driven.md)。