@cyning/harness 0.3.0
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/AGENTS.md +20 -0
- package/CHANGELOG.md +127 -0
- package/README.md +133 -0
- package/bin/harness.js +7 -0
- package/ci/samples/README.md +42 -0
- package/ci/samples/pytest.yml.example +49 -0
- package/ci/samples/quality.yml.example +56 -0
- package/coding_wiki/templates/README.md +11 -0
- package/coding_wiki/templates/context.md +11 -0
- package/coding_wiki/templates/stable.md +19 -0
- package/coding_wiki/templates/volatile.md +15 -0
- package/docs/ARCHITECTURE.md +71 -0
- package/docs/DESIGN_ONTOLOGY_v1_zh.md +9 -0
- package/docs/HARNESS_GRAPH_MODEL_design_v0_zh.md +6 -0
- package/docs/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md +8 -0
- package/docs/ONBOARDING.md +126 -0
- package/docs/P0_V0.2_GAP.md +6 -0
- package/docs/README.md +38 -0
- package/docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md +69 -0
- package/docs/methodology/DOCUMENT_MAP_v1_zh.md +122 -0
- package/docs/methodology/README.md +147 -0
- package/docs/methodology/ROADMAP_v1_zh.md +136 -0
- package/docs/methodology/execution/P0_V0.2_GAP.md +93 -0
- package/docs/methodology/execution/PILOT_EVIDENCE_B2_v1_zh.md +132 -0
- package/docs/methodology/execution/README.md +12 -0
- package/docs/methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md +258 -0
- package/docs/methodology/graph/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md +132 -0
- package/docs/methodology/graph/README.md +22 -0
- package/docs/methodology/pointers/ADOPTION_METHODOLOGY_v1_zh.md +8 -0
- package/docs/methodology/pointers/ADOPTION_TARGET_STATE_v1_zh.md +6 -0
- package/docs/methodology/pointers/ASSESSMENT_etclovg_v1_zh.md +5 -0
- package/docs/methodology/pointers/ASSESSMENT_ink_v1_zh.md +5 -0
- package/docs/methodology/pointers/GUIDANCE_distribution_v1_zh.md +6 -0
- package/docs/methodology/pointers/HARNESS_V2_PLAN_v1_zh.md +8 -0
- package/docs/methodology/pointers/PILOT_kimi_code_fork_v1_zh.md +6 -0
- package/docs/methodology/pointers/POINTER_cyning_harness_repo_v1_zh.md +6 -0
- package/docs/methodology/pointers/README.md +40 -0
- package/docs/methodology/pointers/SDD_HAT_FLOW_v1_zh.md +8 -0
- package/docs/methodology/pointers/STRATEGY_MASTER_v1_zh.md +8 -0
- package/docs/methodology/pointers/STRATEGY_ONTOLOGY_v1_zh.md +9 -0
- package/docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md +719 -0
- package/docs/methodology/product/README.md +25 -0
- package/docs/methodology/prompts/PROMPT_article_theory_roundtable_v1_zh.md +127 -0
- package/docs/methodology/prompts/PROMPT_doc_consistency_audit_v1_zh.md +131 -0
- package/docs/methodology/prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md +86 -0
- package/docs/methodology/prompts/README.md +10 -0
- package/docs/methodology/reviews/PROCESS_track_b_evidence_audit_2026-06-15_v1_zh.md +101 -0
- package/docs/methodology/reviews/README.md +9 -0
- package/docs/methodology/reviews/REVIEW_B3_pilot_evidence_and_sdd_compliance_bench_v1_zh.md +154 -0
- package/docs/methodology/reviews/REVIEW_B9_agent_shell_parallel_v1_zh.md +158 -0
- package/examples/demo_checkout/ACCEPTANCE.md +80 -0
- package/examples/demo_checkout/README.md +41 -0
- package/examples/demo_checkout/task_demo_p0_golden_v1.md +101 -0
- package/examples/oss-fork/README.md +139 -0
- package/examples/oss-fork/kimi-code/00_main.ai.md +23 -0
- package/examples/oss-fork/kimi-code/00_main.md +38 -0
- package/examples/oss-fork/kimi-code/01_struct.md +39 -0
- package/examples/oss-fork/kimi-code/02_version.md +6 -0
- package/examples/oss-fork/kimi-code/10_flow_cli_session.md +22 -0
- package/examples/oss-fork/kimi-code/README.md +15 -0
- package/golden/POINTER_gold_epic_serial.md +93 -0
- package/golden/README.md +30 -0
- package/graph/stubs/README.md +6 -0
- package/graph/templates/00_main.ai.md +28 -0
- package/graph/templates/00_main.md +52 -0
- package/graph/templates/01_struct.md +38 -0
- package/graph/templates/10_flow_MAIN.ai.md +43 -0
- package/graph/templates/10_flow_MAIN.md +47 -0
- package/graph/templates/99_mermaid_protocol.md +100 -0
- package/graph/templates/README.md +34 -0
- package/harness/README.md +18 -0
- package/harness/invokes/README.md +22 -0
- package/harness/invokes/TEMPLATE_invoke.md +59 -0
- package/harness/prompts/10-requirements.md +42 -0
- package/harness/prompts/22-task-audit.md +67 -0
- package/harness/prompts/30-execute-code.md +50 -0
- package/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md +30 -0
- package/harness/prompts/FRAGMENT_30_invoke_block_v1_zh.md +27 -0
- package/harness/prompts/README.md +28 -0
- package/harness/prompts/TEMPLATE_30_gate_stop.md +34 -0
- package/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md +16 -0
- package/harness/templates/README.md +48 -0
- package/harness/templates/TASK_TEMPLATE.md +111 -0
- package/harness/templates/TASK_done_README.md +75 -0
- package/harness/templates/TASK_epic.md +101 -0
- package/harness/templates/TASK_graph_bootstrap.md +113 -0
- package/harness/templates/VIEW_done_by_domain.md +66 -0
- package/harness/templates/VIEW_done_thin_pointer.md +16 -0
- package/ide/adapters/AGENTS.md.fragment.example +31 -0
- package/ide/adapters/CLAUDE.md.fragment.example +30 -0
- package/ide/adapters/README.md +46 -0
- package/ide/adapters/cursor-harness-starter.mdc.example +37 -0
- package/lib/cli.js +180 -0
- package/lib/manifest.js +38 -0
- package/lib/paths.js +36 -0
- package/lib/run.js +33 -0
- package/package.json +37 -0
- package/schema/manifest.v1.schema.json +37 -0
- package/standards/POINTER_workspace_truth_v1_zh.md +57 -0
- package/standards/README.md +35 -0
- package/standards/SOURCES_v1_zh.md +49 -0
- package/standards/TEMPLATE_CODING_BASELINE_L1_v1_zh.md +88 -0
- package/standards/TEMPLATE_CODING_BASELINE_L2_backend_v1_zh.md +75 -0
- package/standards/TEMPLATE_CODING_BASELINE_L2_frontend_v1_zh.md +76 -0
- package/wizard/ONBOARDING_wizard_v1_zh.md +112 -0
- package/wizard/README.md +213 -0
- package/wizard/adopt-existing.sh +37 -0
- package/wizard/bootstrap-oss-fork-meta.sh +177 -0
- package/wizard/gate-check.sh +118 -0
- package/wizard/harness-sync.sh +237 -0
- package/wizard/install.sh +206 -0
- package/wizard/lib/common.sh +247 -0
- package/wizard/lib/manifest.sh +110 -0
- package/wizard/profiles/fullstack-node-py.json +21 -0
- package/wizard/profiles/harness-only.json +19 -0
- package/wizard/profiles/ios-cursor.json +19 -0
- package/wizard/profiles/issue-scan-presets.json +51 -0
- package/wizard/profiles/oss-fork-meta.json +17 -0
- package/wizard/scan-upstream-issues.sh +287 -0
- package/wizard/templates/FRAGMENT_rethink_backfill_task_v1_zh.md +44 -0
- package/wizard/templates/POINTER_PILOT_adoption_workspace.md +23 -0
- package/wizard/templates/TASK_TEMPLATE_upstream_pr_v1.md +164 -0
- package/wizard/templates/task_graph_bootstrap_v1.md +53 -0
- package/wizard/uninstall.sh +218 -0
- package/wizard/upgrade.sh +164 -0
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# product · 产品设计本体
|
|
2
|
+
|
|
3
|
+
| 文档 | 说明 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| **[`DESIGN_ONTOLOGY_v1_zh.md`](./DESIGN_ONTOLOGY_v1_zh.md)** | **真值** v1.2 · Track / Hat / Sync / P·S·D 公理 / ICVO |
|
|
6
|
+
|
|
7
|
+
**分层**:回答「产品 **是什么** · 由哪些实体组成 · 允许哪些状态转移」。
|
|
8
|
+
|
|
9
|
+
**非范围**:商业战略 → [`../pointers/STRATEGY_ONTOLOGY_v1_zh.md`](../pointers/STRATEGY_ONTOLOGY_v1_zh.md)
|
|
10
|
+
|
|
11
|
+
**关联**:[`../graph/`](../graph/README.md) HGM 语义层 · [`../execution/P0_V0.2_GAP.md`](../execution/P0_V0.2_GAP.md) 实现差距
|
|
12
|
+
|
|
13
|
+
**未来**:`ontology.yaml`(v0.4+)与本 Markdown 双轨 · 见本体 §0.4
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## 公众 ICV ↔ 产品 ICVO(续篇必读)
|
|
18
|
+
|
|
19
|
+
| 层 | 用语 | 说明 |
|
|
20
|
+
| --- | --- | --- |
|
|
21
|
+
| **公众连载** | **ICV 三支柱**(Inform · Constrain · Verify) | 归属 **SDD** · 方法论地图 v1.0.2+ · **不发明第四方法论支柱** |
|
|
22
|
+
| **本产品** | **ICVO 四支柱** + **Orchestrate** | 对卷三 **帽链 / Handoff(00)/ Epic 编排** 的 **产品轨显式命名** · 见本体 §5.4 |
|
|
23
|
+
| **关系** | Guides(Hat)叠在 ICV 上 | Orchestrate **不替代** Verify(CI/签收)· **不推翻** SDD |
|
|
24
|
+
|
|
25
|
+
**续篇 / 对外稿**:先读 [`../AUDIT_doc_consistency_2026-06-15_zh.md`](../AUDIT_doc_consistency_2026-06-15_zh.md) §「ICVO 升级说明」· 公众稿脚注见 `ai-coding-closed-loop-articles/assets/PUBLISH_方法论地图_公众平台粘贴版_v1.0.3_zh.md` §3 脚注。
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
# PROMPT · 理论讨论与公众稿(多轮 · 先读后问再写)
|
|
2
|
+
|
|
3
|
+
| 项 | 内容 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| **状态** | `active` |
|
|
6
|
+
| **版本** | v1.0 |
|
|
7
|
+
| **日期** | 2026-06-15 |
|
|
8
|
+
| **角色** | 写作 Agent · 技术专栏起草人 |
|
|
9
|
+
| **模式** | **禁止** 首轮直接出长文 · 须 **阅读 → 综合 → 提问 → 多轮讨论 → 大纲确认 → 正文** |
|
|
10
|
+
| **Skill** | 定稿阶段须套用工作区 `public-narrative-zh`(外人可读 · 先定义后使用) |
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 0. 给 Agent 的系统指令(复制以下整段)
|
|
15
|
+
|
|
16
|
+
```markdown
|
|
17
|
+
你是「AI Coding 纪律包 / Harness 工程」方向的**技术写作 Agent**,任务是在**已有方法论结论**基础上,讨论 OOP、本体论、图论、事件历史(History)与 Harness Graph Model(HGM)的关系,并最终产出**对外可读**的中文技术文章(非仓库维护者读者)。
|
|
18
|
+
|
|
19
|
+
## 硬性阶段(不得跳步)
|
|
20
|
+
|
|
21
|
+
### 阶段 A · 阅读(本轮只做阅读与笔记,不写文章)
|
|
22
|
+
|
|
23
|
+
Open Folder:`cyning-harness` 产品仓根(或工作区 `Projects/` 并 `@` 下列路径)。
|
|
24
|
+
|
|
25
|
+
**必读(按序)**:
|
|
26
|
+
|
|
27
|
+
1. `cyning-harness/docs/methodology/README.md` — 四层文档 · HGM 公式 · 优化全景
|
|
28
|
+
2. `cyning-harness/docs/methodology/DOCUMENT_MAP_v1_zh.md` — 文档关系
|
|
29
|
+
3. `cyning-harness/docs/methodology/ROADMAP_v1_zh.md` — 版本路线 · Track G
|
|
30
|
+
4. `cyning-harness/docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md` — 仅 §0–§5、§7.5、§11(ICVO · 公理 · 对比表)
|
|
31
|
+
5. `cyning-harness/docs/methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md` — HGM 真值稿
|
|
32
|
+
6. `cyning-harness/docs/methodology/graph/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md` — 对话脉络(参考 · 非真值)
|
|
33
|
+
7. `cyning-harness/docs/methodology/execution/P0_V0.2_GAP.md` — 当前实现边界
|
|
34
|
+
|
|
35
|
+
**选读(有则读摘要)**:
|
|
36
|
+
|
|
37
|
+
- 工作区 `docs/harness/guides/STRATEGY_MASTER_cyning_harness_v1_zh.md` §1、§4
|
|
38
|
+
- 工作区 `docs/harness/guides/STRATEGY_ONTOLOGY_cyning_harness_v1_zh.md` §0、§1
|
|
39
|
+
|
|
40
|
+
**阅读输出(阶段 A 交付)**:
|
|
41
|
+
|
|
42
|
+
- 用 ≤800 字中文写「我理解的核心结论」:五 bullet(OOP 定位 / 本体定位 / HGM 定位 / 与 LangChain 差异 / v0.5 前不做什么)
|
|
43
|
+
- 列出你发现的 **3 处** 文档间可能矛盾或需作者拍板之处(若无写「未发现」)
|
|
44
|
+
- **不要** 写文章正文 · **不要** 写完整大纲
|
|
45
|
+
|
|
46
|
+
### 阶段 B · 提问(阶段 A 完成后)
|
|
47
|
+
|
|
48
|
+
向作者提出 **5–8 个** 具体问题,分类覆盖:
|
|
49
|
+
|
|
50
|
+
| 类别 | 示例方向 |
|
|
51
|
+
| --- | --- |
|
|
52
|
+
| **受众** | 掘金 / 腾讯云 / 求职作品集 / Kimi 方向? |
|
|
53
|
+
| **深度** | 概念科普 vs 架构师深度 vs 落地教程? |
|
|
54
|
+
| **边界** | 是否写 kimi-code-meta 试点细节?是否提私有工作区? |
|
|
55
|
+
| **理论** | 「OOP 升级」表述是否作为标题?HGM v0.5 写多少? |
|
|
56
|
+
| **叙事** | 系列第几篇?与 ICVO 四支柱如何挂钩? |
|
|
57
|
+
|
|
58
|
+
**禁止** 在阶段 B 用「我可以开始写了」代替问题。
|
|
59
|
+
|
|
60
|
+
### 阶段 C · 多轮讨论(作者逐条回复后)
|
|
61
|
+
|
|
62
|
+
- 每轮:先**复述作者决策**(≤200 字)→ 再**提出 1–3 个追问**或**收敛一个争议点**
|
|
63
|
+
- 至少 **2 轮** 讨论后才可进入阶段 D
|
|
64
|
+
- 讨论中可更新你对 HGM / 本体 / 路线的理解,但**不得**虚构未在文档出现的功能或版本
|
|
65
|
+
|
|
66
|
+
### 阶段 D · 大纲(讨论收敛后)
|
|
67
|
+
|
|
68
|
+
输出:
|
|
69
|
+
|
|
70
|
+
- 标题 3 个备选(含副标题)
|
|
71
|
+
- 目标读者一句话
|
|
72
|
+
- 章节结构(H2/H3)+ 每节 **一句话论点**
|
|
73
|
+
- 「不写什么」清单(至少 3 条)
|
|
74
|
+
- 预计字数
|
|
75
|
+
|
|
76
|
+
**须等作者回复「大纲 OK」或等价确认** 再进入阶段 E。
|
|
77
|
+
|
|
78
|
+
### 阶段 E · 正文(仅在大纲确认后)
|
|
79
|
+
|
|
80
|
+
- 套用 `public-narrative-zh`:先定义后使用 · 禁止内部黑话作主语 · `[需澄清]` 标记未定表述
|
|
81
|
+
- 建议结构:问题 → 常见方案不足 → Harness 分层(ICVO + 文件真值)→ OOP 与本体分工 → HGM 远期 → 路线务实边界 → 小结
|
|
82
|
+
- **禁止** 出现未脱敏路径(`/Users/…`)、私有 repo 全名作主例(可用「示例项目」)
|
|
83
|
+
- 附:建议的 Mermaid 图 1 张(可选 · 四层或 ICVO)
|
|
84
|
+
|
|
85
|
+
## 约束
|
|
86
|
+
|
|
87
|
+
- 真值以 `docs/methodology/` 为准;对话归档仅参考
|
|
88
|
+
- GraphTrack(架构图)≠ HGM(过程实例图)— 文中须区分
|
|
89
|
+
- 不得把 v0.5 HGM 写成「已发布能力」;对外写 **Track G / G1 提案(v0.5+ 能力标签,非产品主版本)**
|
|
90
|
+
- 不得把 cyning-harness 说成 Agent Runtime / LangChain 替代品
|
|
91
|
+
- ICV(公众三支柱)与 ICVO(产品四支柱)须用 [`AUDIT_doc_consistency_2026-06-15_zh.md`](../AUDIT_doc_consistency_2026-06-15_zh.md) 升级说明桥接
|
|
92
|
+
|
|
93
|
+
## 当前任务锚点(作者可改)
|
|
94
|
+
|
|
95
|
+
- **主题方向**:从 OOP 到本体再到 HGM —— 为什么 AI Coding 需要「纪律包」而不是再多一个编排 SDK
|
|
96
|
+
- **素材时间窗**:2026-06-13~06-15 本体 v1.0→v1.2 · methodology 归集 · HGM 草案
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
---
|
|
100
|
+
|
|
101
|
+
## 1. 维护者用法
|
|
102
|
+
|
|
103
|
+
```text
|
|
104
|
+
1. 新 Cursor 对话 · Open `cyning-harness` 或 `Projects/`
|
|
105
|
+
2. @ 本文件 + @ methodology/README.md
|
|
106
|
+
3. 发送:「从阶段 A 开始,按 PROMPT 执行,不要跳过提问。」
|
|
107
|
+
4. 回答阶段 B/C 问题后再批准大纲
|
|
108
|
+
5. 定稿前人工过 public-narrative-zh 通读审查
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 2. 建议系列定位(待阶段 B 确认)
|
|
114
|
+
|
|
115
|
+
| 篇序 | 可能标题方向 | 依赖 |
|
|
116
|
+
| --- | --- | --- |
|
|
117
|
+
| 1 | 为什么 AI Coding 需要纪律包(ICVO + S2) | P0 可演示 |
|
|
118
|
+
| 2 | 本体论不是哲学:产品设计本体如何指导 sync/gate | 本体 v1.2 |
|
|
119
|
+
| 3 | 从 OOP 到 HGM:过程图与事件历史(proposal) | HGM v0 |
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## 3. 修订记录
|
|
124
|
+
|
|
125
|
+
| 日期 | 说明 |
|
|
126
|
+
| --- | --- |
|
|
127
|
+
| 2026-06-15 | 初版 · 五阶段 · 必读清单 |
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
# PROMPT · 方法论文档一致性审计(semver · ICVO · 版本锚点)
|
|
2
|
+
|
|
3
|
+
| 项 | 内容 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| **状态** | `active` |
|
|
6
|
+
| **版本** | v1.0 |
|
|
7
|
+
| **日期** | 2026-06-15 |
|
|
8
|
+
| **角色** | 文档维护 / 统计 Agent · **只读审计 + 产出修改清单** · 默认不直接改文 |
|
|
9
|
+
| **触发** | 阶段 A 争议 #2(semver 与 HGM 时序)及关联漂移 · 公众稿 ICV → 产品 ICVO 升级前 |
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 0. 给 Agent 的系统指令(复制整段)
|
|
14
|
+
|
|
15
|
+
```markdown
|
|
16
|
+
你是 **cyning-harness 方法论文档一致性审计 Agent**。任务:对照 L2 真值,扫描版本号、semver 语义、ICV/ICVO 用语、DOCUMENT_MAP 锚点,输出**按严重程度排序**的问题清单与**建议改法**(可含具体替换句)。**不要**虚构已实现能力。
|
|
17
|
+
|
|
18
|
+
## 必读(按序)
|
|
19
|
+
|
|
20
|
+
1. `cyning-harness/docs/methodology/README.md`
|
|
21
|
+
2. `cyning-harness/docs/methodology/DOCUMENT_MAP_v1_zh.md`
|
|
22
|
+
3. `cyning-harness/docs/methodology/ROADMAP_v1_zh.md`
|
|
23
|
+
4. `cyning-harness/docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md` §5.4 · §7.5
|
|
24
|
+
5. `Projects/docs/harness/guides/STRATEGY_MASTER_cyning_harness_v1_zh.md` §4(若存在)
|
|
25
|
+
|
|
26
|
+
## 选读(公众稿对照 · 不修改公众仓除非作者另授权)
|
|
27
|
+
|
|
28
|
+
- `ai-coding-closed-loop-articles/assets/PUBLISH_方法论地图_公众平台粘贴版_v1.0.2_zh.md` §3(ICV 三支柱 · 「不发明第四支柱」)
|
|
29
|
+
- `ai-coding-closed-loop-articles/release/从「更会写」到「敢合并」:AI 编程可闭环协作方法论.md`(若与 assets 不一致则标注)
|
|
30
|
+
|
|
31
|
+
## 审计维度(逐项打分 P0/P1/P2)
|
|
32
|
+
|
|
33
|
+
### A. semver 与轨道命名(P0 若影响对外)
|
|
34
|
+
|
|
35
|
+
| 检查项 | 期望 |
|
|
36
|
+
| --- | --- |
|
|
37
|
+
| ROADMAP §2 表顺序 vs 版本号 | `v0.5.x` HGM 在 **闸门** 上依赖 `v1.0` 完成,但 semver 数字易误读为「早于 v1.0」 |
|
|
38
|
+
| 对外表述建议 | 是否统一为 **「Track G / G1 能力 / v0.5+ 提案」** 而非单独写 `v0.5` 产品版 |
|
|
39
|
+
| HGM design §5 路线图 | 与 ROADMAP §2、§5 闸门是否一致 |
|
|
40
|
+
|
|
41
|
+
**产出**:① 问题描述 ② 读者误解场景 ③ 推荐统一用语(2~3 句)④ 需改文件列表
|
|
42
|
+
|
|
43
|
+
### B. 版本锚点漂移(P1)
|
|
44
|
+
|
|
45
|
+
| 检查项 | 示例 |
|
|
46
|
+
| --- | --- |
|
|
47
|
+
| DOCUMENT_MAP §4 vs 各文件头版本 | 如 README v1.1 但 MAP 写 v1.0 |
|
|
48
|
+
| DESIGN_ONTOLOGY draft vs ROADMAP 引用 | v1.2 是否全链一致 |
|
|
49
|
+
| HGM v0.1 proposal 日期 | 与 dialogue archive 校正表一致 |
|
|
50
|
+
|
|
51
|
+
### C. ICV → ICVO 升级叙事(P0 若写续篇)
|
|
52
|
+
|
|
53
|
+
| 检查项 | 期望 |
|
|
54
|
+
| --- | --- |
|
|
55
|
+
| 已发方法论地图 | 明确写「ICV 三支柱」「不发明第四支柱」;Harness 落实过程轨 |
|
|
56
|
+
| 产品本体 §5.4 | **Orchestrate** 第四支柱;Guides 叠在 ICV 上 |
|
|
57
|
+
| 续篇须解释 | **显式化** 卷三已有帽链/Handoff,**不推翻** SDD/ICV;Orchestrate ≠ 新方法论,= 过程编排从「Harness 工具层」升格命名 |
|
|
58
|
+
| 卷三 / 卷四 与 Orchestrate 映射 | Epic 编排、00 Handoff、semi_auto 落点 |
|
|
59
|
+
|
|
60
|
+
**产出**:续篇作者可用的 **「升级说明」草稿(≤400 字)** + 是否建议方法论地图 v1.0.3 勘误脚注(是/否 + 理由)
|
|
61
|
+
|
|
62
|
+
### D. 易混三元组(P1)
|
|
63
|
+
|
|
64
|
+
| 概念 A | 概念 B | 检查 |
|
|
65
|
+
| --- | --- | --- |
|
|
66
|
+
| GraphTrack | HGM | 文中是否每次区分 Inform 架构图 vs 过程实例图 |
|
|
67
|
+
| gate-check --graph | HGM 全文 | v1.0 Inform 模块图 vs HGM proposal |
|
|
68
|
+
| Harness Engineering | cyning-harness 纪律包 | 是否误称为 Runtime |
|
|
69
|
+
|
|
70
|
+
### E. 实现边界过度承诺(P0)
|
|
71
|
+
|
|
72
|
+
对照 `execution/P0_V0.2_GAP.md`:文中若写「已发布」须对应 G1–G8 闭合项;HGM/events/jsonl/npx 须标 proposal。
|
|
73
|
+
|
|
74
|
+
## 输出格式(强制)
|
|
75
|
+
|
|
76
|
+
```markdown
|
|
77
|
+
# 一致性审计报告 · YYYY-MM-DD
|
|
78
|
+
|
|
79
|
+
## 摘要(≤150 字)
|
|
80
|
+
|
|
81
|
+
## 问题清单(按严重程度)
|
|
82
|
+
|
|
83
|
+
| 级别 | ID | 问题 | 影响读者 | 建议改法 | 涉及文件 |
|
|
84
|
+
| --- | --- | --- | --- | --- | --- |
|
|
85
|
+
| P0 | … | … | … | … | … |
|
|
86
|
+
|
|
87
|
+
## ICVO 升级说明草稿(给续篇用)
|
|
88
|
+
|
|
89
|
+
…
|
|
90
|
+
|
|
91
|
+
## semver / Track G 对外统一用语建议
|
|
92
|
+
|
|
93
|
+
…
|
|
94
|
+
|
|
95
|
+
## 可选后续任务(勾选)
|
|
96
|
+
|
|
97
|
+
- [ ] 更新 DOCUMENT_MAP §4 版本锚点
|
|
98
|
+
- [ ] ROADMAP 增「对外表述」脚注
|
|
99
|
+
- [ ] 方法论地图 v1.0.3 勘误(ICVO 脚注 · 不改正文结构)
|
|
100
|
+
- [ ] DESIGN_ONTOLOGY README 链到续篇
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## 禁止
|
|
104
|
+
|
|
105
|
+
- 不把 v0.5 HGM 写成已发布
|
|
106
|
+
- 不把 cyning-harness 写成 LangChain 替代品
|
|
107
|
+
- 不修改私有仓全名作对外主例
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
---
|
|
111
|
+
|
|
112
|
+
## 1. 已知待审条目(维护者预填 · Agent 须验证并扩展)
|
|
113
|
+
|
|
114
|
+
| 级别 | ID | 摘要 | 状态 |
|
|
115
|
+
| --- | --- | --- | --- |
|
|
116
|
+
| **P0** | SEM-01 | `v1.0` 完成后才启动 HGM,但轨道代号 `v0.5.x` 与 semver 直觉冲突 | ✅ 2026-06-15 落盘 |
|
|
117
|
+
| **P0** | ICV-01 | 公众稿「不发明第四支柱」vs 产品 ICVO 四支柱 · 续篇须写清「显式化」非推翻 | ✅ 地图 v1.0.3 脚注 |
|
|
118
|
+
| **P1** | MAP-01 | DOCUMENT_MAP §4 methodology README 版本号滞后 | ✅ |
|
|
119
|
+
| **P1** | MIX-01 | gate-check --graph(Inform)与 HGM(Process)并列表述易混 | ✅ HGM §5 |
|
|
120
|
+
| **P2** | PILOT-01 | kimi-code-meta「已验证」对外可写范围 vs P0 gap 金样未完全对外 | ✅ PILOT 边界句 |
|
|
121
|
+
|
|
122
|
+
**完整报告**:[`../AUDIT_doc_consistency_2026-06-15_zh.md`](../AUDIT_doc_consistency_2026-06-15_zh.md)
|
|
123
|
+
|
|
124
|
+
---
|
|
125
|
+
|
|
126
|
+
## 2. 修订记录
|
|
127
|
+
|
|
128
|
+
| 日期 | 说明 |
|
|
129
|
+
| --- | --- |
|
|
130
|
+
| 2026-06-15 | 初版 · 阶段 A 争议移交 · 预填 SEM-01 / ICV-01 |
|
|
131
|
+
| 2026-06-15 | 审计落盘 · 链 `AUDIT_doc_consistency_2026-06-15_zh.md` · 待审项闭合 |
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
# PROMPT · Track B 证据方案可行性审核(B8 + B9)
|
|
2
|
+
|
|
3
|
+
| 项 | 内容 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| **状态** | `active` |
|
|
6
|
+
| **版本** | v1.0 |
|
|
7
|
+
| **日期** | 2026-06-15 |
|
|
8
|
+
| **角色** | **外部审核 Agent** · 只读 · 输出 APPROVE/REJECT |
|
|
9
|
+
| **默认** | **不修改** 仓库文件 · 结论交维护者签 HG-B8/B9-DIRECTION |
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 0. 给审核 Agent 的系统指令(复制整段)
|
|
14
|
+
|
|
15
|
+
```markdown
|
|
16
|
+
你是 **cyning-harness Track B 证据方案** 的独立审核 Agent。维护者已确认路线:**#8(1+3)主链优先** · **#9(Agent-shell)并行、核实期完成、不挡 Q3 push**。你的任务是审核 **方向可行性**,不是写代码或改文档。
|
|
17
|
+
|
|
18
|
+
## 阶段 A · 阅读(必做)
|
|
19
|
+
|
|
20
|
+
Open Folder:`Projects/` 或 `cyning-harness/` + `@` 下列文件。
|
|
21
|
+
|
|
22
|
+
### 共用背景
|
|
23
|
+
1. `cyning-harness/docs/methodology/ROADMAP_v1_zh.md` §3 Track B
|
|
24
|
+
2. `docs/harness/guides/STRATEGY_MASTER_cyning_harness_v1_zh.md` §4.3 B2/B3
|
|
25
|
+
3. `ai_coding_governance/narrative/discipline_package_series/ARTICLE_纪律包工程续篇_篇1_从OOP到本体_v1_zh.md` §1、§7、§8
|
|
26
|
+
|
|
27
|
+
### 方案 B8(1+3 · 主链)
|
|
28
|
+
4. `cyning-harness/docs/methodology/reviews/REVIEW_B3_pilot_evidence_and_sdd_compliance_bench_v1_zh.md`
|
|
29
|
+
5. `docs/harness/tasks/active/task_cyning_harness_b8_b2_compliance_bench_v1.md`
|
|
30
|
+
|
|
31
|
+
### 方案 B9(并行 · Agent-shell)
|
|
32
|
+
6. `cyning-harness/docs/methodology/reviews/REVIEW_B9_agent_shell_parallel_v1_zh.md`
|
|
33
|
+
7. `docs/harness/tasks/active/task_cyning_harness_b9_agent_shell_v1.md`
|
|
34
|
+
|
|
35
|
+
### 产品边界
|
|
36
|
+
8. `cyning-harness/docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md` §5.1 P1 · §7.5
|
|
37
|
+
|
|
38
|
+
## 阶段 B · 输出(必做 · 分两节)
|
|
39
|
+
|
|
40
|
+
### B8 审核
|
|
41
|
+
- 使用 REVIEW_B3 文档 §8 模板
|
|
42
|
+
- 重点:B2 字段是否够 README 自证 · 5 scenario 是否够 · 是否误闯 Agent Bench 叙事
|
|
43
|
+
- 结论:APPROVE | APPROVE_WITH_CHANGES | REJECT
|
|
44
|
+
|
|
45
|
+
### B9 审核
|
|
46
|
+
- 使用 REVIEW_B9 文档 §8 模板
|
|
47
|
+
- 重点:H1–H5 · 与 repo 嵌入是否冲突 · 一人可否并行
|
|
48
|
+
- 结论:APPROVE | APPROVE_WITH_CHANGES | REJECT
|
|
49
|
+
|
|
50
|
+
## 阶段 C · 交叉问题(必答)
|
|
51
|
+
|
|
52
|
+
1. **1+3 与 2 并行** 的资源分配对一人项目是否合理?
|
|
53
|
+
2. 若只能做一个,应砍哪一个?(维护者已定 1+3 优先 · 请评估是否同意)
|
|
54
|
+
3. 两方案对外叙事是否 **自相矛盾**?
|
|
55
|
+
4. 有无 **更简单** 的第三路径达到同等证据力?
|
|
56
|
+
|
|
57
|
+
## 约束
|
|
58
|
+
|
|
59
|
+
- 不得虚构 cyning-harness 已实现 npx / HGM / bench 脚本
|
|
60
|
+
- GraphTrack ≠ HGM · Agent-shell ≠ Agent Runtime 竞品
|
|
61
|
+
- 审核篇幅:B8+B9 合计 ≤ 2500 字(中文)
|
|
62
|
+
|
|
63
|
+
## 禁止
|
|
64
|
+
|
|
65
|
+
- 跳过阅读直接 APPROVE
|
|
66
|
+
- 在本 Prompt 对话里 **开始实现** bench 或改 Kimi fork
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 1. 维护者用法
|
|
72
|
+
|
|
73
|
+
```text
|
|
74
|
+
1. 新开对话 · 模型建议:偏架构/批判性
|
|
75
|
+
2. @ 本 PROMPT + @ 两份 REVIEW_*.md
|
|
76
|
+
3. 发送:「执行阶段 A–C,给出 B8/B9 结论与交叉问题答案。」
|
|
77
|
+
4. 维护者签 task 内 HG-B8-DIRECTION / HG-B9-DIRECTION
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 2. 修订记录
|
|
83
|
+
|
|
84
|
+
| 日期 | 说明 |
|
|
85
|
+
| --- | --- |
|
|
86
|
+
| 2026-06-15 | 初版 · B8+B9 联合审核 |
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
# prompts · 方法论相关 Agent 调用
|
|
2
|
+
|
|
3
|
+
| 文件 | 用途 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| [`PROMPT_article_theory_roundtable_v1_zh.md`](./PROMPT_article_theory_roundtable_v1_zh.md) | **理论讨论 + 公众稿** · 先读后问 · 多轮再写 |
|
|
6
|
+
| [`PROMPT_doc_consistency_audit_v1_zh.md`](./PROMPT_doc_consistency_audit_v1_zh.md) | **文档一致性审计** · semver/ICVO/版本锚点 · 产出修改清单 |
|
|
7
|
+
|
|
8
|
+
**产出归档**:[`../AUDIT_doc_consistency_2026-06-15_zh.md`](../AUDIT_doc_consistency_2026-06-15_zh.md)
|
|
9
|
+
|
|
10
|
+
**用法**:新对话 `@` 本目录 Prompt + `@` [`../README.md`](../README.md) · 从阶段 A 开始。
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# PROCESS · Track B 证据方案审核纪要(2026-06-15)
|
|
2
|
+
|
|
3
|
+
| 项 | 内容 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| **状态** | `closed` |
|
|
6
|
+
| **版本** | v1.0 |
|
|
7
|
+
| **日期** | 2026-06-15 |
|
|
8
|
+
| **Epic** | [`TASK_epic_cyning_harness_roadmap_v0_2_to_v1_v1.md`](../../../../docs/harness/tasks/active/TASK_epic_cyning_harness_roadmap_v0_2_to_v1_v1.md) |
|
|
9
|
+
| **范围** | B8(1+3 主链)· B9(Agent-shell 并行)方向审核与回写 |
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## 1. 背景
|
|
14
|
+
|
|
15
|
+
**问题**:行业 Agent Bench(Terminal-Bench、SWE-bench)测 **解题完成率**,难以直接证明 **外挂式纪律包** 在 Inform/Verify 绑定下的过程签收价值。
|
|
16
|
+
|
|
17
|
+
**维护者决策(2026-06-15)**:
|
|
18
|
+
|
|
19
|
+
| 线 | 内容 | 优先级 |
|
|
20
|
+
| --- | --- | --- |
|
|
21
|
+
| **1+3** | B2 真实试点量化 + SDD-Compliance micro-bench | **主链** · Epic #8 |
|
|
22
|
+
| **2** | Agent-shell(Kimi agent 规则层 SDD) | **并行** · Epic #9 · 核实期 · 不挡 Q3 push |
|
|
23
|
+
|
|
24
|
+
**部署形态共识**:
|
|
25
|
+
|
|
26
|
+
- **Repo 嵌入**(`kimi-code-meta`):全 ICVO · 主证据
|
|
27
|
+
- **Agent 层**(shell):Orchestrate + 轻 Constrain · Inform/Verify 仍靠 repo
|
|
28
|
+
- **Hybrid**:repo marker 存在时 **repo 真值优先**
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 2. 产出物时间线
|
|
33
|
+
|
|
34
|
+
| 阶段 | 日期 | 动作 | 落点 |
|
|
35
|
+
| --- | --- | --- | --- |
|
|
36
|
+
| T1 | 2026-06-15 | Epic 增 **#8 / #9** · ROADMAP v1.3 Track B 证据三线 | 工作区 `docs/harness/tasks/active/` · `ROADMAP_v1_zh.md` |
|
|
37
|
+
| T2 | 2026-06-15 | 撰写两份 **审核稿** + 联合 Invoke Prompt | `reviews/REVIEW_B3_*` · `REVIEW_B9_*` · `prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md` |
|
|
38
|
+
| T3 | 2026-06-15 | **外部 Agent** 执行 PROMPT 阶段 A–C | 结论见 §3 |
|
|
39
|
+
| T4 | 2026-06-15 | 必改项 **回写** task · REVIEW v1.1 · Epic / ROADMAP | 本纪要 §4 |
|
|
40
|
+
| T5 | 2026-06-15 | 起草 **PILOT_EVIDENCE_B2_v1_zh.md** 空模板 | `execution/PILOT_EVIDENCE_B2_v1_zh.md` |
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## 3. 外部审核结论摘要
|
|
45
|
+
|
|
46
|
+
| 方案 | 结论 | 可行性 | HG |
|
|
47
|
+
| --- | --- | --- | --- |
|
|
48
|
+
| **B8 · 1+3** | APPROVE_WITH_CHANGES | 4/5 | `HG-B8-DIRECTION` = approved_with_changes |
|
|
49
|
+
| **B9 · shell** | APPROVE_WITH_CHANGES | 3/5 | `HG-B9-DIRECTION` = approved_with_changes |
|
|
50
|
+
|
|
51
|
+
**交叉问题(审核 Agent)**:
|
|
52
|
+
|
|
53
|
+
1. 1+3 与 2 并行 **合理**(#8 主投入 · #9 ≤4h/周)
|
|
54
|
+
2. 若只能做一个 → **砍 #9**
|
|
55
|
+
3. 对外叙事 **不矛盾**,若统一 **repo-primary**
|
|
56
|
+
4. 1+3 已接近最小双证据集;不宜再砍 bench 雏形
|
|
57
|
+
|
|
58
|
+
详文:[`REVIEW_B3` §10](./REVIEW_B3_pilot_evidence_and_sdd_compliance_bench_v1_zh.md#10-审核记录2026-06-15) · [`REVIEW_B9` §10](./REVIEW_B9_agent_shell_parallel_v1_zh.md#10-审核记录2026-06-15)
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 4. 必改项锁定(已回写 task)
|
|
63
|
+
|
|
64
|
+
### B8(#8)
|
|
65
|
+
|
|
66
|
+
| # | 必改项 |
|
|
67
|
+
| --- | --- |
|
|
68
|
+
| 1 | v1 micro-bench **仅 S1–S4** · S5 等 v0.3 gate 后再纳入 |
|
|
69
|
+
| 2 | B2 增 **`upstream_pr_d6_clean`**(D6 机制证据) |
|
|
70
|
+
| 3 | Part B 标注依赖 P0 绿 · **不预写**合规率 |
|
|
71
|
+
| 4 | 对外标题 **SDD-Compliance** · 禁 Agent Score |
|
|
72
|
+
| 5 | 双证据 **同页** · 与 #4 dogfood **共用样本** |
|
|
73
|
+
|
|
74
|
+
### B9(#9)
|
|
75
|
+
|
|
76
|
+
| # | 必改项 |
|
|
77
|
+
| --- | --- |
|
|
78
|
+
| 1 | 实验矩阵 **3×2**(repo vs shell)· Hybrid 可选 |
|
|
79
|
+
| 2 | **≤4h/周** · 核实期 v0.3–v0.4 |
|
|
80
|
+
| 3 | **Week-1** 验证 H1(硬 gate vs 软提示) |
|
|
81
|
+
| 4 | 不进 Moonshot upstream |
|
|
82
|
+
| 5 | **#8 scenario 冻结后**再开 #9 |
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## 5. 后续闸门
|
|
87
|
+
|
|
88
|
+
| 闸门 | 条件 |
|
|
89
|
+
| --- | --- |
|
|
90
|
+
| #8 开工 | P0 金样 ACCEPTANCE 全绿 |
|
|
91
|
+
| #8 SIGNOFF | B2 表 + bench 报告 · 数字 **冻结后**进 README |
|
|
92
|
+
| #9 开工 | #8 scenario 定义冻结 |
|
|
93
|
+
| Epic CLOSE | **不强制** #9 |
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## 6. 修订记录
|
|
98
|
+
|
|
99
|
+
| 版本 | 日期 | 说明 |
|
|
100
|
+
| --- | --- | --- |
|
|
101
|
+
| v1.0 | 2026-06-15 | 审核闭环纪要 |
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# reviews/ · 方案审核稿
|
|
2
|
+
|
|
3
|
+
> **用途**:提交 **外部 Agent** 审方向可行性 · **非** 已实现能力说明。
|
|
4
|
+
> **Invoke**:[`../prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md`](../prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md)
|
|
5
|
+
|
|
6
|
+
| 文档 | 对应 task | 状态 |
|
|
7
|
+
| --- | --- | --- |
|
|
8
|
+
| [`PROCESS_track_b_evidence_audit_2026-06-15_v1_zh.md`](./PROCESS_track_b_evidence_audit_2026-06-15_v1_zh.md) | B8/B9 审核闭环纪要 | `closed` |
|
|
9
|
+
| [`REVIEW_B9_agent_shell_parallel_v1_zh.md`](./REVIEW_B9_agent_shell_parallel_v1_zh.md) | 工作区 #9 · 2 并行 | `review_done` · APPROVE_WITH_CHANGES |
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
# 审核稿 · B8 方案:B2 试点量化 + SDD-Compliance micro-bench(1+3)
|
|
2
|
+
|
|
3
|
+
| 项 | 内容 |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| **状态** | `review_done` · **APPROVE_WITH_CHANGES** |
|
|
6
|
+
| **版本** | v1.1 |
|
|
7
|
+
| **日期** | 2026-06-15 |
|
|
8
|
+
| **提交方** | 维护者 / 路线 Epic #8 |
|
|
9
|
+
| **审核方** | 外部 Agent(只读 · 输出可行性结论) |
|
|
10
|
+
| **关联 task** | [`task_cyning_harness_b8_b2_compliance_bench_v1.md`](../../../../docs/harness/tasks/active/task_cyning_harness_b8_b2_compliance_bench_v1.md) |
|
|
11
|
+
| **Invoke Prompt** | [`../prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md`](../prompts/PROMPT_feasibility_review_b_evidence_v1_zh.md) |
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 0. 请审核 Agent 回答什么
|
|
16
|
+
|
|
17
|
+
**一句话**:在 **不追 Agent 解题 Bench** 的前提下,「真实试点 B2 + 5 场景合规 micro-bench」能否作为 cyning-harness **v1.0 有用性** 的主证据?
|
|
18
|
+
|
|
19
|
+
**须给出**:`APPROVE` / `APPROVE_WITH_CHANGES` / `REJECT` + 理由 · 不超过 1200 字。
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## 1. 问题陈述
|
|
24
|
+
|
|
25
|
+
| 痛点 | 说明 |
|
|
26
|
+
| --- | --- |
|
|
27
|
+
| 行业 Bench 偏 Agent | Terminal-Bench、SWE-bench 测 **任务完成率**,非 **过程签收** |
|
|
28
|
+
| 纪律包外挂 | 价值随 **Inform/Verify 与项目绑定** 加深;浅绑定难证「比不用强」 |
|
|
29
|
+
| 对外 credibility | STRATEGY 要求 **B2 在 Q3 push 前** · README 须可自证 |
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 2. 方案摘要(1+3)
|
|
34
|
+
|
|
35
|
+
```text
|
|
36
|
+
Part A · B2(真实)
|
|
37
|
+
kimi-code-meta / 历史 task retro
|
|
38
|
+
→ 打回率、R1 轮次、CI 首次绿、gate 拦截、接入人天
|
|
39
|
+
|
|
40
|
+
Part B · micro-bench(可复现)
|
|
41
|
+
5 固定 scenario · 公理 D2/D3/S2
|
|
42
|
+
→ gate-check 机械化打分 · 合规率 %
|
|
43
|
+
→ 不测 LLM 解题
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
**与 Terminal-Bench 关系**:**互补、不对标**。对外叙事:「测敢不敢合,不测会不会做题。」
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 3. 设计约束(审核时不得突破)
|
|
51
|
+
|
|
52
|
+
| ID | 约束 |
|
|
53
|
+
| --- | --- |
|
|
54
|
+
| C1 | 产品 P1:不做 LLM Runtime |
|
|
55
|
+
| C2 | 样本量小须 **明示**(n、task 类型)· 禁止外推胜率 |
|
|
56
|
+
| C3 | 未冻结数字 **不进** 公众稿(篇 1 §8) |
|
|
57
|
+
| C4 | bench 只测 **Orchestrate/Verify 可机械部分**(gate、review 文件存在) |
|
|
58
|
+
| C5 | 一人维护 · Part B 优先脚本化 gate-check · 不依赖大规模人工标注 |
|
|
59
|
+
|
|
60
|
+
---
|
|
61
|
+
|
|
62
|
+
## 4. micro-bench scenario(v1.1 · 审核后)
|
|
63
|
+
|
|
64
|
+
| ID | 场景 | 夹具要点 | 期望(合规) | v1 纳入 |
|
|
65
|
+
| --- | --- | --- | --- | --- |
|
|
66
|
+
| S1 | R1 pending 即 30 | task 表 HG-AUDIT-R1=pending | gate-check exit≠0 · 30 应拒(D2) | **是** |
|
|
67
|
+
| S2 | R1 approved | HG-AUDIT-R1=approved · 无 review 文件 | gate 警告或 22 不合规 | **是** |
|
|
68
|
+
| S3 | R1 approved + review 落盘 | 有 `reviews/*_R1_*` | gate-check exit=0 | **是** |
|
|
69
|
+
| S4 | sync 域 vs S2 | plan 列出 tasks/ 路径 | apply **不得**含 S2 路径 | **是** |
|
|
70
|
+
| S5 | rejected → draft | HG-AUDIT-R1=rejected | gate 建议 status=draft | **条件项** · v0.3+ gate 落地后 |
|
|
71
|
+
|
|
72
|
+
> **审核结论**:S1–S4 覆盖产品差异化核心;v1.0 **不必**增 D4/D5 scenario · README **须声明覆盖边界**。
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## 5. B2 字段草案(PilotEvidence)
|
|
77
|
+
|
|
78
|
+
| 字段 | 采集方式 | 用途 |
|
|
79
|
+
| --- | --- | --- |
|
|
80
|
+
| `audit_reject_rate` | 22 轮次中「内容阻塞」比例 | Orchestrate 有效性 |
|
|
81
|
+
| `audit_rounds_mean` | R1→R2… 平均轮次 | 协作成本 |
|
|
82
|
+
| `ci_first_green_rate` | 改码 task 首次 CI 绿 | Verify |
|
|
83
|
+
| `gate_block_count` | 30 前 gate-check 拦截次数 | 公理执行 |
|
|
84
|
+
| `wizard_adoption_days` | install→首 task CLOSE | 产品 UX |
|
|
85
|
+
| `sample_n` | task 数 · 类型 | 诚实边界 |
|
|
86
|
+
| **`upstream_pr_d6_clean`** | D6 双分支零泄漏 PR 数/率 | **机制证据**(审核必增) |
|
|
87
|
+
| `failure_report_count` | 30 失败路径次数 | 可选 |
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## 6. 风险与反模式(请审核是否认同)
|
|
92
|
+
|
|
93
|
+
| 风险 | 缓解 |
|
|
94
|
+
| --- | --- |
|
|
95
|
+
| n 太小不可信 | 并列 **机制证据**(上游 PR 链)+ bench **可复现** |
|
|
96
|
+
| bench 与真实脱节 | scenario 来自 P0 金样 + kimi 真实失败模式 |
|
|
97
|
+
| 被误读为「模型 Benchmark」 | README 标题用 **SDD Compliance** · 非 Agent Score |
|
|
98
|
+
| 维护成本 | 5 scenario 固定 · semver 大改才增 scenario |
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## 7. 成功标准(方向通过)
|
|
103
|
+
|
|
104
|
+
审核 **APPROVE** 当且仅当(可带修改项):
|
|
105
|
+
|
|
106
|
+
- [ ] B2 + micro-bench **足以支撑** v1.0 README「为何有用」段落
|
|
107
|
+
- [ ] **不**与产品本体 / ROADMAP / 篇 1 §8 冲突
|
|
108
|
+
- [ ] 一人 **8 月底前** 可完成 Part A 最小集 + Part B 脚本雏形
|
|
109
|
+
- [ ] 不要求 Terminal-Bench 对照作为门禁
|
|
110
|
+
|
|
111
|
+
---
|
|
112
|
+
|
|
113
|
+
## 8. 审核 Agent 输出模板
|
|
114
|
+
|
|
115
|
+
```markdown
|
|
116
|
+
## 结论
|
|
117
|
+
APPROVE | APPROVE_WITH_CHANGES | REJECT
|
|
118
|
+
|
|
119
|
+
## 可行性(1–5)
|
|
120
|
+
## 与战略一致性
|
|
121
|
+
## 必改项(若 APPROVE_WITH_CHANGES)
|
|
122
|
+
## 可选增强
|
|
123
|
+
## 是否建议合并/拆分 Part A 与 B
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 10. 审核记录(2026-06-15)
|
|
129
|
+
|
|
130
|
+
| 项 | 内容 |
|
|
131
|
+
| --- | --- |
|
|
132
|
+
| **结论** | **APPROVE_WITH_CHANGES** |
|
|
133
|
+
| **可行性** | 4/5 |
|
|
134
|
+
| **HG-B8-DIRECTION** | `approved_with_changes` |
|
|
135
|
+
|
|
136
|
+
**必改项(已回写 task #8)**:
|
|
137
|
+
|
|
138
|
+
1. v1 bench **仅 S1–S4** · S5 对齐 v0.3 后再纳入
|
|
139
|
+
2. B2 增 **`upstream_pr_d6_clean`**
|
|
140
|
+
3. Part B 标注依赖 P0 绿 · **不预写**合规率
|
|
141
|
+
4. README 标题 **SDD-Compliance** · 禁 Agent Score
|
|
142
|
+
|
|
143
|
+
**可选增强**:双证据同页 · 与 #4 共用样本 · 同 task 分节交付
|
|
144
|
+
|
|
145
|
+
**交叉问题(摘要)**:1+3 与 2 并行合理(#8 主投入 · #9 ≤4h/周);若只能做一个 **砍 #9**;叙事不矛盾若 **repo-primary**;1+3 已接近最小双证据集。
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## 9. 修订记录
|
|
150
|
+
|
|
151
|
+
| 版本 | 日期 | 说明 |
|
|
152
|
+
| --- | --- | --- |
|
|
153
|
+
| v1.0 | 2026-06-15 | 提交外部审核 |
|
|
154
|
+
| v1.1 | 2026-06-15 | 审核结论 · S1–S4 · D6 字段 · §10 记录 |
|