跳转至

译文

译自西班牙语原文,以原文为规范文本。 状态:草稿,待人工审校。如有歧义,以西班牙语原文为准。

身份与清单

基于 MILPA 0.1 的现行应用指南。解释已被接受的规则;不定义新的格式。

清单使人能够知道一个项目是什么、由谁负责、其范围到哪里为止,而无需从目录结构中推断。它不是提示词,也不是访问凭据。

从七个问题开始

问题 清单的内容
这是什么项目? 标识符。
它扮演什么角色? 节点角色:在与其他项目的关系中所起的作用。
谁负责? 人类负责人。
包含什么、排除什么? 范围。
它声明了什么结构? 应用配置及其状态。
它在组织上依赖哪个节点? 父节点,或无。
哪些内容受限? 受限区域。

这些内容源自 MILPA-R-004。该要求规定在项目根目录提供一份机器可读的清单。本指南中的表格有助于准备内容,但不能取代该表示形式及其验证。

本方法不固定 JSON、YAML、文件名或某个 SDK 的模式。这些细节由应用配置来具体确定。由于 0.1 版本中没有已被接受的应用配置,请登记一份提案;不要宣称一个并不存在的已被接受的应用配置。如果项目处于过渡中,MILPA-R-006 的例外要求声明目标应用配置和日期,并须经负责人接受。

说明性示例

虚构项目:使用合成数据审查一个图书馆目录。

  • 标识符:ejemplo-catalogo。
  • 角色:文档审查项目,不对生产环境进行操作。
  • 负责人:由项目指定的人员,尚待确定。
  • 范围:检测可能的重复记录并提出更正建议;不删除。
  • 应用配置:正在审查中的本地提案,不是 MILPA 已被接受的应用配置。
  • 父节点:在本示例中无。
  • 受限区域:账户、凭据、用户数据以及任何生产系统。

该示例不是可以直接运行的清单:缺少负责人的真实身份、所选的表示形式以及验证。它不是符合性声明。

不要混淆身份、权威与权限

“节点角色”不是智能体的角色,也不是某个人的权限。清单不授予访问权。如果存在智能体,它们的范围按 ASILO-R-004 单独描述。

节点的深度同样不是文档权威,也不是某项断言的确定性。MILPA-R-004 禁止为此使用像 level 这样的同名词。清单的有效继承不在 0.1 版本的范围内:声明一个父节点并不会继承规则或权限。

保留什么

保留清单的修订版本、所声明的应用配置、其状态以及其验证结果。当范围或关系变化时,检查它是否仍然描述该项目。一份正确的清单也可能过时,而且它本身并不阻止受限内容被读取。

下一篇:结构与命名 · 查阅清单卡片

打开卷宗之前的一张卡片

就像图书馆的卡片,清单让人在阅读全部材料之前,先识别目的和负责人。这张卡片既不授予访问权,也不证明内容的质量。

术语表。