SuperAPI AI 工具集

instructions-method

办公与效率

查看项目

更新于 10-15 09:51

技能介绍

用途

instructions-method 用于创建、审计和维护持久化的项目指令,写入 AGENTS.md、CLAUDE.md 或目标宿主既定的指令文件。它关注的是让项目指令长期可用、可维护,而不是一次性生成一段文本。

主要能力

  • 目标与权限判定:优先使用用户明确指定的目标位置,其次使用项目已有的权威指令文件及其文档化的同步规则。对于新项目,使用已确认适用于当前宿主/配置的机制(例如 Codex 使用 AGENTS.md,Claude 使用 CLAUDE.md,或已配置的规则)。如果绑定关系未知,会先给出具体候选目标,而不是发明一个通用文件名。
  • 准备阶段:在检查声明之前,先阅读清单、源码结构、入口点、已配置命令和 CI;按长期类别和归属进行映射,而不是逐个文件处理;将已批准的需求/决策与实现分开阅读。
  • 审计与创建:以显式的 audit-only 或 create 模式分派 instructions-auditor。审计模式只把发现返回给所属运行记录,不编辑任何持久化文件;创建模式使用已规划的目标位置和已验证事实。
  • 应用与验证:审计是默认行为。在获得授权的修复/提交时,复用同一份声明报告,保留未验证的声明而不编造支持证据,并将其与已被证伪的声明区分开。在记录完成前,重新检查路径、命令、指令作用域和生成副本的一致性。

使用方式

该技能接收项目根目录、工作树/快照、范围、请求的指令目标、模式、现有文件、证据路径和授权信息,并复用调用方的运行记录。准备阶段会读取 references/instruction-loading.md;当新项目需要工作指导时读取 references/working-principles.md;当存在或计划测试时读取 references/test-suite-rules.md;references/instruction-example.md 仅用于说明结构,不代表目标项目的当前包版本或要求。

适用场景

  • 为项目建立或整理 AGENTS.md、CLAUDE.md 等持久化指令文件。
  • 审计现有项目指令中的声明、引用和重复内容。
  • 在多个宿主之间维护指令时,依据明确的项目规则使用生成副本或薄指针副本。
  • 需要区分“文本义务”与“机械强制”时,要求提供实际守卫证据。

限制

  • 文件存在并不证明它会被加载或可强制执行;需要绑定实际的宿主/版本、已配置的发现机制和适用的根/嵌套作用域,并记录证据与未知项。
  • 绝不维护两套相互矛盾的独立指令集;不要直接重写生成的指令副本。
  • 没有相关环境中的实际守卫证据时,不得声称文本义务已被机械强制执行。
  • 运行状态、任务列表、临时路径和单次运行结果保留在操作记录中,不写入持久化指令。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。