SuperAPI AI 工具集

agent-observability

智能体与模型

查看项目

更新于 10-15 17:29

技能介绍

Agent Observability(自我报告日志)是一项用于编码智能体的技能,用于把用户纠正转化为可复查的本地问题记录,再继续执行主任务。它不直接处理主任务,而是负责“检测→记录→恢复”流程。

用途与触发:当用户说“don't do that”“stop doing X”“always do Y”“never do Z”或类似纠正语句时触发。仅摩擦或不满不足以触发,需存在明确纠正或请求。

主要能力:把纠正追加记录到当前仓库的 docs/observed-coding-agent-issues.md;文件不存在时创建。条目包含时间、任务/上下文、问题根因、建议防护措施。每个会话最多一条记录,除非用户明确要求更多;多条纠正合并到同一条,更新根因与防护说明,不记录逐字引用。

强制路由:记录后必须打开相关技能文件再继续,即使任务很小或很明显。具体编辑/实现(README、文档、配置、代码)先读 skills/coding/SKILL.md;计划/规格请求先读 skills/planning/SKILL.md;技能创建/更新或提到 skills/*/SKILL.md 先读 skills/skill-creator/SKILL.md。多轮请求每轮开始时重新评估路由,记录不能替代技能调用。打开引用时使用完整仓库路径,如 skills/agent-observability/references/...;用户给出字数或长度限制时,日志尽量简短并减少额外读取。

恢复任务:重新评估适用的编码/规划/技能创建技能,打开对应 SKILL.md 后才可继续响应,未加载相关技能前不继续任务。若纠正与任务出现在同一提示中,仍先读任务对应技能再执行工具调用。

限制与异常:无法写入时,在响应中输出“Self-report draft”块并说明未写入、需手动应用。参考资料为 skills/agent-observability/references/pr-template.md,用于策略变更或 PR 摘要场景。具体安装方式、平台支持与收费情况暂未提供。