> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 最佳实践

> 按内容用途选择存放位置，以及 Waker 创建、对话、自动任务、知识与权限、更新等各阶段的必查事项。

按内容用途选择存放位置：工作文件放项目目录，稳定资料放知识库，长期偏好放记忆，一次性要求放当前对话或运行输入。

## 各阶段必查事项

| 时机                | 必查事项                                  |
| ----------------- | ------------------------------------- |
| 创建或修改 Waker       | 职责、输入、输出和边界清楚；只绑定必需能力；用正常和越界任务验证      |
| 发起对话              | Waker、设备和工作目录正确；写明目标、范围、输出和验收；完成后检查产物 |
| 上线自动任务或 WakerFlow | 先手动验证正常和失败路径；外部写入保留人工确认；再启用触发         |
| 更新知识、权限或连接器       | 清理过期资料并检查访问范围；从只读、最小权限开始；用新会话验证       |
| 更新应用              | 核对运行版本，并对关键任务做一次小范围试运行                |

<Warning>
  凭据只能填写在受保护的授权或配置入口中，不得写入简介、知识库、记忆、对话或业务日志。每次重要变更后重新验证。
</Warning>