译文
译自西班牙语原文,以原文为规范文本。 状态:草稿,待人工审校。如有歧义,以西班牙语原文为准。
身份与清单¶
基于 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 版本的范围内:声明一个父节点并不会继承规则或权限。
保留什么¶
保留清单的修订版本、所声明的应用配置、其状态以及其验证结果。当范围或关系变化时,检查它是否仍然描述该项目。一份正确的清单也可能过时,而且它本身并不阻止受限内容被读取。
打开卷宗之前的一张卡片¶
就像图书馆的卡片,清单让人在阅读全部材料之前,先识别目的和负责人。这张卡片既不授予访问权,也不证明内容的质量。
术语表。