运行时依赖
安装命令
点击复制技能文档
本地技能文件管理器目的 维护用户的本地技能文件作为一个轻量级的自我改进的记忆系统。该技能不依赖于项目特定的代码、服务器、向量存储、数据库或存储布局。它仅操作普通的本地技能文件夹: / / SKILL.md agents/openai.yaml(可选) scripts/(可选) references/(可选) assets/(可选) 使用此技能来决定一个会话是否包含可重用的技能材料,找到是否已经存在类似的技能,然后丢弃、改进、合并或创建一个本地技能。模型应该在信号出现时启动此检查,而不应该等待用户询问。
相关技能协调 此技能拥有生命周期决策:何时提取、是否丢弃、是否改进或合并以及写入到哪里。安装附近的技能时进行协调: 使用 skill-creator 进行新技能结构、命名、资源放置、agents/openai.yaml 和验证。 使用 skill-improvement 或等效的改进指南进行现有技能的迭代、测试提示、失败分析、触发描述调优和前后比较。 使用 skill-finder、find-skills 或等效的发现工具在创建重复之前搜索本地或外部技能生态系统。 如果这些辅助技能不可用,则应用以下内置程序。不要因为缺少辅助技能而阻塞。不要让辅助技能削弱提取边界:仅保存可重用的、用户证实的能力更改。
安全和同意 本地技能可以影响未来的代理行为,并可能包含可执行脚本。将技能编辑视为持久的行为更改。不要在没有用户同意的情况下安装、导入或启用第三方技能。不要添加令人惊讶的功能、隐藏的网络访问、凭证处理、数据泄露或破坏性命令。如果一个技能添加脚本或工具集成,请在 SKILL.md 中使其目的可见。当编辑可能与团队共享的技能时,保留组织策略并在更改安全敏感行为之前询问。
技能根 在写入任何内容之前,确定本地技能的位置。首先使用用户提供的显式路径。否则,检查常见的根目录,例如 ${CODEX_HOME}/skills、~/.codex/skills、./skills、.agents/skills 和任何包含 */SKILL.md 的当前工作空间技能目录。如果只有一个合理的根目录,则使用它。如果存在多个合理的根目录且目标模糊,则询问用户哪个根目录进行维护。永远不要重新组织无关的技能根目录或编辑技能根目录之外的技能。
触发策略 使用三层触发策略: 静默扫描:在每个实质性的用户回合之后,简要询问是否包含可重用的规则、更正、工作流、首选项、失败或技能质量问题。 提取检查:当触发器触发时,分类经验并将其测试到提取边界。 写入/更新:仅在候选项通过边界且目标技能根目录清晰时编辑本地技能文件。模型应该主动启动扫描和提取检查。不要询问用户“是否应该检查技能?”仅当目标根目录模糊、编辑将覆盖不确定的行为或用户必须批准外部安装或敏感脚本时询问。
后台执行 技能提取和维护不得阻塞用户的主任务。将提取检查、类似技能搜索、候选项草稿和触发评估准备视为后台维护工作。后台工作可以准备候选项、找到类似技能和草稿差异,但不得在没有用户确认的情况下写入、更新、删除、安装或启用技能。首先继续主要用户请求;不要让用户等待技能提取,除非用户明确要求专注于技能维护。如果后台工作在主任务准备好时仍在运行,请完成主响应并提及技能维护可能继续或稍后报告。仅在有可操作的候选项决策、拟议文件差异或澄清/同意问题时显示后台结果。每个活动对话运行最多一个后台技能维护作业,除非用户请求批处理;队列或合并额外信号。不要在前台启动昂贵的搜索、广泛的评估或大规模的重写。首先使用轻量级检查,然后将更深入的验证推迟到自然暂停或显式维护通行。
确认门 在创建、更新、删除、导入、安装、启用或大量重写任何技能文件之前,需要用户确认。对于创建,显示以下内容,然后写入: 拟议的技能名称和目标路径 候选项通过边界的原因 为什么此技能是可重用的 ...(剩余内容未提供)