我需要给我的 AI 工具设置提示词吗

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

什么时候需要提示词

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

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

推荐写法

可以这样写：

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

确认范围后再写：

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

团队规则放在哪里

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

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

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

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 自行决定的内容

以下内容需要人工确认：

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

更多 AI 修改流程请阅读任务驱动。