> For AI agents: the complete documentation index is available at https://docs.danqiuos.com/llms.txt, the full documentation bundle is available at https://docs.danqiuos.com/llms-full.txt.

# 编写岗位技能

Skill 是数字员工完成一类工作的执行方法。有效技能应让另一个实施人员或员工也能理解何时触发、如何操作、何时停下以及如何证明完成。

## 一个技能只负责一类结果

“经营简报”可以负责读取数据、汇总变化、形成简报。客户建档、报价、订单交接和催款属于不同业务动作，宜按职责拆分。

技能描述应覆盖真实业务表达。例如“老板询问经营状况、经营简报或周报时使用”，比“综合经营智能能力”更容易触发。

## 推荐结构

| 部分    | 必须讲清楚的内容         |
| ----- | ---------------- |
| 触发场景  | 典型请求与不适用情况       |
| 前置条件  | 当前身份、权限、必需数据     |
| 输入与输出 | 字段、时间范围、交付格式     |
| 工作步骤  | 数据来源、工具、判断规则与回写  |
| 人工确认  | 停顿条件、确认人和后续动作    |
| 错误处理  | 数据缺失、权限失败、外部系统异常 |
| 验收样例  | 正常、异常、权限和确认用例    |

## 示例：经营简报技能骨架

下面是编写结构示例，不是已经绑定真实数据表的可直接上线技能。

```markdown
# 经营简报

## 何时使用
用户要求查看指定时间范围的经营情况，或简报任务被触发时。

## 前置条件
确认请求人权限、统计时间与数据来源；缺少必要项时询问，不猜测。

## 工作步骤
1. 读取已授权台账，按企业确认的统计口径汇总。
2. 核对数据完整性，标记缺失项与口径冲突。
3. 整理经营变化、异常事项、来源依据和跟进建议。
4. 生成内部简报，回写约定的交付位置。

## 边界
不修改原始交易记录；对外发送必须取得明确确认。

## 验收
汇总值与样例台账一致；结论可追溯；缺失数据被明确标注。
```

## 绑定与调试

技能写好后，需要绑定到岗位使用的 skillset，并授予与工作步骤匹配的工具和数据权限。仅上传文件，不代表员工已经能使用。

用不同话术测试同一任务，再测试相近但不应触发的请求。出现误触发时，先检查职责重叠、描述和常驻路由，再调整文本长度。

## 版本与复用

业务字段、状态枚举、计算口径或外部系统发生变化时，应同步更新技能并重跑用例。复用时保留通用方法，将企业数据映射和授权范围作为需要核对的配置，避免把旧企业的标识带入新环境。

相关文档：[数据与权限](https://docs.danqiuos.com/build/data.md)、[装配交付](https://docs.danqiuos.com/build/delivery.md)。

## 将 CRIDO 写进执行方法

[CRIDO](https://docs.danqiuos.com/build/crido.md)中的 Reference 包括本 Skill、规则文档和网页操作经验；Input 是本次收到的字段、文件和身份。步骤中应明确先查哪些依据，再用哪些工具处理哪些输入，最后将结果交付到哪里。

密钥、密码或 token 不写入技能。需要登录或访问私有服务时，说明应引用哪个用途的团队 Secret，并验证账号和资源范围。工具集标识与调用能力见[能力速查](https://docs.danqiuos.com/reference/overview.md)。