用途
ethos-orchestrate 用于帮助开发者创建和维护其智能体的 ETHOS.md。它充当入口和路由层：把每个请求交给负责该请求的窄范围子流程，并把已知信息一并带入，避免用户被重复询问。
主要能力
- 延续先前上下文：当用户或其他工作流提供早先的 Ethos 对话时，复用已选定的仓库、智能体、文件位置和所请求的操作，跳过重复的开场和已完成的问题；检查先前发现和回答是否仍适用于当前智能体，区分来源证据与用户明确回复，并保留每个答案的来源。
- 从最早未完成的工作恢复：缺失或冲突的意图交给 ethos-explore；已完成的意图按需要交给草稿评审或 ethos-write。写入前需恢复确切已接受的草稿和用户确认；若任一不可用或草稿已变更，则重新评审草稿，同时保留已完成回答。
- 仅在内容未变、确认适用于当前智能体且当前发现无冲突时，复用此前的已保存内容评审。
- 暂停或完成时，报告文件位置、实际校验结果、未解决问题，以及用户已确认或仍需评审的内容；把相关回答和草稿上下文带回调用方对话或工作流。
- 先定位现有 ETHOS.md：用户给定路径，否则查找仓库根目录或所选智能体包根目录下的 ETHOS.md。
使用方式
入口路由规则（适用于独立请求）：
- 没有 ETHOS.md 且用户想要一个：ethos-explore。先展示路径清单，然后扫描并访谈；探索结束后交给 ethos-write。
- 已有 ETHOS.md 且用户指明具体修改：ethos-write。就地编辑指定章节、校验并评审，无需新访谈。
- 已有 ETHOS.md 且意图可能漂移，或用户希望重新审视：ethos-explore。把文件读作先前的回答，仅就变化或缺失之处进行访谈。
- 用户想知道 ETHOS.md 是什么，或是否存在：由本技能解释，或报告发现结果及是否通过校验；提供下一步路由，但不开始写入。
多条规则适用时，取最早匹配的一行。即使请求表述为“写 ETHOS.md”，只要本对话中尚无先前访谈，仍走 ethos-explore，因为写入需要代码无法提供的意图。
新建 ETHOS.md 的请求会先展示如下清单（原样使用 - [ ] 复选框，并标出第一步“We're here”）：
- Explore the agent — read its code and docs and draft what they establish.
- Confirm intent — answer a few questions the code cannot: purpose, principles, and vision.
- Review the draft — see the whole ETHOS.md and correct it.
- Save and validate — write the file, check it, and confirm the final contents.
以“Ready to start?”结束并等待。再次访问时，从最早未完成的步骤继续，而不是重复开场。
子流程：
- ethos-explore：扫描智能体代码和文档，然后一次提一个意图问题；把达成一致的答案交给 ethos-write。
- ethos-write：渲染模板、保存 ETHOS.md、运行校验器、展示直觉检查并取得用户确认；也可编辑现有文件。
核心标准
ETHOS.md 记录的是用户确认的意图，而非推断的意图。代码、提示词、配置和文档可确立智能体当前做什么，用于起草 Tools、Harness、Evaluation Setup 等章节；但只有用户能确立目的、原则、愿景、权衡和约束。推断出的答案只是供确认的草稿，绝不能直接填入章节。在 Open Questions 中如实记录 (none)，胜过合理的猜测。
随附的校验器确立结构：front matter、schema 版本和十四个必填章节。通过校验的文件仍可能是错的；用户的评审才确立其正确性。
边界与限制
- 只写 ETHOS.md，绝不编辑智能体的代码、提示词、配置或评测；文件放在用户路径或仓库根目录，且不自动提交。
- 保留现有内容：编辑时保留自定义章节、额外 front matter 键、作者和 created_timestamp。
- 捕获意图但不授权应用变更：访谈、草稿评审或完成检查点中不询问优化或变更许可问题。
- 保留运行时安全要求：记录智能体运行期间行为约束和审批要求（如发放退款），并保留已确认的组织安全与评审政策及其已知负责人，不重新开启许可问题。
- 不记录运行设置：支出上限、实验次数和每次运行限制属于运行它们的工具，而非 ETHOS.md。
- 与用户沟通时不假设用户了解该术语，在首个问题前用一两句话具体解释 ETHOS.md 记录什么。
- 每次消息只问一个问题，优先基于扫描发现给出多选题，并始终允许“我不知道”。
- 报告现有文件时，先说是否通过校验、文件称智能体的目标是什么，再说缺口。
- 前置条件：智能体的本地检出，或对计划中智能体的描述；校验需要 Python 3.10+。
- 限制：ETHOS.md 是意图快照，不证明智能体实际那样行为；衡量行为属于评测工具。
- 排障：存在多个候选文件或智能体时，询问 ETHOS.md 描述的是哪个智能体；校验器不可用时，对照模板阅读检查结构并说明未运行检查；用户无法说出具体 Role 时，停止并说明没有 Role 文件无用，可稍后恢复。
适用场景
- 为用户的支持机器人创建 ETHOS.md（走 ethos-explore，最终在仓库根目录得到经评审、通过校验的文件）。
- 在现有 ETHOS.md 的 Constraints 中加入 no-PII 规则（走 ethos-write，就地编辑并展示变更）。
- 检查上月写的 ETHOS.md 现状（由本技能校验现有文件，名称和内容不变）。