
先写操作边界
Skill 应说明通过什么入口管理网站、凭据从哪里安全读取、哪些行为禁止。对 MoteCMS 来说,内容与主题通过受鉴权 HTTPS API 操作;不能为了方便直接写数据库或静态发布目录。边界越清楚,下一次会话越不容易绕过真实能力。
接口说明要包含状态变化
只列路径远远不够。创建资源是否产生草稿、修改是否需要修订号、发布是否返回任务、专题是否有独立生命周期,都会影响操作结果。Skill 应解释这些行为,并提供查询真实状态的方法。
重试与冲突也属于正常流程
网络请求可能超时,任务队列可能忙,记录可能被更新。幂等键、修订号、任务查询与退避规则都应该成为明确步骤。不能把错误处理留给 Agent 临时猜测,更不能建议盲目重复写入。
把最终页面纳入完成条件
Skill 应提醒调用者检查匿名访问、实际页面、关联入口和移动端体验。任务成功与页面可用之间还有一段距离。记录应该区分已调用、已发布与已验证,避免把一次旧验收当成永远成立的事实。
Skill 的价值在于让后续工作可接续、可判断,而不是让文档看起来无所不能。