@archsight/aios 1.2.0 → 1.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/.claude-plugin/plugin.json +1 -1
- package/CHANGELOG.md +35 -0
- package/OPENCODE.md +23 -0
- package/README.md +64 -31
- package/RELEASE_NOTES.md +25 -0
- package/agents/README.md +6 -3
- package/agents/daedalus/system-prompt.md +2 -0
- package/agents/hestia/constraints.md +7 -0
- package/agents/hestia/responsibilities.md +7 -0
- package/agents/hestia/role.md +12 -0
- package/agents/hestia/system-prompt.md +23 -0
- package/agents/hestia/workflow.md +8 -0
- package/agents/plutus/constraints.md +7 -0
- package/agents/plutus/responsibilities.md +7 -0
- package/agents/plutus/role.md +12 -0
- package/agents/plutus/system-prompt.md +24 -0
- package/agents/plutus/workflow.md +8 -0
- package/agents/themis/constraints.md +7 -0
- package/agents/themis/responsibilities.md +7 -0
- package/agents/themis/role.md +12 -0
- package/agents/themis/system-prompt.md +24 -0
- package/agents/themis/workflow.md +8 -0
- package/bin/archsight-aios.mjs +555 -24
- package/docs/PUBLIC_DISCOVERY.md +16 -2
- package/docs/business-expert-guide.md +5 -3
- package/docs/glossary.md +11 -3
- package/docs/quickstart.md +18 -4
- package/gemini-extension.json +1 -1
- package/package.json +17 -6
- package/prompts/README.md +12 -0
- package/prompts/evaluation-policy.md +70 -0
- package/prompts/evaluations/engineering-business-basic-advisory-validation-2026-06-16.md +87 -0
- package/prompts/evaluations/engineering-business-basic-fixtures.json +375 -0
- package/prompts/evaluations/engineering-business-basic-model-output.example.json +179 -0
- package/prompts/evaluations/engineering-business-basic-prompts-2026-06-16.md +205 -0
- package/prompts/evaluations/engineering-business-basic-scorecard.json +238 -0
- package/prompts/evaluations/engineering-business-public-advisory-fixtures.json +422 -0
- package/prompts/evaluations/public-advisory-md/01-technical-bid.md +63 -0
- package/prompts/evaluations/public-advisory-md/02-contract.md +61 -0
- package/prompts/evaluations/public-advisory-md/03-daily.md +69 -0
- package/prompts/evaluations/public-advisory-md/04-meeting.md +48 -0
- package/prompts/evaluations/public-advisory-md/05-variation.md +63 -0
- package/prompts/evaluations/public-advisory-md/06-scheme.md +60 -0
- package/prompts/failure-cases.md +5 -1
- package/prompts/prompt-registry.md +10 -0
- package/runtime/agent-routing.md +36 -8
- package/runtime/archsight-aios.manifest.json +104 -40
- package/runtime/hermes/agent-registry.md +3 -0
- package/runtime/hermes/workspace-binding.md +3 -0
- package/runtime/skill-routing.md +12 -7
- package/scripts/analyze-prompt-run-results.mjs +187 -0
- package/scripts/build-prompt-run-pack.mjs +248 -0
- package/scripts/validate-prompt-fixtures.mjs +225 -0
- package/scripts/validate-prompt-model-outputs.mjs +201 -0
- package/scripts/validate-prompt-run-results.mjs +259 -0
- package/scripts/validate-prompt-scorecard.mjs +133 -0
- package/scripts/validate-skills.mjs +6 -2
- package/skills/README.md +3 -0
- package/skills/aios-commercial-contract/SKILL.md +18 -0
- package/skills/aios-commercial-contract/prompts/basic-prompt.md +83 -0
- package/skills/aios-commercial-tender/SKILL.md +18 -0
- package/skills/aios-commercial-tender/prompts/basic-prompt.md +94 -0
- package/skills/aios-commercial-variation/SKILL.md +18 -0
- package/skills/aios-commercial-variation/prompts/basic-prompt.md +99 -0
- package/skills/aios-construction-daily/SKILL.md +18 -0
- package/skills/aios-construction-daily/prompts/basic-prompt.md +76 -0
- package/skills/aios-construction-meeting/SKILL.md +18 -0
- package/skills/aios-construction-meeting/prompts/basic-prompt.md +78 -0
- package/skills/aios-construction-scheme/SKILL.md +18 -0
- package/skills/aios-construction-scheme/prompts/basic-prompt.md +90 -0
- package/skills/aios-prompt-compare/SKILL.md +178 -0
- package/skills/aios-prompt-compare/agents/openai.yaml +4 -0
- package/skills/engineering-business-starter-kit.md +109 -0
- package/templates/README.md +16 -2
- package/templates/project-ai/.ai/ARCHSIGHT_AIOS_RULES.md +5 -4
- package/templates/project-ai/.ai/agent-routing.md +3 -1
- package/templates/project-ai/.ai/profile-detection.md +24 -0
- package/templates/project-ai/.ai/project-context.md +4 -1
- package/templates/project-ai/.ai/skills.md +25 -20
- package/templates/project-ai/AGENTS.md +6 -5
- package/templates/project-ai/AI_CODING_RULES.md +1 -1
- package/templates/project-ai/CLAUDE.md +6 -5
- package/templates/project-ai/GEMINI.md +6 -5
- package/templates/project-ai/OPENCODE.md +26 -0
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: aios-prompt-compare
|
|
3
|
+
description: 比较弱提示词、便携强提示词和真实 Skill 触发结果的评估技能。用于 prompt 回归、weak/basic/runtime 三栏对照、Skill 沉淀价值判断、模型输出质量复盘和 AIOS 技能包验收。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# AIOS Prompt Compare
|
|
7
|
+
|
|
8
|
+
## 目标
|
|
9
|
+
|
|
10
|
+
以 Daedalus(AI 研发工程师)的方式组织 Prompt / Skill 效果对比,把同一输入下的弱提示词、便携强提示词和真实 Skill 触发结果拆成三栏评估,判断哪一类输出更稳定、更可复核、更值得沉淀为 Skill。
|
|
11
|
+
|
|
12
|
+
本 Skill 是评估和治理入口,不替代具体业务 Skill 执行,也不直接把评测结论当作生产可用性承诺。
|
|
13
|
+
|
|
14
|
+
## 适用场景
|
|
15
|
+
|
|
16
|
+
- 对比 `weakPrompt`、`prompts/basic-prompt.md` 和 `$aios-*` Skill 真实运行结果。
|
|
17
|
+
- 判断一段提示词是否应升级为正式 Skill。
|
|
18
|
+
- 复盘同一 fixture 在不同提示词、不同 Skill 或不同模型下的输出差异。
|
|
19
|
+
- 检查输出是否遵守证据链、禁止结论、人工复核和脱敏边界。
|
|
20
|
+
- 维护 `prompts/evaluations/*fixtures.json`、run pack、run results 和 scorecard。
|
|
21
|
+
|
|
22
|
+
不适用:
|
|
23
|
+
|
|
24
|
+
- 只想直接处理工程资料时,先使用对应业务 Skill。
|
|
25
|
+
- 没有同一输入或可对齐输出时,不做横向优劣判断,只记录待补材料。
|
|
26
|
+
- 不能把一次模型输出胜负当作长期质量结论。
|
|
27
|
+
|
|
28
|
+
## 输入
|
|
29
|
+
|
|
30
|
+
优先收集:
|
|
31
|
+
|
|
32
|
+
- 对比目标:弱提示词、便携强提示词、真实 Skill、旧版 Skill、新版 Skill 或不同模型。
|
|
33
|
+
- 同一份输入材料:脱敏文本、Markdown fixture、公开样例或用户提供资料。
|
|
34
|
+
- 对应 fixture:例如 `prompts/evaluations/engineering-business-basic-fixtures.json`。
|
|
35
|
+
- 已生成的 run pack、run results、模型输出文件或三类原始输出。
|
|
36
|
+
- scorecard 或评估维度:结构完整度、证据定位、边界安全、可执行性、复用性、人工复核分流。
|
|
37
|
+
|
|
38
|
+
## 原始输出保全
|
|
39
|
+
|
|
40
|
+
对比报告必须保留三类输出的原始正文,不能只写摘要。
|
|
41
|
+
|
|
42
|
+
最低要求:
|
|
43
|
+
|
|
44
|
+
- 在分析前先建立 `Raw Output Map`,列出 weak、portable、skill-runtime 三类输出是否已提供、来源文件或运行记录、是否经过脱敏。
|
|
45
|
+
- 在报告末尾增加 `原始输出附录`,分别放入 `weak 原始输出`、`portable 原始输出`、`skill-runtime 原始输出`。
|
|
46
|
+
- 每类原始输出必须用 fenced code block 包住,保持模型原始章节、表格、结论和措辞;只允许做必要脱敏,不允许改写成摘要。
|
|
47
|
+
- 如果某一类输出缺失,必须在对应附录写 `未提供原始输出`,并在结论中说明本次对比证据不足。
|
|
48
|
+
- 如果原始输出包含真实客户、联系人、项目名、地点、金额、日期、文件路径或源文件名,先脱敏为 `[客户A]`、`[项目A]`、`[地点A]`、`[金额A]`、`[日期A]`、`[源文件A]`,再放入附录。
|
|
49
|
+
|
|
50
|
+
摘要、scorecard 和沉淀判断只能基于这些原始输出得出;不能凭记忆、推测或二次转述补写原始输出。
|
|
51
|
+
|
|
52
|
+
## 三栏比较模式
|
|
53
|
+
|
|
54
|
+
默认使用三类输出,不要混在一个结论里:
|
|
55
|
+
|
|
56
|
+
1. `weak`:弱提示词结果。通常来自 fixture 中的 `weakPrompt`,用于暴露随口问的失败模式。
|
|
57
|
+
2. `portable`:便携强提示词结果。通常来自 `skills/*/prompts/basic-prompt.md`,用于验证无 Skill runtime 时的最低可用版本。
|
|
58
|
+
3. `skill-runtime`:真实 Skill 结果。必须来自宿主工具按 `$aios-*` 或自动 Skill 触发机制执行后的输出,而不是简单把 `SKILL.md` 当普通 prompt 粘贴。
|
|
59
|
+
|
|
60
|
+
如果当前只有 weak/basic 两类结果,明确标注 `skill-runtime: 未提供`,不要假装完成了 Skill 运行对比。
|
|
61
|
+
|
|
62
|
+
## 工作流
|
|
63
|
+
|
|
64
|
+
1. 明确对比对象和输入是否一致;输入不一致时先停止横向比较。
|
|
65
|
+
2. 建立 Run Map:记录 caseId、skillId、输入来源、promptSource、模型、运行时间和输出文件。
|
|
66
|
+
3. 建立 Raw Output Map:确认 weak、portable、skill-runtime 三类原始输出是否存在、是否脱敏、是否同源。
|
|
67
|
+
4. 分别读取 weak、portable、skill-runtime 三类原始输出;缺失时停止声称完整三栏对比。
|
|
68
|
+
5. 按统一 scorecard 逐项评分:结构完整度、证据追溯、边界安全、可执行动作、模板复用、人工复核分流。
|
|
69
|
+
6. 标出失败模式:编造事实、跳过资料状态判断、越权下结论、缺少 Evidence、无法落地到责任人或台账。
|
|
70
|
+
7. 判断沉淀方向:保留普通提示词、强化 portable prompt、升级 / 修订 Skill,或补 fixture / scorecard。
|
|
71
|
+
8. 输出原始输出附录和下一步验证命令或待补材料。
|
|
72
|
+
|
|
73
|
+
## 可用工具链
|
|
74
|
+
|
|
75
|
+
已有工程业务管理评测链路:
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
npm run validate:prompts
|
|
79
|
+
npm run validate:prompt-run-pack
|
|
80
|
+
npm run build:prompt-run-pack
|
|
81
|
+
npm run validate:public-advisory-run-pack
|
|
82
|
+
npm run build:public-advisory-run-pack
|
|
83
|
+
npm run validate:prompt-run-results
|
|
84
|
+
npm run analyze:prompt-run-results -- --file prompts/evaluations/<results>.json --out prompts/evaluations/<report>.md
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
这些脚本默认组织 weak / portable 对照。真实 `skill-runtime` 输出需要由宿主 Agent 实际触发对应 `$aios-*` Skill 后归档,再进入本 Skill 的三栏人工或半自动分析。
|
|
88
|
+
|
|
89
|
+
## 输出格式
|
|
90
|
+
|
|
91
|
+
默认输出:
|
|
92
|
+
|
|
93
|
+
1. 结论
|
|
94
|
+
2. Run Map
|
|
95
|
+
3. Raw Output Map
|
|
96
|
+
4. 三栏输出摘要
|
|
97
|
+
5. Scorecard
|
|
98
|
+
6. 失败模式
|
|
99
|
+
7. Skill 沉淀判断
|
|
100
|
+
8. 后续动作
|
|
101
|
+
9. 原始输出附录
|
|
102
|
+
|
|
103
|
+
三栏摘要格式:
|
|
104
|
+
|
|
105
|
+
```text
|
|
106
|
+
caseId:
|
|
107
|
+
输入:
|
|
108
|
+
weak:
|
|
109
|
+
portable:
|
|
110
|
+
skill-runtime:
|
|
111
|
+
关键差异:
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
Raw Output Map 格式:
|
|
115
|
+
|
|
116
|
+
```text
|
|
117
|
+
caseId:
|
|
118
|
+
weak 原始输出:已提供 / 未提供
|
|
119
|
+
portable 原始输出:已提供 / 未提供
|
|
120
|
+
skill-runtime 原始输出:已提供 / 未提供
|
|
121
|
+
脱敏状态:
|
|
122
|
+
证据缺口:
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
Scorecard 条目格式:
|
|
126
|
+
|
|
127
|
+
```text
|
|
128
|
+
维度:
|
|
129
|
+
weak:
|
|
130
|
+
portable:
|
|
131
|
+
skill-runtime:
|
|
132
|
+
证据:
|
|
133
|
+
判定:
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
沉淀判断格式:
|
|
137
|
+
|
|
138
|
+
```text
|
|
139
|
+
是否应升级为 Skill:
|
|
140
|
+
原因:
|
|
141
|
+
需要进入 SKILL.md 的规则:
|
|
142
|
+
仍保留为 portable prompt 的内容:
|
|
143
|
+
需要补的 fixture / scorecard:
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
原始输出附录格式:
|
|
147
|
+
|
|
148
|
+
````markdown
|
|
149
|
+
## 原始输出附录
|
|
150
|
+
|
|
151
|
+
### weak 原始输出
|
|
152
|
+
|
|
153
|
+
```text
|
|
154
|
+
粘贴 weak 模型原始输出;如缺失,写“未提供原始输出”。
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### portable 原始输出
|
|
158
|
+
|
|
159
|
+
```text
|
|
160
|
+
粘贴 portable 模型原始输出;如缺失,写“未提供原始输出”。
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### skill-runtime 原始输出
|
|
164
|
+
|
|
165
|
+
```text
|
|
166
|
+
粘贴真实 Skill 触发后的原始输出;如缺失,写“未提供原始输出”。
|
|
167
|
+
```
|
|
168
|
+
````
|
|
169
|
+
|
|
170
|
+
## 约束
|
|
171
|
+
|
|
172
|
+
- 不用不同输入比较输出优劣。
|
|
173
|
+
- 不把 `SKILL.md` 文本粘贴运行的结果称为真实 Skill 结果。
|
|
174
|
+
- 不把一次输出胜负当作模型或 Skill 的长期结论。
|
|
175
|
+
- 不在报告中写入真实客户、联系人、项目名、金额、地点、日期或原始源文件内容。
|
|
176
|
+
- 不在报告中写入本机真实源文件路径;使用 `[源文件A]` 或公开 fixture 相对路径替代。
|
|
177
|
+
- 不只输出摘要和 scorecard;缺少原始输出附录时,本次对比不能标为完成。
|
|
178
|
+
- 不用评测替代业务专家、法务、造价、总工、监理或安全负责人签审。
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# 工程业务管理基础技能包
|
|
2
|
+
|
|
3
|
+
> 状态:基础可用版
|
|
4
|
+
> 用途:给施工企业工程资料处理、项目复核辅助、部门工作流整理和后续模板沉淀使用。
|
|
5
|
+
> 边界:这是 AIOS Skill 的提示词 / 工作流基础包,不是系统交付承诺,也不替代专业人员签审。
|
|
6
|
+
|
|
7
|
+
## 目标
|
|
8
|
+
|
|
9
|
+
工程业务管理基础技能包把 6 个工程业务 Skill 组合成一套可直接使用的最小能力:
|
|
10
|
+
|
|
11
|
+
- 招投标响应矩阵。
|
|
12
|
+
- 合同履约节点。
|
|
13
|
+
- 施工日报问题跟踪。
|
|
14
|
+
- 会议纪要待办闭环。
|
|
15
|
+
- 变更签证资料链。
|
|
16
|
+
- 专项施工方案辅助复核。
|
|
17
|
+
|
|
18
|
+
它适合处理施工企业常见的工程业务资料。目标不是证明 AI 能自动完成工程管理,而是帮助业务人员把资料整理成矩阵、清单、台账和复核问题,让后续人工判断更快、更稳、更可追溯。
|
|
19
|
+
|
|
20
|
+
## 对外口径
|
|
21
|
+
|
|
22
|
+
推荐表达:
|
|
23
|
+
|
|
24
|
+
```text
|
|
25
|
+
这是一组基础版工程资料处理技能包,用来把招标文件、合同、日报、会议纪要、签证资料和施工方案整理成可复核的矩阵、清单和台账。它可以帮助业务人员减少重复整理工作,但所有工程、合同、造价、法务、质量安全和审批结论仍由对应负责人复核确认。
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
避免表达:
|
|
29
|
+
|
|
30
|
+
- 不说“AI 自动审查方案 / 合同 / 标书”。
|
|
31
|
+
- 不说“可以直接替代投标、法务、造价、项目经理或总工判断”。
|
|
32
|
+
- 不说“已经能接入系统、完成部署或形成企业平台”。
|
|
33
|
+
- 不说“保证合规、保证中标、判断责任、判断金额或给出最终结论”。
|
|
34
|
+
|
|
35
|
+
## 最小输入包
|
|
36
|
+
|
|
37
|
+
每次使用前,先让使用者补齐以下信息:
|
|
38
|
+
|
|
39
|
+
| 项目 | 必填内容 |
|
|
40
|
+
|---|---|
|
|
41
|
+
| 资料类型 | 招标文件 / 合同 / 日报 / 会议纪要 / 签证资料 / 施工方案 |
|
|
42
|
+
| 资料来源 | 文件名、版本、日期、页码、章节、图号或会议日期 |
|
|
43
|
+
| 当前问题 | 想提取什么、复核什么、追踪什么 |
|
|
44
|
+
| 输出用途 | 项目复核 / 会议讨论 / 部门台账 / 模板沉淀 / 后续工作流 |
|
|
45
|
+
| 外发边界 | 是否脱敏、是否可上传公网工具、是否仅内部留存 |
|
|
46
|
+
| 人工复核人 | 投标负责人 / 法务 / 商务 / 造价 / 项目经理 / 技术负责人 / 总工 |
|
|
47
|
+
|
|
48
|
+
资料不完整时,Skill 应先输出资料状态判断,不得假装已经完成专业审查。
|
|
49
|
+
|
|
50
|
+
## 通用运行步骤
|
|
51
|
+
|
|
52
|
+
1. 选择对应 Skill。
|
|
53
|
+
2. 粘贴资料片段和最小输入包。
|
|
54
|
+
3. 先生成 `Source Map`,确认资料来源和定位方式。
|
|
55
|
+
4. 输出矩阵、清单或台账。
|
|
56
|
+
5. 把缺资料、缺责任人、缺期限、缺规范证据和需专业复核事项单独列出。
|
|
57
|
+
6. 由人工负责人复核后,再决定是否沉淀为部门模板、提示词或本地智能体工作流。
|
|
58
|
+
|
|
59
|
+
## 统一输出骨架
|
|
60
|
+
|
|
61
|
+
基础版场景下,6 个 Skill 都应尽量保持以下结构,便于施工企业内部形成统一使用习惯:
|
|
62
|
+
|
|
63
|
+
1. 输入类型和资料状态判断。
|
|
64
|
+
2. Source Map。
|
|
65
|
+
3. 主输出表:响应矩阵 / 履约节点 / 问题台账 / 待办闭环 / 资料链 / 辅助复核清单。
|
|
66
|
+
4. 需补充确认事项。
|
|
67
|
+
5. 人工复核岗位。
|
|
68
|
+
6. 可沉淀为部门模板的字段。
|
|
69
|
+
7. 不适用或不能下结论的事项。
|
|
70
|
+
8. Arbitration:`Claim / Evidence / Tool Result / Decision`。
|
|
71
|
+
|
|
72
|
+
## Skill 路由
|
|
73
|
+
|
|
74
|
+
| 场景 | 使用 Skill | 典型输出 |
|
|
75
|
+
|---|---|---|
|
|
76
|
+
| 招标文件、评分办法、技术标问题、AI 标书工具复核问题 | `aios-commercial-tender` | 问题回应矩阵、评分点响应矩阵、废标风险占位、资料缺口 |
|
|
77
|
+
| 分包合同、采购合同、租赁合同、补充协议 | `aios-commercial-contract` | 合同基本事实、履约节点、付款条件、空白字段核对表 |
|
|
78
|
+
| 项目日报、施工日报、周报素材、项目群日报 | `aios-construction-daily` | 管理摘要、问题台账、模板质量诊断、需确认事项 |
|
|
79
|
+
| 协调会、专题会、交底会、例会纪要 | `aios-construction-meeting` | 会议结论、待办闭环、责任线索、下次追踪清单 |
|
|
80
|
+
| 签证、联系单、图纸变更、会议纪要和合同条款链路 | `aios-commercial-variation` | 资料链完整性、资料断点、流程依据、复核分流 |
|
|
81
|
+
| 深基坑、高支模、施工方案、专家修改说明 | `aios-construction-scheme` | 工程概况、危险源、交底要点、专家 / 计算书回查清单 |
|
|
82
|
+
|
|
83
|
+
## 能力分层
|
|
84
|
+
|
|
85
|
+
| 层级 | 形态 | 适用阶段 | 不应承诺 |
|
|
86
|
+
|---|---|---|---|
|
|
87
|
+
| L0 | 单次提示词 | 个人使用、单份资料处理 | 不承诺稳定工作流 |
|
|
88
|
+
| L1 | Skill 模板 | 部门内部反复使用 | 不承诺系统接入 |
|
|
89
|
+
| L2 | 本地智能体工作流 | 固定资料类型、固定输出表 | 不承诺自动审批 |
|
|
90
|
+
| L3 | 系统 / 知识库 / 权限集成 | 后续专项评估和项目建设 | 基础版不直接承诺 |
|
|
91
|
+
|
|
92
|
+
基础技能包默认只覆盖 L0-L1。进入 L2-L3 前,需要单独评估数据权限、资料质量、人员职责、系统接口、部署成本和维护责任。
|
|
93
|
+
|
|
94
|
+
## 验收标准
|
|
95
|
+
|
|
96
|
+
一次基础使用只要满足以下标准,就可以认为 Skill 输出可用于内部讨论:
|
|
97
|
+
|
|
98
|
+
- 输出能回到原始资料位置。
|
|
99
|
+
- 缺失信息被标为 `需补充确认` 或 `Need verify`。
|
|
100
|
+
- 工程、合同、造价、法务、财务、质量安全事项保留人工复核岗位。
|
|
101
|
+
- 输出是表格、清单或台账,能复制进部门工作流。
|
|
102
|
+
- 没有把样例输出写成最终专业结论。
|
|
103
|
+
|
|
104
|
+
## 使用提醒
|
|
105
|
+
|
|
106
|
+
- 优先使用脱敏资料;未脱敏项目资料不上传公网 AI 工具。
|
|
107
|
+
- 输出先用于内部讨论、资料整理和模板验证,不直接作为正式签审依据。
|
|
108
|
+
- 如果资料涉及金额、工期、责任、合规、质量安全、结构计算或法律意见,必须由对应负责人复核。
|
|
109
|
+
- 基础版重点看“是否节省整理时间、是否更容易复核、是否能沉淀模板”,不要用单次输出判断系统建设成败。
|
package/templates/README.md
CHANGED
|
@@ -18,12 +18,26 @@
|
|
|
18
18
|
|
|
19
19
|
## 项目 Profile
|
|
20
20
|
|
|
21
|
-
`project-ai/` 是通用 AIOS
|
|
21
|
+
`project-ai/` 是通用 AIOS 接入底座。行业 profile 默认作为 AIOS 包内 registry 存在,用户通常不需要先理解或选择 profile。`init` 默认使用 `--profile auto`,根据项目名、README、package / pyproject 和浅层文件名生成 `.ai/profile-detection.md`,并在首次创建 `.ai/project-context.md` 时预填项目事实草稿。
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
+
archsight-aios init --cwd /path/to/project
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
需要人工覆盖自动识别时再指定:
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
archsight-aios init --cwd /path/to/project --profile auto
|
|
31
|
+
archsight-aios init --cwd /path/to/project --profile none
|
|
32
|
+
archsight-aios init --cwd /path/to/project --profile all
|
|
24
33
|
archsight-aios init --cwd /path/to/project --profile bim-platform
|
|
25
34
|
archsight-aios init --cwd /path/to/project --profile construction-vision
|
|
26
35
|
archsight-aios init --cwd /path/to/project --profile rag-knowledge
|
|
27
36
|
```
|
|
28
37
|
|
|
29
|
-
`init` 默认使用 `--mode auto
|
|
38
|
+
`init` 默认使用 `--mode auto`:新项目补齐根目录入口(`AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md`、`AI_CODING_RULES.md`)和 `.ai/`,已有 AI 工具入口文件的项目自动追加或刷新 ArchSight AIOS 托管引用块。Profile 只在自动识别或显式指定后补充 `.ai/profiles/*.md`,不复制公共入口规则,也不修改已有 `AI_CODING_RULES.md` 正文。
|
|
39
|
+
|
|
40
|
+
自动生成文件:
|
|
41
|
+
|
|
42
|
+
- `.ai/profile-detection.md`:记录识别模式、命中证据、启用 profile 和 Skill 候选。
|
|
43
|
+
- `.ai/project-context.md`:首次创建时预填项目名、技术栈、常用命令、代码结构、候选 Agent / Skill / Workflow。
|
|
@@ -21,10 +21,11 @@
|
|
|
21
21
|
处理 AIOS 相关任务时,先读取:
|
|
22
22
|
|
|
23
23
|
- `.ai/project-context.md`
|
|
24
|
-
- `.ai/agent-routing.md`
|
|
24
|
+
- `.ai/agent-routing.md`
|
|
25
25
|
- `.ai/skills.md`
|
|
26
26
|
- `.ai/workflows.md`
|
|
27
|
-
- `.ai/
|
|
27
|
+
- `.ai/profile-detection.md`
|
|
28
|
+
- `.ai/profiles/*.md`(如当前项目自动识别或显式启用了 profile)
|
|
28
29
|
|
|
29
30
|
## 边界
|
|
30
31
|
|
|
@@ -33,8 +34,8 @@
|
|
|
33
34
|
- 业务项目的 `AI_CODING_RULES.md` 优先于本文件中的通用工程要求。
|
|
34
35
|
- ArchSight AIOS 是通用治理底座;接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
|
|
35
36
|
- AIOS 是建筑行业增强层,不是通用任务替代器;普通非建筑任务优先使用宿主工具的通用能力。
|
|
36
|
-
- 建筑行业能力通过 profile 和任务上下文启用;未启用时,不得把 BIM、IFC、GraphRAG 或审图场景当作项目默认事实,也不得把规范或工程证据链当作项目默认事实。
|
|
37
|
-
- 如果是否属于建筑行业任务不明确,先读取 `.ai/project-context.md`、README 和用户任务事实;仍不明确时按通用工程任务处理,并说明未启用行业增强。
|
|
37
|
+
- 建筑行业能力通过 `.ai/profile-detection.md`、profile 和任务上下文启用;未启用时,不得把 BIM、IFC、GraphRAG 或审图场景当作项目默认事实,也不得把规范或工程证据链当作项目默认事实。
|
|
38
|
+
- 如果是否属于建筑行业任务不明确,先读取 `.ai/profile-detection.md`、`.ai/project-context.md`、README 和用户任务事实;仍不明确时按通用工程任务处理,并说明未启用行业增强。
|
|
38
39
|
- 未经验证不得声称代码、测试、构建、部署或审查已完成。
|
|
39
40
|
- 多 Agent 结论冲突时,优先采纳确定性工具、项目事实和结构化知识证据;自然语言推理只能作为假设或建议。
|
|
40
41
|
- 涉及法规合规最终结论、结构安全结论、生产授权、权限扩大或商业范围取舍时,必须升级给人类负责人。
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
|
|
25
25
|
- 当前项目事实优先于 AIOS 通用角色说明。
|
|
26
26
|
- Hermes、飞书、OpenClaw、Codex、Claude、Gemini 等都是可选运行入口;未启用时不得写入项目假设。
|
|
27
|
-
- 建筑、BIM、IFC、规范、审图和 RAG / GraphRAG 知识工程能力通过 profile 或明确任务触发;普通项目不默认启用这些语义。
|
|
27
|
+
- 建筑、BIM、IFC、规范、审图和 RAG / GraphRAG 知识工程能力通过 `.ai/profile-detection.md`、profile 或明确任务触发;普通项目不默认启用这些语义。
|
|
28
28
|
- AIOS 是建筑行业增强层;普通非建筑任务优先使用宿主工具的通用能力,不因为安装了 AIOS 就强制套用 `aios-*` Skill。
|
|
29
29
|
- 冲突仲裁按证据等级处理:人类硬约束、确定性工具、项目事实、结构化知识优先于 Agent 自然语言判断。
|
|
30
30
|
|
|
@@ -40,6 +40,7 @@
|
|
|
40
40
|
| BIM、IFC、建筑规范、审图逻辑 | Vitruvius | 建筑数字化专家 |
|
|
41
41
|
| 结构力学、荷载、FEM、结构计算工具链 | Euclid | 结构力学专家 |
|
|
42
42
|
| 建筑行业 RAG、GraphRAG、MCP、Memory、Tool Calling | Daedalus | AI 研发工程师 |
|
|
43
|
+
| Prompt / Skill 输出对比、weak/basic/runtime 三栏评测 | Daedalus | AI 研发工程师 |
|
|
43
44
|
| 建筑行业项目代码修改、脚本执行、测试、文档生成 | Hephaestus | 受控执行官 |
|
|
44
45
|
|
|
45
46
|
## 升级规则
|
|
@@ -52,5 +53,6 @@
|
|
|
52
53
|
- 涉及行业规范、BIM / IFC、审图语义:升级给 Vitruvius。
|
|
53
54
|
- 涉及结构力学、荷载、边界条件、FEM 或结构计算工具链:升级给 Euclid。
|
|
54
55
|
- 涉及 RAG、GraphRAG、MCP、Memory、Tool:升级给 Daedalus。
|
|
56
|
+
- 涉及提示词效果、weak/basic 对照、真实 Skill 输出比较或是否应沉淀为 Skill:升级给 Daedalus,并使用 `aios-prompt-compare`。
|
|
55
57
|
- 具体实现和验证:交给 Hephaestus。
|
|
56
58
|
- Capability 返回阻断结果、证据缺失或工具不可用:停止执行并输出 `Claim / Evidence / Tool Result / Decision`。
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Profile Detection
|
|
2
|
+
|
|
3
|
+
> 本文件由 `archsight-aios init` 首次创建时自动生成。
|
|
4
|
+
> 它根据本地项目名、README、package / pyproject 和浅层文件名推断可用 profile 与候选 Skill,目的是降低接入门槛,不替代人工确认。
|
|
5
|
+
|
|
6
|
+
## 识别结论
|
|
7
|
+
|
|
8
|
+
- 模式:`auto`
|
|
9
|
+
- 当前启用 profile:待自动生成
|
|
10
|
+
- 规则来源:ArchSight AIOS 内置 profile registry。
|
|
11
|
+
|
|
12
|
+
## Profile 命中证据
|
|
13
|
+
|
|
14
|
+
- 待自动生成。
|
|
15
|
+
|
|
16
|
+
## Skill 候选
|
|
17
|
+
|
|
18
|
+
- 待自动生成。
|
|
19
|
+
|
|
20
|
+
## 边界
|
|
21
|
+
|
|
22
|
+
- 自动识别只用于初始化和路由建议,不是业务事实或工程结论。
|
|
23
|
+
- 未命中 profile 时,仍可按用户任务和资料内容触发对应 `aios-*` Skill。
|
|
24
|
+
- 涉及金额、工期、法律责任、结构安全、规范合规或人员信息时,必须保留人工复核。
|
|
@@ -20,40 +20,45 @@ AIOS 是建筑行业增强层,不是通用任务替代器。只有当前项目
|
|
|
20
20
|
| BIM / IFC / 建筑知识建模 | `aios-knowledge` | Vitruvius |
|
|
21
21
|
| 结构力学 / 荷载 / FEM / 确定性求解链路 | `aios-structural` | Euclid |
|
|
22
22
|
| 建筑行业 AI Runtime / RAG / MCP / Memory | `aios-runtime` | Daedalus |
|
|
23
|
+
| Prompt / Skill 输出对比、weak/basic/runtime 三栏评测 | `aios-prompt-compare` | Daedalus |
|
|
23
24
|
| 建筑行业项目受控实现 / 测试 / 文档 / 脚本 | `aios-exec` | Hephaestus |
|
|
24
25
|
| 工程招投标响应 / 评分点 / 废标风险 / 技术标资料矩阵 | `aios-commercial-tender` | Mason |
|
|
25
|
-
| 工程合同履约节点 / 付款条件 / 责任边界 / 资料缺口 | `aios-commercial-contract` |
|
|
26
|
+
| 工程合同履约节点 / 付款条件 / 责任边界 / 资料缺口 | `aios-commercial-contract` | Themis |
|
|
26
27
|
| 施工日报 / 现场异常 / 项目群记录 / 问题追踪台账 | `aios-construction-daily` | Mason |
|
|
27
28
|
| 工程会议纪要 / 待办闭环 / 遗留争议 / 下次追踪 | `aios-construction-meeting` | Mason |
|
|
28
|
-
| 工程变更签证资料链 / 联系单 / 图纸变更 / 索赔线索 | `aios-commercial-variation` |
|
|
29
|
+
| 工程变更签证资料链 / 联系单 / 图纸变更 / 索赔线索 | `aios-commercial-variation` | Plutus |
|
|
29
30
|
| 专项施工方案 / 危险源 / 交底要点 / 规范和计算书复核 | `aios-construction-scheme` | Vitruvius |
|
|
30
31
|
|
|
31
|
-
##
|
|
32
|
-
|
|
33
|
-
-
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
-
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
-
|
|
46
|
-
-
|
|
47
|
-
-
|
|
32
|
+
## 本项目可用的 Skills
|
|
33
|
+
|
|
34
|
+
默认不要求用户手动勾选 Skill。`archsight-aios init` 会生成 `.ai/profile-detection.md` 和 `.ai/project-context.md`,当前 AI 工具应结合项目事实、用户任务、资料类型和自动识别结果选择合适的 Skill。
|
|
35
|
+
|
|
36
|
+
- `aios-arch`
|
|
37
|
+
- `aios-ceo`
|
|
38
|
+
- `aios-design`
|
|
39
|
+
- `aios-plan`
|
|
40
|
+
- `aios-review`
|
|
41
|
+
- `aios-knowledge`
|
|
42
|
+
- `aios-structural`
|
|
43
|
+
- `aios-runtime`
|
|
44
|
+
- `aios-prompt-compare`
|
|
45
|
+
- `aios-exec`
|
|
46
|
+
- `aios-commercial-tender`
|
|
47
|
+
- `aios-commercial-contract`
|
|
48
|
+
- `aios-construction-daily`
|
|
49
|
+
- `aios-construction-meeting`
|
|
50
|
+
- `aios-commercial-variation`
|
|
51
|
+
- `aios-construction-scheme`
|
|
48
52
|
|
|
49
53
|
## 启用规则
|
|
50
54
|
|
|
51
|
-
-
|
|
55
|
+
- 优先读取 `.ai/profile-detection.md` 和 `.ai/project-context.md`,再按任务类型选择 Skill。
|
|
52
56
|
- 涉及建筑行业软件 / 系统评价、项目立项、产品定位、商业目标、范围取舍或阶段路线时,优先启用 `aios-ceo`。
|
|
53
57
|
- 涉及建筑行业平台 UI / UX 方案、工作台体验、交互状态、响应式或前端实现交接时,优先启用 `aios-design`。
|
|
54
58
|
- 只有启用建筑、BIM、IFC、规范知识库、GraphRAG 或智能审图 profile 时,才默认启用 `aios-knowledge`。
|
|
55
59
|
- 涉及结构力学、荷载、FEM、结构计算工具链或工程安全风险时,启用 `aios-structural`;关键数值必须来自确定性求解器或项目已有计算书。
|
|
56
60
|
- 涉及工程招投标、合同履约、施工日报、工程会议、变更签证或专项施工方案时,可按资料类型启用工程业务管理 Skill;这些 Skill 只做证据链整理和人工复核分流,不替代正式签审。
|
|
61
|
+
- 涉及提示词效果、weak/basic 对照、真实 Skill 输出比较或是否应沉淀为 Skill 时,启用 `aios-prompt-compare`;真实 Skill 结果必须来自宿主工具触发对应 `$aios-*` Skill 后的输出。
|
|
57
62
|
- 涉及规范、制度、结构计算、质量安全、金额、工期索赔或责任归属时,必须保留 `Claim / Evidence / Tool Result / Decision`;没有工具或人工证据时标注 `Need verify` 或 `Hold for human`。
|
|
58
63
|
- 当前任务不涉及建筑行业语义时,不要为了“已安装 AIOS”而强制使用 `aios-*` Skill。
|
|
59
64
|
- 如 Skill 来源、安装位置或同步方式无法确认,应标注待核验,不要假设已经启用。
|
|
@@ -10,16 +10,17 @@
|
|
|
10
10
|
- `AI_CODING_RULES.md`
|
|
11
11
|
- `.ai/ARCHSIGHT_AIOS_RULES.md`
|
|
12
12
|
- `.ai/project-context.md`
|
|
13
|
-
- `.ai/agent-routing.md`
|
|
14
|
-
- `.ai/skills.md`
|
|
15
|
-
- `.ai/workflows.md`
|
|
16
|
-
- `.ai/
|
|
13
|
+
- `.ai/agent-routing.md`
|
|
14
|
+
- `.ai/skills.md`
|
|
15
|
+
- `.ai/workflows.md`
|
|
16
|
+
- `.ai/profile-detection.md`
|
|
17
|
+
- `.ai/profiles/*.md`(如当前项目自动识别或显式启用了 profile)
|
|
17
18
|
- 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
|
|
18
19
|
|
|
19
20
|
## Codex 入口适配
|
|
20
21
|
|
|
21
22
|
- 本文件只负责让 Codex 发现当前项目的公共规则和 `.ai/` 目录。
|
|
22
|
-
- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review
|
|
23
|
+
- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review,以及 AIOS 自动识别或用户明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效;普通非建筑任务不强制使用 `aios-*` Skill。
|
|
23
24
|
- 接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
|
|
24
25
|
- 任务适合 ArchSight 技能包时,按 `.ai/skills.md` 选择对应 `aios-*` Skill;涉及流程协作时,按 `.ai/workflows.md` 选择 Workflow。
|
|
25
26
|
- 不把 ArchSight AIOS 仓库内容无差别复制进当前项目。
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
> 真正工程师的编程素养准则(Skills for Real Engineers)
|
|
4
4
|
>
|
|
5
5
|
> 本文件是当前业务项目的通用 AI 编码规则主体。
|
|
6
|
-
> `AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 等入口文件只引用本文件,不复制规范正文。
|
|
6
|
+
> `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 等入口文件只引用本文件,不复制规范正文。
|
|
7
7
|
> ArchSight AIOS 的专属补充规则位于 `.ai/ARCHSIGHT_AIOS_RULES.md`。
|
|
8
8
|
|
|
9
9
|
状态:项目基线
|
|
@@ -10,16 +10,17 @@
|
|
|
10
10
|
- `AI_CODING_RULES.md`
|
|
11
11
|
- `.ai/ARCHSIGHT_AIOS_RULES.md`
|
|
12
12
|
- `.ai/project-context.md`
|
|
13
|
-
- `.ai/agent-routing.md`
|
|
14
|
-
- `.ai/skills.md`
|
|
15
|
-
- `.ai/workflows.md`
|
|
16
|
-
- `.ai/
|
|
13
|
+
- `.ai/agent-routing.md`
|
|
14
|
+
- `.ai/skills.md`
|
|
15
|
+
- `.ai/workflows.md`
|
|
16
|
+
- `.ai/profile-detection.md`
|
|
17
|
+
- `.ai/profiles/*.md`(如当前项目自动识别或显式启用了 profile)
|
|
17
18
|
- 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
|
|
18
19
|
|
|
19
20
|
## Claude Code 入口适配
|
|
20
21
|
|
|
21
22
|
- 本文件只负责让 Claude Code 发现当前项目的公共规则和 `.ai/` 目录。
|
|
22
|
-
- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review
|
|
23
|
+
- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review,以及 AIOS 自动识别或用户明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效;普通非建筑任务不强制使用 `aios-*` Skill。
|
|
23
24
|
- 接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
|
|
24
25
|
- 任务适合 ArchSight 技能包时,按 `.ai/skills.md` 选择对应 `aios-*` Skill;涉及流程协作时,按 `.ai/workflows.md` 选择 Workflow。
|
|
25
26
|
- 无法确认的行业知识、规范条文或运行时配置,应标注待核验。
|
|
@@ -10,16 +10,17 @@
|
|
|
10
10
|
- `AI_CODING_RULES.md`
|
|
11
11
|
- `.ai/ARCHSIGHT_AIOS_RULES.md`
|
|
12
12
|
- `.ai/project-context.md`
|
|
13
|
-
- `.ai/agent-routing.md`
|
|
14
|
-
- `.ai/skills.md`
|
|
15
|
-
- `.ai/workflows.md`
|
|
16
|
-
- `.ai/
|
|
13
|
+
- `.ai/agent-routing.md`
|
|
14
|
+
- `.ai/skills.md`
|
|
15
|
+
- `.ai/workflows.md`
|
|
16
|
+
- `.ai/profile-detection.md`
|
|
17
|
+
- `.ai/profiles/*.md`(如当前项目自动识别或显式启用了 profile)
|
|
17
18
|
- 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
|
|
18
19
|
|
|
19
20
|
## Gemini 入口适配
|
|
20
21
|
|
|
21
22
|
- 本文件只负责让 Gemini 发现当前项目的公共规则和 `.ai/` 目录。
|
|
22
|
-
- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review
|
|
23
|
+
- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review,以及 AIOS 自动识别或用户明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效;普通非建筑任务不强制使用 `aios-*` Skill。
|
|
23
24
|
- 接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
|
|
24
25
|
- 任务适合 ArchSight 技能包时,按 `.ai/skills.md` 选择对应 `aios-*` Skill;涉及流程协作时,按 `.ai/workflows.md` 选择 Workflow。
|
|
25
26
|
- 使用浏览器或外部工具前,先说明目的;操作后汇报结果。
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# OPENCODE.md
|
|
2
|
+
|
|
3
|
+
> 本文件供 opencode 在当前业务项目中读取项目 AI 规则。
|
|
4
|
+
> 通用编码规则只维护在 `AI_CODING_RULES.md`,本文件不复制规则正文。
|
|
5
|
+
|
|
6
|
+
## 必读入口
|
|
7
|
+
|
|
8
|
+
开始任何工作前,先阅读:
|
|
9
|
+
|
|
10
|
+
- `AI_CODING_RULES.md`
|
|
11
|
+
- `.ai/ARCHSIGHT_AIOS_RULES.md`
|
|
12
|
+
- `.ai/project-context.md`
|
|
13
|
+
- `.ai/agent-routing.md`
|
|
14
|
+
- `.ai/skills.md`
|
|
15
|
+
- `.ai/workflows.md`
|
|
16
|
+
- `.ai/profile-detection.md`
|
|
17
|
+
- `.ai/profiles/*.md`(如当前项目自动识别或显式启用了 profile)
|
|
18
|
+
- 项目自身的 `README.md`、`Makefile`、`scripts/` 或其他工程入口。
|
|
19
|
+
|
|
20
|
+
## opencode 入口适配
|
|
21
|
+
|
|
22
|
+
- 本文件只负责让 opencode 发现当前项目的公共规则和 `.ai/` 目录。
|
|
23
|
+
- ArchSight AIOS 只在 Agent 路由、Skill 选择、Workflow、交付验证、AI Runtime、Code Review,以及 AIOS 自动识别或用户明确启用的 BIM / IFC / 建筑行业 profile 等相关任务中作为补充治理层生效;普通非建筑任务不强制使用 `aios-*` Skill。
|
|
24
|
+
- 接入本模板不代表当前项目属于 ArchSightLabs,也不要求使用 Hermes、飞书或其他特定运行平台。
|
|
25
|
+
- 任务适合 ArchSight 技能包时,按 `.ai/skills.md` 选择对应 `aios-*` Skill;涉及流程协作时,按 `.ai/workflows.md` 选择 Workflow。
|
|
26
|
+
- 执行终端命令时,优先使用项目根目录的 `Makefile` 或 `scripts/` 中的辅助脚本(如存在)。
|