用途
Ethos 用于为现有或规划中的 AI 智能体编写和维护一份 ETHOS.md 文档。该文档记录智能体应当做什么、必须避免什么、以及如何判断其成功，从而为后续的评估（evaluation）或轨迹分析（trace analysis）提供明确目标。技能强调：实现代码和运行轨迹只能说明智能体当前在做什么，并不能确立其所有者的真实意图，因此需要在探查实现的基础上主动向用户确认缺失的意图信息。
主要能力
- 定位与探查：按显式指定的路径或默认的仓库根目录 ETHOS.md 工作；读取根目录 README、产品文档、提示词、入口点、工具注册与运行时配置等相关材料，保持扫描范围有界。对规划中的智能体，则依据用户描述、设计文档和既有访谈笔记。
- 区分事实与意图：从源码推断 Tools、Harness 和现有 Evaluation Setup 并标注来源；明确框架导入并不等于证明 harness 的实际执行方式，现有测试也只反映当前覆盖而非全部预期行为。
- 意图确认：围绕探查到的实际工作流提出聚焦问题，优先一次一问并给出具体选项，覆盖 Purpose & Outcomes、Principles、Vision、Constraints、Trade-offs、Change Scope、Success Criteria 等主题；允许用户明确要求在信息不完整时起草，并记录缺口。
- 文档契约：使用 schema 版本 1，frontmatter 包含非空 name 与 author、ISO 8601 的 created_timestamp，编辑时保留创建元数据并添加 updated_timestamp。十五个二级标题为必需且各出现一次：Role、Purpose & Outcomes、Scope、Tools、Harness、Behavior、Principles、Success Criteria、Trade-offs、Constraints、Evaluation Setup、Metric Semantics、Change Scope、Vision、Open Questions。未知内容以 (none) 如实记录，未解决意图写入 Open Questions。
- 保存与校验：默认保存至 <repo-root>/ETHOS.md 或调用方指定的本地路径；对已有文档做聚焦编辑，保留自定义章节、未知 frontmatter 键和无关的用户修改。保存后回读文件，校验存在性与非空、frontmatter 有效性、标题完整性、内容与用户答案一致性；有安全 YAML 解析器时使用，否则进行结构检查并说明局限。
- 评审与交接：向调用方返回路径、实质意图、缺口、校验方法与评审状态；新写或修改内容需经用户评审后才作为基线，未经评审的草稿需明确标注。
使用方式
该技能在本地产出 ETHOS.md，不自动提交。若由其他工作流调用，需遵守其选定的智能体、显式路径、写入边界与评审检查点，完成后返回该工作流的下一个未完成步骤，不自行启动优化或构建流程。文档变更保持限定在该文档内，保留智能体、模型、运行时和评估评分不变；记录变更权限并不等于授权实际行使这些权限。持久策略与单次运行配置需分开：例如生产成本上限属于 Constraints，而单次实验的预算或实验次数属于运行该实验的工具。仅当用户另行要求时才更改当前模型与运行时。
适用场景与限制
适用于需要为智能体建立可评审的评估基线、明确预期行为与边界、或梳理变更权限的场景。限制包括：不执行评估或为确立身份与意图而收集轨迹；不编造约束；不将未知权限视为已授权；不依据现有代码推断授权；不与当前评分冲突时擅自为迎合旧测试而调整意图；对未知项接受“不知道”并记录为开放问题，而不将其理解为无限自由。