用途
ethos-write 用于生成 AI 代理的 ETHOS.md 文件。ETHOS.md 是代理的持久化意图快照，记录它存在的目的、预期行为、边界和成功标准。该文件是人与代理在构建、评估、审查或修改该代理之前阅读的契约。没有它，每个参与方都必须重新询问所有问题，且没有任何记录说明代理应该做什么。
ETHOS.md 记录的是代理的预期状态，而非已实现状态。代码库已经展示了代理实际做什么；ETHOS.md 是唯一记录它应该做什么、绝不能做什么、以及如何在不同指标之间权衡的地方。
主要能力
- 从 ethos-explore 收集的答案生成 ETHOS.md，包含 schema_version 1 及所有必需章节。
- 执行硬性前置条件检查：角色必须是一句具体描述，模糊答案会被退回 ethos-explore 补充。
- 在渲染前进行焦点检查：目的与成果、成功标准需说明使命、用户价值、可衡量结果和成功门槛；权衡需可决策（优先级顺序与硬性门槛）；约束需可检查。
- 生成“直觉检查”段落，快速概括代理角色、目的、范围、原则和愿景，供用户确认写入是否正确。
- 运行自带验证脚本 scripts/validate_ethos.py，检查 front matter、schema 版本、必需章节和重复章节。
- 支持保留用户自定义章节和额外 front matter 键，不强制剥离自定义内容。
使用方式
该技能通常由 ethos-explore 延续调用，复用已确认的答案。写入前确认代理名称（简短可识别，如 it-helpdesk、support-triage、code-reviewer）。定位 ETHOS.md 路径：优先使用用户指定路径，否则复用已有文件，否则写入仓库根目录；多代理仓库中写入代理自身包根目录并与用户确认。文件写入后运行验证脚本，展示直觉检查段落和完整文件内容，请用户确认。用户确认后，告知文件位置并准备提交。若意图变化，就地编辑并设置 updated_timestamp。
适用场景
适用于为 AI 代理建立持久化设计契约，供开发、评估、审查或变更代理时参考。适用于需要明确代理使命、成功标准、可决策权衡和可检查约束的团队。
限制
该技能不编写代理配置、运行时 YAML 或代码，不注册或部署代理。不编码评分函数；权衡部分以散文记录开发者意图，转换为阈值和权重属于评估或变更代理的环节。不包含已知问题或信号章节，问题跟踪属于团队的问题追踪器。ETHOS.md 写入代理仓库，与代码一同提交，不存在远程权威副本。若角色缺失或模糊，必须退回 ethos-explore 补充，不得编造默认值。空答案应写 (none) 并在开放问题中记录缺口，不得虚构约束。