@hap-labs/human-agent-paradigm 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
The **governance content package** of the Human-Agent Paradigm (HAP): six frozen governance documents and their
|
|
4
4
|
structural self-check tool, published as a standalone npm package so that the content.
|
|
5
5
|
|
|
6
|
-
**English** | [简体中文](README.
|
|
6
|
+
**English** | [简体中文](docs/ZH_CN/README.md)
|
|
7
7
|
|
|
8
8
|
## Contents
|
|
9
9
|
|
|
@@ -2,18 +2,18 @@
|
|
|
2
2
|
|
|
3
3
|
人机协作范式（HAP）的 **治理内容包**：六份冻结治理文档与其结构自检工具， 作为独立 npm 包发布。
|
|
4
4
|
|
|
5
|
-
[English](README.md) | **简体中文**
|
|
5
|
+
[English](../../README.md) | **简体中文**
|
|
6
6
|
|
|
7
7
|
## 内容
|
|
8
8
|
|
|
9
|
-
| 路径
|
|
10
|
-
|
|
11
|
-
|
|
|
12
|
-
|
|
|
9
|
+
| 路径 | 用途 |
|
|
10
|
+
|:---------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
11
|
+
| `../../assets/ZH_CN` | 六份治理文档（简体中文原文）：`HUMAN_AGENT_PARADIGM.md`（宪法 v1.0）、`DERIVED_SPECIFICATION.md`（派生规范 v1.0）、`CONFORMANCE_CHECKLIST.md`（符合性清单 v1.0）、`CONTRACT_TEMPLATE.md`、`DECISION_REQUEST_TEMPLATE.md`、`DELIVERY_REPORT_TEMPLATE.md` |
|
|
12
|
+
| `../../assets/EN` | 同一六份的官方英文译本 |
|
|
13
13
|
|
|
14
14
|
## 用法
|
|
15
15
|
|
|
16
|
-
消费方把 `
|
|
16
|
+
消费方把 `../../assets` 语言目录复制进各自工作区的治理根。独立使用。
|
|
17
17
|
|
|
18
18
|
## 版本策略
|
|
19
19
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hap-labs/human-agent-paradigm",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "Human-Agent Paradigm (HAP) content package: the Constitution, the Derived Specification, the Conformance Checklist, and the Contract / Decision-Request / Delivery-Report templates in Simplified Chinese (ZH_CN) and English (EN).",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -10,8 +10,8 @@
|
|
|
10
10
|
"files": [
|
|
11
11
|
"assets",
|
|
12
12
|
"README.md",
|
|
13
|
-
"README.
|
|
14
|
-
"CHANGELOG.md"
|
|
13
|
+
"docs/ZH_CN/README.md",
|
|
14
|
+
".github/CHANGELOG.md"
|
|
15
15
|
],
|
|
16
16
|
"publishConfig": {
|
|
17
17
|
"access": "public"
|
package/CHANGELOG.md
DELETED
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
# Translation Glossary — Governance Terms (EN ↔ Simplified Chinese)
|
|
2
|
-
|
|
3
|
-
> 简体中文版本：[TRANSLATION_GLOSSARY.md](../ZH_CN/TRANSLATION_GLOSSARY.md)
|
|
4
|
-
|
|
5
|
-
The unified basis for translating and reviewing the consistency of governance-layer documents (the six frozen documents
|
|
6
|
-
under `assets/` and their official translations, plus the process records they drive). Use the following correspondences
|
|
7
|
-
whenever translating or reviewing any governance material; any new row must state its rationale and keep the table
|
|
8
|
-
sorted by the English term.
|
|
9
|
-
|
|
10
|
-
| English | Chinese | Context / Notes |
|
|
11
|
-
|:----------------------------------|:-----------------------------------|:----------------------------------------------------------------------------------------|
|
|
12
|
-
| Human-Agent Paradigm (HAP) | 人机协作范式 / 人与 Agent 协作范式 | Proper noun; product name |
|
|
13
|
-
| constitution | 宪法 | Sole authoritative document: `assets/ZH_CN/HUMAN_AGENT_PARADIGM.md` |
|
|
14
|
-
| derived specification | 派生规范 | `DERIVED_SPECIFICATION` |
|
|
15
|
-
| conformance self-check checklist | 符合性自检清单 | `CONFORMANCE_CHECKLIST` |
|
|
16
|
-
| contract | 契约 | A signed C1–C10 contract |
|
|
17
|
-
| contract template | 契约模板 | `CONTRACT_TEMPLATE` |
|
|
18
|
-
| decision request | 决策请求 | `DECISION_REQUEST_TEMPLATE` (Part A) |
|
|
19
|
-
| necessary information request | 必要信息补全请求 | Same template (Part B) |
|
|
20
|
-
| delivery report | 交付报告 | `DELIVERY_REPORT_TEMPLATE` |
|
|
21
|
-
| Owner | 人（所有者）/ 所有者 | Also "the human"; not translated as "owner-company" |
|
|
22
|
-
| Agent | Agent | Full-responsibility company; keep "Agent" in Chinese |
|
|
23
|
-
| decision-maker | 决策者 | The human's role |
|
|
24
|
-
| mandatory file | 强制文件 | Records for phases P0–P7 |
|
|
25
|
-
| hard gate | 硬门 | A machine or human gate that blocks progress |
|
|
26
|
-
| record | 记录 | A process artifact, e.g. P0_intent.md |
|
|
27
|
-
| evidence | 证据 | Proof that can be independently verified |
|
|
28
|
-
| evidence package | 证据包 | The evidence set for delivery |
|
|
29
|
-
| multi-view review | 多视角审视 | The four perspectives listed below |
|
|
30
|
-
| product perspective | 产品视角 | P6 perspective term |
|
|
31
|
-
| user perspective | 用户视角 | P6 perspective term |
|
|
32
|
-
| engineering perspective | 工程视角 | P6 perspective term |
|
|
33
|
-
| adversarial review / perspective | 对抗性（审查）视角 | P6 perspective term |
|
|
34
|
-
| five excellence dimensions | 优秀五维度 | 6.1–6.5 (see below) |
|
|
35
|
-
| sound design | 设计合理 | Dimension 6.1 |
|
|
36
|
-
| complete functionality | 功能完备 | Dimension 6.2 |
|
|
37
|
-
| elegant implementation | 实现优雅 | Dimension 6.3 |
|
|
38
|
-
| perfect experience | 体验完美 | Dimension 6.4 |
|
|
39
|
-
| excellent performance | 性能优异 | Dimension 6.5 |
|
|
40
|
-
| autonomy budget | 自治预算 | Contract C7 |
|
|
41
|
-
| decision point | 决策点 | A process term |
|
|
42
|
-
| proposal | 提案 | Decision-ready material (P2) |
|
|
43
|
-
| intent | 意图 | The object of P0 |
|
|
44
|
-
| definition of done (DoD) | 完成定义 | Contract C4 |
|
|
45
|
-
| acceptance | 验收 | A P7 activity |
|
|
46
|
-
| owner signature / signing | 签署 | The user-language copy is authoritative |
|
|
47
|
-
| reliability | 可靠 | Hard requirement one |
|
|
48
|
-
| excellence | 优秀 | Hard requirement two |
|
|
49
|
-
| safety and compliance bottom line | 安全与合规底线 | Constitutional bottom line |
|
|
50
|
-
| assets | 资产 | Deposited reusable outcomes |
|
|
51
|
-
| product DNA | 产品 DNA | Deposited human preferences and values |
|
|
52
|
-
| run | run / 流程实例 | `.hap/runs/<run-id>/`; in Chinese records, use "run/流程实例", consistent with SKILL.md |
|
|
53
|
-
| governance root | 治理根 | The `.hap/` directory |
|
|
54
|
-
| bilingual pair | 双语成对 | User language (no suffix) |
|
|
55
|
-
|
|
56
|
-
## Rules
|
|
57
|
-
|
|
58
|
-
1. P0–P7, C1–C10, A1–A7…J1–J7, the ★ marker, and version strings are never translated.
|
|
59
|
-
2. Within a frozen document's body, a file-name reference points to the same-named file in the same language directory
|
|
60
|
-
(e.g. a reference inside `assets/EN/DERIVED_SPECIFICATION.md` to `HUMAN_AGENT_PARADIGM`); the lowercase canonical
|
|
61
|
-
file-name references embedded in the frozen Simplified Chinese original remain unchanged (the content is frozen and
|
|
62
|
-
must not be altered), and the tool copies them to `.hap/docs/` under their canonical lowercase names.
|
|
63
|
-
3. Existing English wording already published with code comments, the README (EN), and injected contract text takes
|
|
64
|
-
precedence (e.g. "hard requirement", "multi-view review", "owner-decision contract").
|
|
65
|
-
4. The bilingual copies of a record are written in the same round to state the same fact — facts and IDs must match,
|
|
66
|
-
while wording may adjust to each language; **the English copy is for the Agent to read and reason with (always read
|
|
67
|
-
record facts from `records/EN/`)**, and the Chinese copy is for the user (the Owner) to review, approve, and sign.
|
|
68
|
-
|
|
69
|
-
## Language directories and adding a language
|
|
70
|
-
|
|
71
|
-
Repository language documents are organized by language directory, language codes uppercase and composite codes
|
|
72
|
-
underscored: `assets/ZH_CN/` (frozen Simplified Chinese originals), `assets/EN/` (English translations), `docs/EN/`,
|
|
73
|
-
`docs/ZH_CN/` — files inside a directory use a plain `<NAME>.md` (uppercase + underscore, no language suffix).
|
|
74
|
-
|
|
75
|
-
Adding a language:
|
|
76
|
-
|
|
77
|
-
1. Create a same-named language directory under `assets/` (e.g. `JA/`; composite codes underscored), and translate the
|
|
78
|
-
documents into plain `<NAME>.md` files inside it;
|
|
79
|
-
2. Register it here in this glossary and in the README "Language rules" section before use.
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
# 翻译术语表 — 治理术语（EN ↔ 中文）
|
|
2
|
-
|
|
3
|
-
> English version: [TRANSLATION_GLOSSARY.md](../EN/TRANSLATION_GLOSSARY.md)
|
|
4
|
-
|
|
5
|
-
治理层文档（`assets/` 下六份冻结文档及其官方译本、以及由它们驱动的流程记录）翻译与一致性审校的统一基准。翻译或审校任何治理材料时使用下列对应关系；新增行须说明理由，并保持表格按英文术语排序。
|
|
6
|
-
|
|
7
|
-
| English | 中文 | 语境/备注 |
|
|
8
|
-
|:----------------------------------|:-----------------------------------|:---------------------------------------------------------------------|
|
|
9
|
-
| Human-Agent Paradigm (HAP) | 人机协作范式 / 人与 Agent 协作范式 | 专有名词；产品名 |
|
|
10
|
-
| constitution | 宪法 | 唯一权威文档：`assets/ZH_CN/HUMAN_AGENT_PARADIGM.md` |
|
|
11
|
-
| derived specification | 派生规范 | `DERIVED_SPECIFICATION` |
|
|
12
|
-
| conformance self-check checklist | 符合性自检清单 | `CONFORMANCE_CHECKLIST` |
|
|
13
|
-
| contract | 契约 | 已签署的 C1–C10 契约 |
|
|
14
|
-
| contract template | 契约模板 | `CONTRACT_TEMPLATE` |
|
|
15
|
-
| decision request | 决策请求 | `DECISION_REQUEST_TEMPLATE`（Part A） |
|
|
16
|
-
| necessary information request | 必要信息补全请求 | 同一模板（Part B） |
|
|
17
|
-
| delivery report | 交付报告 | `DELIVERY_REPORT_TEMPLATE` |
|
|
18
|
-
| Owner | 人（所有者）/ 所有者 | 也称 “the human”；不译作“owner-company” |
|
|
19
|
-
| Agent | Agent | 全责公司；中文语境保留 “Agent” |
|
|
20
|
-
| decision-maker | 决策者 | 人的角色 |
|
|
21
|
-
| mandatory file | 强制文件 | P0–P7 阶段记录 |
|
|
22
|
-
| hard gate | 硬门 | 阻止推进的机器或人工门禁 |
|
|
23
|
-
| record | 记录 | 流程产物，如 P0_intent.md |
|
|
24
|
-
| evidence | 证据 | 可独立复核的证明 |
|
|
25
|
-
| evidence package | 证据包 | 交付用证据集 |
|
|
26
|
-
| multi-view review | 多视角审视 | 下述四个视角 |
|
|
27
|
-
| product perspective | 产品视角 | P6 视角词 |
|
|
28
|
-
| user perspective | 用户视角 | P6 视角词 |
|
|
29
|
-
| engineering perspective | 工程视角 | P6 视角词 |
|
|
30
|
-
| adversarial review / perspective | 对抗性（审查）视角 | P6 视角词 |
|
|
31
|
-
| five excellence dimensions | 优秀五维度 | 6.1–6.5（见下） |
|
|
32
|
-
| sound design | 设计合理 | 维度 6.1 |
|
|
33
|
-
| complete functionality | 功能完备 | 维度 6.2 |
|
|
34
|
-
| elegant implementation | 实现优雅 | 维度 6.3 |
|
|
35
|
-
| perfect experience | 体验完美 | 维度 6.4 |
|
|
36
|
-
| excellent performance | 性能优异 | 维度 6.5 |
|
|
37
|
-
| autonomy budget | 自治预算 | 契约 C7 |
|
|
38
|
-
| decision point | 决策点 | 流程术语 |
|
|
39
|
-
| proposal | 提案 | 可决策材料（P2） |
|
|
40
|
-
| intent | 意图 | P0 对象 |
|
|
41
|
-
| definition of done (DoD) | 完成定义 | 契约 C4 |
|
|
42
|
-
| acceptance | 验收 | P7 活动 |
|
|
43
|
-
| owner signature / signing | 签署 | 以用户语言副本为准 |
|
|
44
|
-
| reliability | 可靠 | 硬性要求一 |
|
|
45
|
-
| excellence | 优秀 | 硬性要求二 |
|
|
46
|
-
| safety and compliance bottom line | 安全与合规底线 | 宪法底线 |
|
|
47
|
-
| assets | 资产 | 沉淀的可复用成果 |
|
|
48
|
-
| product DNA | 产品 DNA | 沉淀的人偏好与价值观 |
|
|
49
|
-
| run | run / 流程实例 | `.hap/runs/<run-id>/`；中文记录中与 SKILL.md 一致使用 “run/流程实例” |
|
|
50
|
-
| governance root | 治理根 | `.hap/` 目录 |
|
|
51
|
-
| bilingual pair | 双语成对 | 用户语言（无后缀） |
|
|
52
|
-
|
|
53
|
-
## 规则
|
|
54
|
-
|
|
55
|
-
1. P0–P7、C1–C10、A1–A7…J1–J7、★ 标记与版本串一律不翻译。
|
|
56
|
-
2. 冻结文档正文内的文件名引用指向同一语言目录下的同名文件（例如 `assets/EN/DERIVED_SPECIFICATION.md` 内引用
|
|
57
|
-
`HUMAN_AGENT_PARADIGM`）；冻结中文原文正文内嵌的规范小写文件名引用保持原样（内容冻结不可改），工具复制到 `.hap/docs/`
|
|
58
|
-
时使用规范小写名。
|
|
59
|
-
3. 已随代码注释、README（EN）与注入契约文本发布的既有英文措辞优先（如 “hard requirement”、“multi-view review”、“owner-decision
|
|
60
|
-
contract”）。
|
|
61
|
-
4. 记录的双语副本同轮书写同一事实——事实与 ID 必须一致，措辞可随语言调整； **英文副本供 Agent 读取与推理（Agent 读取记录事实一律读
|
|
62
|
-
`records/EN/`）**，中文副本供用户（所有者）审批阅读与签署。
|
|
63
|
-
|
|
64
|
-
## 语言目录与新增语言
|
|
65
|
-
|
|
66
|
-
仓库语言文档按语言分目录，语言码大写、复合码用下划线：`assets/ZH_CN/`（冻结中文原文）、`assets/EN/`（英文译本）、`docs/EN/`、
|
|
67
|
-
`docs/ZH_CN/`——目录内文件名为纯 `<NAME>.md`（大写+下划线连接，无语言后缀）。
|
|
68
|
-
|
|
69
|
-
新增语言：
|
|
70
|
-
|
|
71
|
-
1. 在 `assets/` 下建立同名语言目录（如 `JA/`；复合码用下划线），把文档译为目录内纯 `<NAME>.md`；
|
|
72
|
-
2. 使用前在本术语表与 README「语言规则」节登记。
|