setup-sakana-skills

设置 Sakana Skills

准备好已安装的使用者可直接读取的约定。仅在用户调用此技能时运行。复用现有指导；配置充分时无需设置。设置负责配置，不负责运行时调度、技能安装或记录迁移。

1. 检查有效指导

读取适用的用户级和项目级 AGENTS.md、CLAUDE.md 及其指针，包括存在时的 docs/agents/。核实所选客户端实际使用的指令位置，不要臆造原生配置键。检查仓库身份和已安装使用者的要求。区分工作记录、规范问题、评估夹具和私有演进历史。

按当前明确指令、项目覆盖项、全局默认值的顺序确定设置。记录每个有效值的来源。现有用户选择的记录位置和提交权限在其声明的范围内继续有效。编辑前，检查相互冲突的指导、重复指针以及共享文件或符号链接文件。

**完成条件：**每项必需设置都有有效值、待选择项或具体冲突。如果没有待选项，也没有用户要求的更改，则报告无需设置。

2. 仅确定缺失的选项

沿用已作出的决定。仅配置受支持的使用者和请求的范围：

• **范围和客户端：**全局默认值、项目覆盖项或两者；Claude Code、Codex 或两者。说明项目如何继承或覆盖值。即使继承了通用约定，项目跟踪器身份仍应为项目专属。
• **工作记录：**确切的根目录、已核实的项目／上游／派生仓库身份、现有索引和单条记录布局，以及便于定位用户 PR 的作者身份或明确来源信息。观察和机会使用同一种通用格式；复用现有历史，不要移动。
• **记录权限：**哪些类型允许常规保存和实质性更新；另行确认每条新记录和实质性更新是否应创建本地提交。用户选择后，此政策可涵盖观察、机会、评估和实施进度。修改和推送仍需单独指示。不要从仅限 Explore 的规则推断出更广泛的权限。
• **规范跟踪器：**复用现有的跟踪器指导。若不存在且有需要，对于已核实的 GitHub 项目，建议使用 GitHub Issues；也可使用用户选择的本地 Markdown 目录。保留其他已确立的跟踪器。确认其确切目标位置和工具；补充远程证据不会产生第二个规范目标位置。

配置记录时，阅读工作记录指导模板。其共享约定来自 Assess；对于使用该约定的使用者，声明此依赖。仅在配置相应跟踪器时，才阅读现有的 GitHub 或本地跟踪器模板。

**完成条件：**必需选项均有确切的现有值或用户选定的值。缺少访问权限应明确标注为限制，不得视为连接成功。

3. 展示具体配置

每个指导主题保留一份权威文档。复用现有位置；对于新项目指导，docs/agents/working-records.md 和 docs/agents/issue-tracker.md 是合适的选择。对于全局默认设置，提出一份确切的用户级文档，并提供可从所选客户端已验证的全局指令中访问的指针。这里的全局配置是 Agent 可读取的指导，而不是新的应用设置。

写入前，展示确切文本、路径、作用范围和生效值。Agent 入口应包含简洁的条件式指针。记录指针必须涵盖普通聊天：开始实现或提交 PR 前，阅读相关记录和声明；交付后，在配置的权限范围内核对链接并更新进度。保留独立审计的历史门槛。不要在入口中复制技能正文或安装运行时路由器。

保留无关的领域、标签和项目规则。两个客户端都可以指向同一份指导。仅解析一次符号链接。只有在用户选择私有本地存储时，才添加范围狭窄的忽略规则；不要假设记录仓库是私有的。创建目标位置或更改现有记录，与记录其位置是两回事。

**完成条件：**用户已批准确切的配置变更。对相同文本和作用范围的先前批准仍然有效。批准可复用技能的设计，不代表批准修改用户的全局设置。

4. 应用并验证

仅应用已批准的配置。验证每个所选入口中的指针、有效优先级、项目身份、记录与跟踪器权限之间的区别，以及无关内容是否保留。确认任何获准创建的目录，并单独报告无法访问的路径。

重新执行一次设置检查：指导未变更时，不应需要进一步编辑。报告变更的文件、全局或项目影响、使用方及未经验证的访问情况。不要在设置过程中创建发现项、发布问题、迁移历史记录或安排同步。

**完成条件：**已批准的指导可读取，有效选项含义明确，且第二次检查未发现重复内容或必要的重写。