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, and this page is available as Markdown at https://docs.danqiuos.com/build/skills.md.

编写岗位技能

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

一个技能只负责一类结果

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

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

推荐结构

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

示例:经营简报技能骨架

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

# 经营简报

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

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

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

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

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

绑定与调试

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

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

版本与复用

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

相关文档:数据与权限、装配交付。

将 CRIDO 写进执行方法

CRIDO中的 Reference 包括本 Skill、规则文档和网页操作经验;Input 是本次收到的字段、文件和身份。步骤中应明确先查哪些依据,再用哪些工具处理哪些输入,最后将结果交付到哪里。

密钥、密码或 token 不写入技能。需要登录或访问私有服务时,说明应引用哪个用途的团队 Secret,并验证账号和资源范围。工具集标识与调用能力见能力速查。