阿里云云效(DevOps)平台的命令行工具及其 Agent 技能集。本词汇表收录项目的领域术语;术语名保留英文原名为规范名,代码标识符(userId、customCode、runsOn 等)原样保留。
共享配置(YUNXIAO.md): 项目根目录下随仓库提交的团队共识配置,收录稳定的项目关联信息(组织 ID、项目 ID、仓库、工作项类型 ID)与配置型 ID 字典(状态/优先级 name→ID 表)。 Avoid: 项目配置(易与本地配置混淆)、全局配置
本地配置(.yunxiao/local.md):
项目 .yunxiao/ 目录下不入库的个人配置,收录项目级易变或个人化的 ID 缓存(当前迭代、标签映射)。
Avoid: 个人配置、YUNXIAO.local.md
全局配置(~/.config/yunxiao-cli/global.md): 本机配置目录下不入库的个人配置,跨仓库生效,收录用户身份(本人 name/userId)、org 别名映射与 org 级常用成员映射。 Avoid: 机器配置、user config、与共享配置混称
配置型 ID: 由 space+type 维度的平台配置(workflow、fields)派生的 ID(状态、优先级),全员相同、非个人化,归属共享配置。 Avoid: 个人快捷 ID、易变缓存
共享优先: 同一字段在多层配置中冲突时的默认裁决规则:共享配置胜出并提示冲突(视为配置漂移);本地与全局冲突时本地胜出(更具体)。用户可在具体场景中对话式要求反转。 Avoid: 本地覆盖、local-wins
项目空间(Project Space): 由空间 ID 标识的云效 Projex 项目。CLI 命令以项目空间限定工作项、工作项类型与标签。
组织成员(Organization Member): 个人在组织中的成员记录,拥有独立的成员 ID,区别于该成员所代表的账号用户(Account User)。
账号用户(Account User):
由 userId 标识的云效账号。工作项的责任分派对象是账号用户,而非组织成员的成员 ID。
工作项序列号(Work-item Serial Number):
工作项的人类可读编号(如 MMCL-1162),由项目空间的 customCode 前缀与序号构成。区别于工作项内部 id(哈希);按序列号搜索是全序列号精确匹配。
工作项标签(Work-item Label): 项目空间内配置的命名标签。标签通过其标签 ID 与工作项关联;标签引用或为固定格式十六进制 ID,或为标签精确名称。
规格发布(Specification Publication): 把实现规格记录为云效工作项并赋予要求的归属与元数据,然后确认存储的工作项与请求值一致的动作。
稳定工作项详情(Stable Work-item Detail): 写操作之后取回的权威工作项详情,包含已按请求持久化的字段;区别于创建操作的初始响应。
代码库(Repository): 云效代码管理中的仓库单元,由仓库 ID 或含完整组路径的路径标识。CLI 命令以代码库限定分支、提交、文件与合并请求。 Avoid: 项目(Projex 项目空间)、repo(非规范名)
代码组(Group): 云效代码管理中组织代码库与子组的容器,拥有独立的组 ID、路径与可见性。 Avoid: 团队、目录
代码组空间(Namespace): 代码组的底层 API 资源名。每个代码组都是一个空间,但组织根空间是空间而非代码组;namespaces 接口统一承载两者。CLI 通过 groups 命令组同时呈现代码组与根空间,对用户隐藏"空间"这一实现名。 Avoid: 用户面向的"空间"叫法、把 namespace 当作独立于代码组的概念
流水线运行(Pipeline Run): 流水线的单次执行实例。运行拥有独立状态,并包含该次调用执行的任务。
流水线任务(Pipeline Job):
流水线阶段内的工作单元,由共享工作区的步骤或组件调用组成。其 runsOn 配置选择执行环境;区别于任务的运行时记录。
流水线任务运行记录(Pipeline Job Run): 一次流水线运行(Pipeline Run)内某个流水线任务(Pipeline Job)的运行时记录。步骤状态与日志从此运行时边界查询,而非从流水线定义查询。
服务连接(Service Connection):
组织级集成凭据引用,供流水线代码源等资源使用。流水线 YAML 引用其返回的 uuid;连接的数字 id 是另一个提供方字段。
流水线分组(Pipeline Group): 流水线的组织性分组。分组成员关系独立于流水线的定义、执行历史与运行状态。
主机组(Host Group): 组织管理的主机集合,供部署或私有执行资源使用。主机组标识区别于流水线任务(Pipeline Job)的执行环境选择器。
使用反馈报告(Usage Feedback Report): 记录使用 CLI 或其技能时观察到的问题或低效的单 Issue 文档:发生了什么、涉及的命令、疑似责任方。每份报告恰好覆盖一个问题、一个主分类。收集动作发生在问题出现的会话内,默认存系统临时目录,绝不修改代码、文档或 Issue。消费报告是人的任务,不是技能动作。