@archsight/aios 1.1.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/marketplace.json +60 -0
- package/.claude-plugin/plugin.json +36 -0
- package/CHANGELOG.md +93 -30
- package/OPENCODE.md +23 -0
- package/README.md +106 -48
- package/RELEASE_NOTES.md +52 -0
- package/adapters/README.md +7 -0
- package/adapters/workbuddy/README.md +43 -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 +605 -31
- package/docs/PUBLIC_DISCOVERY.md +207 -0
- package/docs/business-expert-guide.md +5 -3
- package/docs/glossary.md +11 -3
- package/docs/quickstart.md +18 -4
- package/gemini-extension.json +6 -0
- package/package.json +66 -34
- 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 +207 -60
- package/runtime/capability-registry.json +12 -2
- package/runtime/hermes/agent-registry.md +3 -0
- package/runtime/hermes/workspace-binding.md +3 -0
- package/runtime/skill-routing.md +16 -2
- 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 +138 -0
- package/skills/README.md +16 -0
- package/skills/aios-commercial-contract/SKILL.md +107 -0
- package/skills/aios-commercial-contract/agents/openai.yaml +4 -0
- package/skills/aios-commercial-contract/prompts/basic-prompt.md +83 -0
- package/skills/aios-commercial-tender/SKILL.md +107 -0
- package/skills/aios-commercial-tender/agents/openai.yaml +4 -0
- package/skills/aios-commercial-tender/prompts/basic-prompt.md +94 -0
- package/skills/aios-commercial-variation/SKILL.md +106 -0
- package/skills/aios-commercial-variation/agents/openai.yaml +4 -0
- package/skills/aios-commercial-variation/prompts/basic-prompt.md +99 -0
- package/skills/aios-construction-daily/SKILL.md +104 -0
- package/skills/aios-construction-daily/agents/openai.yaml +4 -0
- package/skills/aios-construction-daily/prompts/basic-prompt.md +76 -0
- package/skills/aios-construction-meeting/SKILL.md +104 -0
- package/skills/aios-construction-meeting/agents/openai.yaml +4 -0
- package/skills/aios-construction-meeting/prompts/basic-prompt.md +78 -0
- package/skills/aios-construction-scheme/SKILL.md +97 -0
- package/skills/aios-construction-scheme/agents/openai.yaml +4 -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 +31 -12
- package/templates/project-ai/.ai/workflows.md +7 -4
- 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
- package/workflows/README.md +3 -0
- package/workflows/site-daily-loop.md +101 -0
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "archsight",
|
|
3
|
+
"owner": {
|
|
4
|
+
"name": "ArchSightLabs"
|
|
5
|
+
},
|
|
6
|
+
"metadata": {
|
|
7
|
+
"description": "ArchSight AIOS 公共 skill marketplace / public marketplace for building-industry AI engineering skills."
|
|
8
|
+
},
|
|
9
|
+
"plugins": [
|
|
10
|
+
{
|
|
11
|
+
"name": "archsight-aios",
|
|
12
|
+
"description": "面向建筑行业知识工作从业者与 AI 研发团队的 Skills、Workflow 与多 Agent 工具包 / Building-industry AI agent skills for BIM, IFC, RAG, GraphRAG, project evidence work, code review, and runtime governance.",
|
|
13
|
+
"source": "./",
|
|
14
|
+
"category": "AI & Agent Building",
|
|
15
|
+
"tags": [
|
|
16
|
+
"agent-skills",
|
|
17
|
+
"construction-ai",
|
|
18
|
+
"building-ai",
|
|
19
|
+
"aec",
|
|
20
|
+
"bim",
|
|
21
|
+
"ifc",
|
|
22
|
+
"building-code",
|
|
23
|
+
"project-evidence-work",
|
|
24
|
+
"rag",
|
|
25
|
+
"graphrag",
|
|
26
|
+
"mcp",
|
|
27
|
+
"runtime-governance",
|
|
28
|
+
"codex",
|
|
29
|
+
"claude-code",
|
|
30
|
+
"gemini-cli",
|
|
31
|
+
"antigravity",
|
|
32
|
+
"workbuddy",
|
|
33
|
+
"architecture-review",
|
|
34
|
+
"code-review",
|
|
35
|
+
"design-review"
|
|
36
|
+
],
|
|
37
|
+
"repository": "https://github.com/ArchSightLabs/archsight-aios",
|
|
38
|
+
"homepage": "https://github.com/ArchSightLabs/archsight-aios",
|
|
39
|
+
"license": "Apache-2.0",
|
|
40
|
+
"keywords": [
|
|
41
|
+
"agent skills",
|
|
42
|
+
"construction AI",
|
|
43
|
+
"building code",
|
|
44
|
+
"building-industry AI",
|
|
45
|
+
"AEC AI",
|
|
46
|
+
"project evidence work",
|
|
47
|
+
"BIM",
|
|
48
|
+
"IFC",
|
|
49
|
+
"GraphRAG",
|
|
50
|
+
"architecture review",
|
|
51
|
+
"code review",
|
|
52
|
+
"runtime design",
|
|
53
|
+
"structural review",
|
|
54
|
+
"construction daily",
|
|
55
|
+
"tender review"
|
|
56
|
+
],
|
|
57
|
+
"skills": "./skills/"
|
|
58
|
+
}
|
|
59
|
+
]
|
|
60
|
+
}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "archsight-aios",
|
|
3
|
+
"displayName": "ArchSight AIOS",
|
|
4
|
+
"version": "1.3.0",
|
|
5
|
+
"description": "面向建筑行业知识工作从业者与 AI 研发团队的 Skills、Workflow 与多 Agent 工具包 / Building-industry AI agent skills for BIM, IFC, RAG, GraphRAG, project evidence work, code review, and runtime governance.",
|
|
6
|
+
"author": {
|
|
7
|
+
"name": "ArchSightLabs",
|
|
8
|
+
"url": "https://github.com/ArchSightLabs"
|
|
9
|
+
},
|
|
10
|
+
"homepage": "https://github.com/ArchSightLabs/archsight-aios",
|
|
11
|
+
"repository": "https://github.com/ArchSightLabs/archsight-aios",
|
|
12
|
+
"license": "Apache-2.0",
|
|
13
|
+
"keywords": [
|
|
14
|
+
"agent-skills",
|
|
15
|
+
"construction-ai",
|
|
16
|
+
"building-ai",
|
|
17
|
+
"aec",
|
|
18
|
+
"bim",
|
|
19
|
+
"ifc",
|
|
20
|
+
"building-code",
|
|
21
|
+
"project-evidence-work",
|
|
22
|
+
"rag",
|
|
23
|
+
"graphrag",
|
|
24
|
+
"mcp",
|
|
25
|
+
"runtime-governance",
|
|
26
|
+
"codex",
|
|
27
|
+
"claude-code",
|
|
28
|
+
"gemini-cli",
|
|
29
|
+
"antigravity",
|
|
30
|
+
"workbuddy",
|
|
31
|
+
"architecture-review",
|
|
32
|
+
"code-review",
|
|
33
|
+
"design-review"
|
|
34
|
+
],
|
|
35
|
+
"skills": "./skills/"
|
|
36
|
+
}
|
package/CHANGELOG.md
CHANGED
|
@@ -1,52 +1,115 @@
|
|
|
1
1
|
# 变更记录
|
|
2
2
|
|
|
3
|
-
## 1.
|
|
3
|
+
## 1.3.0
|
|
4
4
|
|
|
5
5
|
### 发布说明
|
|
6
6
|
|
|
7
|
-
本版本把 AIOS
|
|
8
|
-
|
|
9
|
-
本版本同时完成开源许可证和商业边界调整,为后续公开发布、商业使用和二次分发提供更清晰的法律与责任边界。
|
|
7
|
+
本版本把 AIOS 从通用建筑行业技能包进一步扩展为可评测、可对比、可初始化到项目上下文的工程业务管理与 Prompt 治理工具包。重点补齐工程商务、合同、施工日报、会议、变更签证和专项方案场景的基础提示词资产,并新增 prompt 对比与评测脚本,让团队可以用同一套 fixture、run pack、结果校验和 scorecard 判断提示词是否值得沉淀为正式 Skill。
|
|
10
8
|
|
|
11
9
|
### 新增
|
|
12
10
|
|
|
13
|
-
- 新增
|
|
14
|
-
-
|
|
15
|
-
- 新增
|
|
16
|
-
- 新增
|
|
17
|
-
- 新增对 `archsight-solver` 本地 MCP tools 的 AIOS Capability 对接:
|
|
18
|
-
- `solver.beam_deflection`
|
|
19
|
-
- `solver.beam_deflection_serviceability_check`
|
|
20
|
-
- `solver.frame_displacement`
|
|
21
|
-
- `solver.truss_member_force`
|
|
22
|
-
- 新增 CLI 测试覆盖 Capability 调用、MCP tool 映射、未授权 Agent 拒绝和项目模板校验。
|
|
11
|
+
- 新增 `aios-prompt-compare` Skill,用于对比弱提示词、便携强提示词和真实 Skill runtime 输出,并把结果纳入质量准入判断。
|
|
12
|
+
- 新增工程业务管理基础提示词资产,覆盖招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案。
|
|
13
|
+
- 新增 Hestia、Plutus、Themis 等工程业务协同角色入口,强化行政人事协同、商务造价财务内控、法务合规的边界说明。
|
|
14
|
+
- 新增 prompt 评测 fixtures、公开咨询样例、run pack 构建、结果校验、模型输出校验、scorecard 校验和分析脚本。
|
|
23
15
|
|
|
24
16
|
### 调整
|
|
25
17
|
|
|
26
|
-
-
|
|
27
|
-
-
|
|
28
|
-
- README
|
|
29
|
-
- `
|
|
30
|
-
- 架构评审、Feature 开发和 RAG Pipeline workflow 增加 Capability-backed arbitration 要求。
|
|
31
|
-
- 结构力学挠度限值校核使用 `solver.beam_deflection_serviceability_check` 作为正式 Capability 命名,明确它是正常使用挠度校核,不是强度、稳定或规范承载力设计。
|
|
32
|
-
|
|
33
|
-
### 兼容性说明
|
|
34
|
-
|
|
35
|
-
- `solver.beam_deflection_serviceability_check` 是本版本发布的正式挠度正常使用校核接口。
|
|
36
|
-
- `archsight-solver` 仍是本地可选 Adapter,不是 AIOS 安装的强依赖。没有相邻 solver 仓库或未设置 `ARCHSIGHT_SOLVER_HOME` 时,Capability 调用会报告本地 adapter cwd 不存在。
|
|
37
|
-
- 当前 MCP 对接仅声明本地 stdio 调用,不开放远程 HTTP / SSE / Gateway 鉴权模型。
|
|
18
|
+
- 版本升级到 `1.3.0`,同步更新 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI MCP clientInfo。
|
|
19
|
+
- `init` 相关模板和 CLI 能力增强,可更好地根据项目线索推断 AIOS 项目上下文、profile 和入口文件。
|
|
20
|
+
- README、quickstart、glossary、公共发现文档和 runtime 路由补充工程业务管理与 prompt 治理说明。
|
|
21
|
+
- `validate:skills` 扩展校验范围,覆盖新增 skill、manifest、npm metadata 和工程业务管理资产。
|
|
38
22
|
|
|
39
23
|
### 验证
|
|
40
24
|
|
|
41
|
-
- `npm
|
|
25
|
+
- `npm run validate:skills`
|
|
26
|
+
- `npm run validate:prompts`
|
|
27
|
+
- `npm run validate:prompt-run-pack`
|
|
28
|
+
- `npm run validate:public-advisory-run-pack`
|
|
29
|
+
- `npm run validate:prompt-run-results`
|
|
30
|
+
- `npm run validate:prompt-outputs`
|
|
31
|
+
- `npm run validate:prompt-scorecard`
|
|
42
32
|
- `npm run doctor`
|
|
43
33
|
- `npm run smoke:project`
|
|
34
|
+
- `npm test`
|
|
35
|
+
- `npx skills add . --list`
|
|
44
36
|
- `npm pack --dry-run`
|
|
45
|
-
- 真实本地 MCP smoke:`solver.beam_deflection`、`solver.beam_deflection_serviceability_check`、`solver.frame_displacement`、`solver.truss_member_force`
|
|
46
37
|
|
|
47
|
-
## 1.0
|
|
38
|
+
## 1.2.0
|
|
48
39
|
|
|
49
40
|
### 发布说明
|
|
41
|
+
|
|
42
|
+
本版本把 AIOS 的定位从单纯“建筑 AI 研发工具包”扩展为面向建筑行业知识工作从业者与 AI 研发团队的技能包。除了 BIM / IFC、RAG / GraphRAG、智能审图、Runtime 和代码治理,也覆盖招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案等工程资料证据链工作。
|
|
43
|
+
|
|
44
|
+
### 新增
|
|
45
|
+
|
|
46
|
+
- 新增 WorkBuddy 支持:`npx @archsight/aios install --target workbuddy --scope user` 会把 `aios-*` skills 安装到 `~/.workbuddy/skills/`。
|
|
47
|
+
- `install --target all --scope user` 现在会同时安装 WorkBuddy skills。
|
|
48
|
+
- 新增 `adapters/workbuddy/README.md`,说明 WorkBuddy 安装位置、调用示例和维护边界。
|
|
49
|
+
- 新增公共 skill 发现支撑:`gemini-extension.json`、`.claude-plugin/plugin.json`、`.claude-plugin/marketplace.json`、`docs/PUBLIC_DISCOVERY.md` 和 `scripts/validate-skills.mjs`。
|
|
50
|
+
- `package.json` 增加 `agent-skills`、`skills-sh`、`gemini-cli`、`workbuddy`、`building-ai`、`project-evidence-work` 等检索关键词。
|
|
51
|
+
|
|
52
|
+
### 调整
|
|
53
|
+
|
|
54
|
+
- 版本升级到 `1.2.0`,同步更新 npm package、Gemini extension、Claude plugin 和 runtime manifest。
|
|
55
|
+
- About / marketplace / manifest 描述改为默认中文、附带英文检索短语:面向建筑行业知识工作从业者与 AI 研发团队。
|
|
56
|
+
- README 增加 WorkBuddy 安装位置、公共发现说明和发布前验证命令。
|
|
57
|
+
|
|
58
|
+
### 验证
|
|
59
|
+
|
|
60
|
+
- `npm run validate:skills`
|
|
61
|
+
- `npm test`
|
|
62
|
+
- `npx skills add . --list`
|
|
63
|
+
- `node --check scripts\validate-skills.mjs`
|
|
64
|
+
- `npm pack --dry-run`
|
|
65
|
+
|
|
66
|
+
## 1.1.0
|
|
67
|
+
|
|
68
|
+
### 发布说明
|
|
69
|
+
|
|
70
|
+
本版本把 AIOS 从“规则 / Skill / Workflow 工具包”扩展到可调用本地确定性工具证据的治理闭环。重点新增 Capability Registry、Capability Adapter 和仲裁协议,并与 `archsight-solver` 的本地 stdio MCP tools 对齐,让 Euclid / `aios-structural` 在结构力学任务中能够要求或调用梁、平面框架、平面桁架求解结果,而不是由 LLM 直接口算工程结论。
|
|
71
|
+
|
|
72
|
+
本版本同时完成开源许可证和商业边界调整,为后续公开发布、商业使用和二次分发提供更清晰的法律与责任边界。
|
|
73
|
+
|
|
74
|
+
### 新增
|
|
75
|
+
|
|
76
|
+
- 新增 Capability Registry、Capability Registry Schema 和本地 Capability Adapter 配置,定义工具权限、输入 / 输出契约、证据字段和阻断规则。
|
|
77
|
+
- 新增 `governance/arbitration-protocol.md`,按人工硬约束、确定性工具、项目事实、结构化知识和 Agent 判断的证据等级仲裁交付结论。
|
|
78
|
+
- 新增 `aios-structural` Skill 和 Euclid 结构力学路由,用于梁、荷载、边界条件、FEM 输入输出、结构计算工具链和签审风险评审。
|
|
79
|
+
- 新增 `archsight-aios capability:call` 本地调用闭环:校验 Agent / Skill 权限、校验输入 schema、调用 stdio MCP tool、校验输出证据契约并返回仲裁 Decision。
|
|
80
|
+
- 新增对 `archsight-solver` 本地 MCP tools 的 AIOS Capability 对接:
|
|
81
|
+
- `solver.beam_deflection`
|
|
82
|
+
- `solver.beam_deflection_serviceability_check`
|
|
83
|
+
- `solver.frame_displacement`
|
|
84
|
+
- `solver.truss_member_force`
|
|
85
|
+
- 新增 CLI 测试覆盖 Capability 调用、MCP tool 映射、未授权 Agent 拒绝和项目模板校验。
|
|
86
|
+
|
|
87
|
+
### 调整
|
|
88
|
+
|
|
89
|
+
- 项目许可证从 MIT 升级为 Apache-2.0。
|
|
90
|
+
- README 增加商业边界说明,明确商业使用、二次分发、商标 / 品牌、托管服务、专有素材、支持和交付责任不随开源许可证自动授权。
|
|
91
|
+
- README 增加本地调用 `archsight-solver` 的 Capability 示例,并避免写死个人机器路径。
|
|
92
|
+
- `aios-arch`、`aios-review`、`aios-runtime`、`aios-exec` 等 Skill 增加 Capability / Tool Result / Evidence / Decision 的证据链要求。
|
|
93
|
+
- 架构评审、Feature 开发和 RAG Pipeline workflow 增加 Capability-backed arbitration 要求。
|
|
94
|
+
- 结构力学挠度限值校核统一使用 `solver.beam_deflection_serviceability_check`,不再暴露容易误读为强度或稳定承载力校核的 `solver.beam_capacity_check` 命名,明确它是正常使用挠度校核。
|
|
95
|
+
|
|
96
|
+
### 兼容性说明
|
|
97
|
+
|
|
98
|
+
- `solver.beam_capacity_check` 未进入正式发布接口;新接入必须使用 `solver.beam_deflection_serviceability_check`。
|
|
99
|
+
- `archsight-solver` 仍是本地可选 Adapter,不是 AIOS 安装的强依赖。没有相邻 solver 仓库或未设置 `ARCHSIGHT_SOLVER_HOME` 时,Capability 调用会报告本地 adapter cwd 不存在。
|
|
100
|
+
- 当前 MCP 对接仅声明本地 stdio 调用,不开放远程 HTTP / SSE / Gateway 鉴权模型。
|
|
101
|
+
|
|
102
|
+
### 验证
|
|
103
|
+
|
|
104
|
+
- `npm test`
|
|
105
|
+
- `npm run doctor`
|
|
106
|
+
- `npm run smoke:project`
|
|
107
|
+
- `npm pack --dry-run`
|
|
108
|
+
- 真实本地 MCP smoke:`solver.beam_deflection`、`solver.beam_deflection_serviceability_check`、`solver.frame_displacement`、`solver.truss_member_force`
|
|
109
|
+
|
|
110
|
+
## 1.0.1
|
|
111
|
+
|
|
112
|
+
### 发布说明
|
|
50
113
|
|
|
51
114
|
本版本优化 AIOS 的适用性边界:AIOS 明确作为建筑行业增强层,而不是通用任务替代器。安装 AIOS 后,建筑行业相关任务应获得更专业的证据链、工程边界、验证路径和行业判断;普通非建筑任务不再被强制套用 BIM、IFC、规范、审图或工程证据链假设。
|
|
52
115
|
|
|
@@ -85,5 +148,5 @@
|
|
|
85
148
|
|
|
86
149
|
- README 改为外部读者优先,先说明用途、适用人群、三步开始、项目生成内容和常用命令。
|
|
87
150
|
- `package.json` 补充 repository、keywords、homepage、issue tracker 和 MIT license。
|
|
88
|
-
- `aios-design` 将原先偏通用的视觉细节检查,调整为面向建筑行业工作台的“界面决策清晰度”,强调任务入口、证据定位、复核动作、状态反馈、长任务进度、失败恢复和实现验收。
|
|
151
|
+
- `aios-design` 将原先偏通用的视觉细节检查,调整为面向建筑行业工作台的“界面决策清晰度”,强调任务入口、证据定位、复核动作、状态反馈、长任务进度、失败恢复和实现验收。
|
|
89
152
|
- `design-review` workflow 补强图纸定位、模型定位、审查结论、长任务和专家复核检查项,并明确不替代通用 `frontend-design` 或 `frontend-generation`。
|
package/OPENCODE.md
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# OPENCODE.md
|
|
2
|
+
|
|
3
|
+
> 本文件供 **opencode** 在本仓库中工作时参考。
|
|
4
|
+
> 本文件是 opencode 的工具入口适配器,不复制公共规范正文。
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 必读入口
|
|
9
|
+
|
|
10
|
+
开始任何工作前,先阅读:
|
|
11
|
+
|
|
12
|
+
- [AI 编码规范(公共)](./AI_CODING_RULES.md)
|
|
13
|
+
- [项目总览](./README.md)
|
|
14
|
+
- [Agent Routing](./runtime/agent-routing.md)
|
|
15
|
+
- [Workflows](./workflows/README.md)
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## opencode 特别说明
|
|
20
|
+
|
|
21
|
+
- opencode 在执行终端命令时,须优先使用项目根目录的 `Makefile` 或 `scripts/` 中的辅助脚本(如存在)。
|
|
22
|
+
- 生成代码时,严格遵守 `AI_CODING_RULES.md` 第二节「AI 行为准则」,尤其是最小代码和不做假设原则。
|
|
23
|
+
- opencode 不得在未验证的状态下关闭 PR 或标记任务为完成。
|
package/README.md
CHANGED
|
@@ -1,14 +1,16 @@
|
|
|
1
1
|
# ArchSight AIOS
|
|
2
2
|
|
|
3
|
-
ArchSight AIOS
|
|
3
|
+
ArchSight AIOS 是一套面向建筑行业知识工作从业者与 AI 研发团队的规则、Agent、Skill、Workflow 和项目接入工具包。它重点服务 BIM / IFC / Revit / CAD、施工视觉 AI、建筑规范知识库、GraphRAG、智能审图、工程资料证据链和 AI Coding 治理,让 Codex、Claude Code、OpenCode、Antigravity 2.0、WorkBuddy 等 AI Agent 工具在同一个项目或个人 skills 目录里读取同一套规则、项目上下文和验收要求。
|
|
4
4
|
|
|
5
5
|
AIOS 不是全行业项目模板集合。它保留通用的 AI 编码规则、Agent 路由、Workflow、项目 `.ai/` 上下文和交付验证能力,但真正的差异化能力集中在建筑行业语义、工程证据链、规范知识工程、Capability 工具证据和可复核的 AI 研发流程。
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
|
|
7
|
+
工程业务管理 Skill 只作为建筑工程资料治理的增强包,用于招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案的证据链整理、风险提示和人工复核分流。它不是通用 HR、行政、财务或法律咨询 Prompt 集合;涉及工程款、合同法务、证照、人事和组织协同时,只做工程场景内的资料整理、风险标注和人工复核分流,不替代法务、造价、财务、监理、安全、项目经理、总工、HR 或专家签审。
|
|
8
|
+
|
|
9
|
+
## 设计目标
|
|
8
10
|
|
|
9
11
|
AIOS 的目标不是替代 Codex、Claude Code 或 Gemini 自带的通用工程能力,而是让它们在建筑行业平台研发中做出更专业的判断。它面向建筑行业架构师、博士 / 研究型团队和后端开发,把通用架构评审补足为面向 BIM / IFC、建筑规范、审图链路、知识库、RAG / GraphRAG、任务编排、审计证据和长期平台演进的工作方法。
|
|
10
12
|
|
|
11
|
-
没有 `.ai/` 目录时,AIOS Skill 仍应可直接使用:优先读取代码、接口、schema
|
|
13
|
+
没有 `.ai/` 目录时,AIOS Skill 仍应可直接使用:优先读取代码、接口、schema、配置、测试和部署入口;只有 `.ai/profile-detection.md`、项目显式 profile 或任务本身涉及建筑行业语义时,才加载 BIM、IFC、规范知识或智能审图假设。
|
|
12
14
|
|
|
13
15
|
AIOS 是建筑行业增强层,不是通用任务替代器。装了 AIOS 后,建筑行业相关任务应得到更专业的证据、边界、验证和行业判断;普通非建筑任务不应被强行套用 BIM、IFC、规范、审图或工程证据链假设,必要时直接使用宿主工具的通用能力。
|
|
14
16
|
|
|
@@ -23,14 +25,15 @@ AIOS 是建筑行业增强层,不是通用任务替代器。装了 AIOS 后,
|
|
|
23
25
|
| 产品 / 项目 / 设计负责人 | 把业务目标、页面任务、工作台体验、验收标准和 AI 协作流程写进项目规则。 |
|
|
24
26
|
| 企业负责人 / 业务一把手 | 用 `aios-ceo` 深度评价建筑行业软件 / 系统的产品定位、行业专业性、工程可信度、证据链、商业验证、阶段路线和停损信号。 |
|
|
25
27
|
| AI / 软件工程师 | 给建筑 AI 项目接入统一 AI 编码规则、Skills、Workflows 和行业 profile。 |
|
|
26
|
-
| 团队负责人 | 统一多工具、多模型、多 Agent
|
|
28
|
+
| 团队负责人 | 统一多工具、多模型、多 Agent 的工作边界和交付检查方式,并用 `aios-prompt-compare` 判断提示词是否值得沉淀为正式 Skill。 |
|
|
27
29
|
|
|
28
30
|
## 解决什么问题
|
|
29
31
|
|
|
30
32
|
- 不同 AI 工具各读各的规则,导致输出风格和边界不一致。
|
|
31
33
|
- 项目里缺少明确的 `.ai/` 上下文目录,AI 不知道行业知识、验收标准和人工复核点。
|
|
32
|
-
- 建筑行业项目涉及规范、BIM、图纸、模型、施工现场、知识库和 AI 检测,容易把模型推断误当成工程结论;AIOS
|
|
33
|
-
- AI 生成代码、文档或规则后,缺少统一的 review、验证和发布检查路径。
|
|
34
|
+
- 建筑行业项目涉及规范、BIM、图纸、模型、施工现场、知识库和 AI 检测,容易把模型推断误当成工程结论;AIOS 默认内置 profile registry,并通过自动识别结果和任务上下文启用行业规则,而不是让用户先手动合并规则文件。
|
|
35
|
+
- AI 生成代码、文档或规则后,缺少统一的 review、验证和发布检查路径。
|
|
36
|
+
- 普通提示词、便携强提示词和正式 Skill 的效果容易混在一起;`aios-prompt-compare` 用同一输入做 weak / portable / skill-runtime 三栏对照,帮助团队判断哪些能力应沉淀为 Skill。
|
|
34
37
|
|
|
35
38
|
## 三步开始
|
|
36
39
|
|
|
@@ -42,19 +45,30 @@ cd /path/to/your-project
|
|
|
42
45
|
npx @archsight/aios init
|
|
43
46
|
```
|
|
44
47
|
|
|
45
|
-
执行后,当前业务项目会获得统一的 AI 入口文件和 `.ai/` 项目治理目录。已有 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md` 或 `AI_CODING_RULES.md` 的项目不会被覆盖;CLI 会补充缺失文件,并在合适的位置追加 ArchSight AIOS 引用。
|
|
48
|
+
执行后,当前业务项目会获得统一的 AI 入口文件和 `.ai/` 项目治理目录。已有 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 或 `AI_CODING_RULES.md` 的项目不会被覆盖;CLI 会补充缺失文件,并在合适的位置追加 ArchSight AIOS 引用。
|
|
49
|
+
|
|
50
|
+
`init` 默认会读取项目名、README、package / pyproject 和浅层文件名,自动生成 `.ai/profile-detection.md`,并在首次创建 `.ai/project-context.md` 时预填项目名、技术栈、常用命令、代码结构和候选 AIOS 能力。用户不需要先理解 profile,也不需要手动合并 AI 规则文件。
|
|
46
51
|
|
|
47
52
|
如果你不写代码,只参与业务判断,可以先看 [业务专家指南](docs/business-expert-guide.md)。如果你需要一步一步安装和验证,可以看 [快速上手](docs/quickstart.md)。
|
|
48
53
|
|
|
49
|
-
##
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
npx @archsight/aios init
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
54
|
+
## 自动行业识别
|
|
55
|
+
|
|
56
|
+
AIOS 默认内置所有行业 profile 模板。`init` 默认使用 `--profile auto`,根据当前项目和资料线索自动识别是否启用 profile:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
npx @archsight/aios init
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
如果需要人工覆盖,也可以显式指定:
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
npx @archsight/aios init --profile auto
|
|
66
|
+
npx @archsight/aios init --profile none
|
|
67
|
+
npx @archsight/aios init --profile all
|
|
68
|
+
npx @archsight/aios init --profile bim-platform
|
|
69
|
+
npx @archsight/aios init --profile construction-vision
|
|
70
|
+
npx @archsight/aios init --profile rag-knowledge
|
|
71
|
+
```
|
|
58
72
|
|
|
59
73
|
| Profile | 适用项目 |
|
|
60
74
|
| --- | --- |
|
|
@@ -69,10 +83,12 @@ npx @archsight/aios init --profile rag-knowledge
|
|
|
69
83
|
| `AGENTS.md` | Codex 等 Agent 工具读取的项目入口。 |
|
|
70
84
|
| `CLAUDE.md` | Claude Code 读取的项目入口。 |
|
|
71
85
|
| `GEMINI.md` | Gemini 读取的项目入口。 |
|
|
86
|
+
| `OPENCODE.md` | OpenCode 读取的项目入口。 |
|
|
72
87
|
| `AI_CODING_RULES.md` | 项目通用 AI 编码规则。 |
|
|
73
|
-
| `.ai/ARCHSIGHT_AIOS_RULES.md` | ArchSight AIOS 补充规则。 |
|
|
74
|
-
| `.ai/project-context.md` | 项目事实、业务背景和边界。 |
|
|
75
|
-
| `.ai/
|
|
88
|
+
| `.ai/ARCHSIGHT_AIOS_RULES.md` | ArchSight AIOS 补充规则。 |
|
|
89
|
+
| `.ai/project-context.md` | 项目事实、业务背景和边界。 |
|
|
90
|
+
| `.ai/profile-detection.md` | 自动识别的 profile / Skill 候选、命中证据和人工复核边界。 |
|
|
91
|
+
| `.ai/agent-routing.md` | 不同任务该交给哪个 Agent / Skill。 |
|
|
76
92
|
| `.ai/skills.md` | 当前项目可用的 ArchSight Skills。 |
|
|
77
93
|
| `.ai/workflows.md` | 当前项目可用的 Workflow 和验收路径。 |
|
|
78
94
|
|
|
@@ -90,10 +106,11 @@ AIOS 的多 Agent 协作不应停留在 Prompt 角色扮演。Agent 提出架构
|
|
|
90
106
|
| 命令 | 用途 |
|
|
91
107
|
| --- | --- |
|
|
92
108
|
| `help` | 查看 CLI 帮助、可用命令和示例。 |
|
|
93
|
-
| `install` | 安装 ArchSight AIOS 用户级资产到 Codex、Antigravity 2.0、Gemini 和共享目录。 |
|
|
94
|
-
| `doctor` | 检查仓库资产、manifest、用户级安装、Skill 和 Workflow 是否一致。 |
|
|
95
|
-
| `init` | 给具体业务项目接入 AI 规则、`.ai/`
|
|
109
|
+
| `install` | 安装 ArchSight AIOS 用户级资产到 Codex、Claude Code、OpenCode、Antigravity 2.0、Gemini、WorkBuddy 和共享目录。 |
|
|
110
|
+
| `doctor` | 检查仓库资产、manifest、用户级安装、Skill 和 Workflow 是否一致。 |
|
|
111
|
+
| `init` | 给具体业务项目接入 AI 规则、`.ai/` 治理目录、自动 profile 识别和项目上下文草稿。 |
|
|
96
112
|
| `validate` | 验证项目接入模板能否生成并引用当前登记的 Skills / Workflows。 |
|
|
113
|
+
| `validate:skills` | 校验公共 skill 发现入口、frontmatter、跨 host manifest 和 npm metadata 是否一致。 |
|
|
97
114
|
| `capability:call` | 按 Capability Registry 权限边界调用本地 MCP Adapter,并输出 Tool Result 与仲裁 Decision。 |
|
|
98
115
|
|
|
99
116
|
本地调用 `archsight-solver` 示例:
|
|
@@ -110,29 +127,66 @@ npx @archsight/aios capability:call --capability solver.beam_deflection_servicea
|
|
|
110
127
|
|
|
111
128
|
`install --target all --scope user` 会写入当前用户目录:
|
|
112
129
|
|
|
113
|
-
- Codex:`~/.codex/skills/`、`~/.codex/workflows/aios/`
|
|
114
|
-
-
|
|
115
|
-
-
|
|
116
|
-
-
|
|
130
|
+
- Codex:`~/.codex/skills/`、`~/.codex/workflows/aios/`
|
|
131
|
+
- Claude Code:`~/.claude/skills/`
|
|
132
|
+
- OpenCode:`~/.opencode/skills/`
|
|
133
|
+
- Gemini:`~/.gemini/GEMINI.md`、`~/.gemini/archsight-aios/`
|
|
134
|
+
- Antigravity 2.0:`~/.gemini/config/plugins/archsight-aios/`
|
|
135
|
+
- Antigravity 1.x legacy:仅当已存在 `~/.gemini/antigravity/` 时,写入 `~/.gemini/antigravity/skills/`;如果同时检测到 Antigravity 2.0 配置,也会额外写入 2.0 plugin 目录。
|
|
136
|
+
- WorkBuddy:`~/.workbuddy/skills/`
|
|
117
137
|
|
|
118
138
|
`~/.agents/skills/` 和 `~/.agents/workflows/aios/` 是可选的通用 Agent 共享目录,不是所有 AI Agent 都会自动读取。需要这类兼容目录时,单独执行:
|
|
119
139
|
|
|
120
|
-
```bash
|
|
121
|
-
npx @archsight/aios install --target agents --scope user
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
|
|
140
|
+
```bash
|
|
141
|
+
npx @archsight/aios install --target agents --scope user
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
WorkBuddy 固定读取个人 skills 目录,可单独安装:
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
npx @archsight/aios install --target workbuddy --scope user
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Claude Code 和 OpenCode 也可以按需单独写入个人 skills 目录:
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
npx @archsight/aios install --target claude-code --scope user
|
|
154
|
+
npx @archsight/aios install --target opencode --scope user
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
## 公共发现
|
|
158
|
+
|
|
159
|
+
AIOS 保留标准 `skills/` 目录作为公共发现入口,供 `skills.sh`、`npx skills`、Antigravity / agy、Gemini CLI extension、Claude Code plugin marketplace、OpenCode、WorkBuddy 和第三方索引器扫描。
|
|
160
|
+
|
|
161
|
+
```powershell
|
|
162
|
+
npx skills add ArchSightLabs/archsight-aios --list
|
|
163
|
+
npx skills add ArchSightLabs/archsight-aios --skill aios-arch --global
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
跨 host 发现元数据包括根目录 `gemini-extension.json`、`.claude-plugin/plugin.json`、`.claude-plugin/marketplace.json` 和 `package.json` 的 `agent-skills` / `skills-sh` / `gemini-cli` 等关键词。公共发现、GitHub topics、索引请求和发布前检查见 [公共发现与上架清单](docs/PUBLIC_DISCOVERY.md)。
|
|
167
|
+
|
|
168
|
+
## init 默认行为
|
|
125
169
|
|
|
126
170
|
`init` 默认使用 `--mode auto`:
|
|
127
171
|
|
|
128
|
-
- 新项目或没有 AI 工具入口文件时,创建 `AGENTS.md`、`AI_CODING_RULES.md`、`CLAUDE.md`、`GEMINI.md` 和 `.ai/` 模板文件。
|
|
129
|
-
- 已存在 `AGENTS.md`、`AI_CODING_RULES.md`、`CLAUDE.md` 或 `
|
|
130
|
-
-
|
|
131
|
-
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
172
|
+
- 新项目或没有 AI 工具入口文件时,创建 `AGENTS.md`、`AI_CODING_RULES.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 和 `.ai/` 模板文件。
|
|
173
|
+
- 已存在 `AGENTS.md`、`AI_CODING_RULES.md`、`CLAUDE.md`、`GEMINI.md` 或 `OPENCODE.md` 时,创建缺失的 `.ai/` 文件,并在 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`OPENCODE.md` 中追加或刷新 ArchSight AIOS 托管引用块。
|
|
174
|
+
- 默认使用 `--profile auto`:根据项目名、README、package / pyproject、浅层目录和资料文件名生成 `.ai/profile-detection.md`,并自动复制高置信度命中的 profile。
|
|
175
|
+
- 首次创建 `.ai/project-context.md` 时,会自动预填项目名、技术栈、常用命令、代码结构和候选 Skills;重复执行不会覆盖人工修订后的项目上下文。
|
|
176
|
+
- 重复执行不会重复追加托管块,也不会覆盖已有项目规则。
|
|
177
|
+
- 自动模式不修改已有 `AI_CODING_RULES.md` 正文。
|
|
178
|
+
|
|
179
|
+
## 行业边界
|
|
180
|
+
|
|
181
|
+
建筑行业能力通过 `.ai/profile-detection.md`、显式 `--profile` 或明确任务触发。未启用相关 profile 的项目,不应默认加载 BIM、IFC、GraphRAG、审图或建筑规范假设。
|
|
182
|
+
|
|
183
|
+
如需覆盖自动识别:
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
npx @archsight/aios init --profile none
|
|
187
|
+
npx @archsight/aios init --profile all
|
|
188
|
+
npx @archsight/aios init --profile bim-platform
|
|
189
|
+
```
|
|
136
190
|
|
|
137
191
|
前端应用、后端服务、CLI 工具、数据管道等工程形态优先由 Workflow / Skill / Agent 路由处理,不默认扩展为 profile。只有当某类项目存在稳定的行业语义、证据链、评估集或人工复核差异时,才应考虑新增 profile。
|
|
138
192
|
|
|
@@ -149,11 +203,13 @@ npx @archsight/aios init --mode ai-only
|
|
|
149
203
|
如果是从源码仓库运行,而不是通过 npm 包运行:
|
|
150
204
|
|
|
151
205
|
```bash
|
|
152
|
-
npm run install:user
|
|
153
|
-
npm run doctor
|
|
154
|
-
npm run smoke:project
|
|
155
|
-
npm
|
|
156
|
-
|
|
206
|
+
npm run install:user
|
|
207
|
+
npm run doctor
|
|
208
|
+
npm run smoke:project
|
|
209
|
+
npm run validate:skills
|
|
210
|
+
npx skills add . --list
|
|
211
|
+
npm test
|
|
212
|
+
```
|
|
157
213
|
|
|
158
214
|
## 核心材料
|
|
159
215
|
|
|
@@ -163,9 +219,11 @@ npm test
|
|
|
163
219
|
- [AI 编码规范](AI_CODING_RULES.md)
|
|
164
220
|
- [Agents](agents/README.md)
|
|
165
221
|
- [Skills](skills/README.md)
|
|
166
|
-
- [Workflows](workflows/README.md)
|
|
167
|
-
- [Templates](templates/README.md)
|
|
168
|
-
- [Runtime 路由](runtime/agent-routing.md)
|
|
222
|
+
- [Workflows](workflows/README.md)
|
|
223
|
+
- [Templates](templates/README.md)
|
|
224
|
+
- [Runtime 路由](runtime/agent-routing.md)
|
|
225
|
+
- [WorkBuddy 适配说明](adapters/workbuddy/README.md)
|
|
226
|
+
- [公共发现与上架清单](docs/PUBLIC_DISCOVERY.md)
|
|
169
227
|
|
|
170
228
|
## 开源协作
|
|
171
229
|
|
package/RELEASE_NOTES.md
ADDED
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Release Notes
|
|
2
|
+
|
|
3
|
+
## 1.3.0
|
|
4
|
+
|
|
5
|
+
本版本把 AIOS 从通用建筑行业技能包进一步扩展为可评测、可对比、可初始化到项目上下文的工程业务管理与 Prompt 治理工具包。核心变化包括:
|
|
6
|
+
|
|
7
|
+
- 新增 `aios-prompt-compare`,用于对比弱提示词、便携强提示词和真实 Skill runtime 输出。
|
|
8
|
+
- 新增工程业务管理基础提示词资产,覆盖招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案。
|
|
9
|
+
- 新增 prompt 评测 fixtures、公开咨询样例、run pack 构建、结果校验、模型输出校验、scorecard 校验和分析脚本。
|
|
10
|
+
- 增强项目初始化与模板推断能力,让 AIOS 能更稳定地写入项目上下文、profile 和入口文件。
|
|
11
|
+
- 版本号同步升级到 `1.3.0`,覆盖 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI MCP clientInfo。
|
|
12
|
+
|
|
13
|
+
发布前验证建议:
|
|
14
|
+
|
|
15
|
+
- `npm run validate:skills`
|
|
16
|
+
- `npm run validate:prompts`
|
|
17
|
+
- `npm run validate:prompt-run-pack`
|
|
18
|
+
- `npm run validate:public-advisory-run-pack`
|
|
19
|
+
- `npm run validate:prompt-run-results`
|
|
20
|
+
- `npm run validate:prompt-outputs`
|
|
21
|
+
- `npm run validate:prompt-scorecard`
|
|
22
|
+
- `npm run doctor`
|
|
23
|
+
- `npm run smoke:project`
|
|
24
|
+
- `npm test`
|
|
25
|
+
- `npx skills add . --list`
|
|
26
|
+
- `npm pack --dry-run`
|
|
27
|
+
|
|
28
|
+
## 1.2.0
|
|
29
|
+
|
|
30
|
+
本版本把 AIOS 的定位从单纯“建筑 AI 研发工具包”扩展为面向建筑行业知识工作从业者与 AI 研发团队的技能包。除了 BIM / IFC、RAG / GraphRAG、智能审图、Runtime 和代码治理,也覆盖招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案等工程资料证据链工作。
|
|
31
|
+
|
|
32
|
+
### 新增
|
|
33
|
+
|
|
34
|
+
- 新增 WorkBuddy 支持:`npx @archsight/aios install --target workbuddy --scope user` 会把 `aios-*` skills 安装到 `~/.workbuddy/skills/`。
|
|
35
|
+
- `install --target all --scope user` 现在会同时安装 WorkBuddy skills。
|
|
36
|
+
- 新增 `adapters/workbuddy/README.md`,说明 WorkBuddy 安装位置、调用示例和维护边界。
|
|
37
|
+
- 新增公共 skill 发现支撑:`gemini-extension.json`、`.claude-plugin/plugin.json`、`.claude-plugin/marketplace.json`、`docs/PUBLIC_DISCOVERY.md` 和 `scripts/validate-skills.mjs`。
|
|
38
|
+
- `package.json` 增加 `agent-skills`、`skills-sh`、`gemini-cli`、`workbuddy`、`building-ai`、`project-evidence-work` 等检索关键词。
|
|
39
|
+
|
|
40
|
+
### 调整
|
|
41
|
+
|
|
42
|
+
- 版本升级到 `1.2.0`,同步更新 npm package、Gemini extension、Claude plugin 和 runtime manifest。
|
|
43
|
+
- About / marketplace / manifest 描述改为默认中文、附带英文检索短语:面向建筑行业知识工作从业者与 AI 研发团队。
|
|
44
|
+
- README 增加 WorkBuddy 安装位置、公共发现说明和发布前验证命令。
|
|
45
|
+
|
|
46
|
+
### 验证
|
|
47
|
+
|
|
48
|
+
- `npm run validate:skills`
|
|
49
|
+
- `npm test`
|
|
50
|
+
- `npx skills add . --list`
|
|
51
|
+
- `node --check scripts\validate-skills.mjs`
|
|
52
|
+
- `npm pack --dry-run`
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# WorkBuddy 适配说明
|
|
2
|
+
|
|
3
|
+
WorkBuddy 可以从个人 skills 目录读取 Markdown skill。ArchSight AIOS 可以直接安装到 `~/.workbuddy/skills/<skill-name>/SKILL.md`,作为可按需加载的建筑 AI 研发技能包。
|
|
4
|
+
|
|
5
|
+
## 安装
|
|
6
|
+
|
|
7
|
+
安装 AIOS skills:
|
|
8
|
+
|
|
9
|
+
```powershell
|
|
10
|
+
npx @archsight/aios install --target workbuddy --scope user
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
`install --target all --scope user` 也会安装 WorkBuddy skills。
|
|
14
|
+
|
|
15
|
+
## 安装位置
|
|
16
|
+
|
|
17
|
+
| 模式 | 位置 |
|
|
18
|
+
| --- | --- |
|
|
19
|
+
| 个人目录 | `~/.workbuddy/skills/<skill-name>/SKILL.md` |
|
|
20
|
+
|
|
21
|
+
WorkBuddy 目标固定写入个人目录;不区分项目级目录。AIOS CLI 仍保留统一参数形式,所以命令中需要写 `--scope user`。
|
|
22
|
+
|
|
23
|
+
## 使用
|
|
24
|
+
|
|
25
|
+
在 WorkBuddy 中按 skill 名称调用或明确指定要使用的 AIOS 工具:
|
|
26
|
+
|
|
27
|
+
```text
|
|
28
|
+
使用 aios-arch skill 评审这个 BIM 平台方案的服务边界、数据归属和长期复杂度。
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
```text
|
|
32
|
+
使用 aios-review skill 审查这个 PR 的安全、测试缺口和发布风险。
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
```text
|
|
36
|
+
使用 aios-construction-daily skill 整理这份施工日报的异常、责任人和待确认事项。
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## 维护建议
|
|
40
|
+
|
|
41
|
+
- WorkBuddy 只需要读取 `SKILL.md`,不需要额外放宽工具权限。
|
|
42
|
+
- AIOS 是建筑行业增强层;普通非建筑任务不要强行套 BIM、IFC、规范或审图假设。
|
|
43
|
+
- 如果 WorkBuddy skill 列表过长,可只保留实际使用频率最高的 `aios-*` 目录。
|
package/agents/README.md
CHANGED
|
@@ -41,7 +41,9 @@
|
|
|
41
41
|
| Athena | 知识治理官 | 按需 | 知识源、版本、授权、Memory / RAG 入库和清理治理。 |
|
|
42
42
|
| Mercury | AI 情报官 | 按需 | AI 生态、模型能力、开源项目和工具链情报分析。 |
|
|
43
43
|
| Janus | 产品策略官 | 按需 | 产品目标、MVP 边界、用户场景、商业化和路线判断。 |
|
|
44
|
-
| Themis |
|
|
44
|
+
| Themis | 法务与合规官 | 按需 | 合同条款、责任边界、授权流程、数据合规和法律风险提示。 |
|
|
45
|
+
| Plutus | 商务造价与财务内控官 | 按需 | 工程款、结算、签证、成本、回款、预算和财务内控线索。 |
|
|
46
|
+
| Hestia | 组织行政与人事协同官 | 按需 | 行政、人事、证照、培训、会议待办和组织协同。 |
|
|
45
47
|
| Aegis | 运行可靠性官 | 按需(规划) | 部署、监控、事故响应、回滚演练、SRE 和运行风险治理。 |
|
|
46
48
|
|
|
47
49
|
## 治理责任面
|
|
@@ -52,13 +54,14 @@
|
|
|
52
54
|
| --- | --- | --- |
|
|
53
55
|
| 方向与边界 | Janus / Atlas | 产品目标、MVP、路线、架构边界、技术路线和复杂度。 |
|
|
54
56
|
| 计划与执行 | Mason / Hephaestus | 交付拆解、任务排序、发布路径、受控改代码、脚本执行、测试和交付。 |
|
|
55
|
-
| 质量与风险 | Argus
|
|
57
|
+
| 质量与风险 | Argus | Code Review、安全、性能、技术债、Prompt 注入和代码风险审查。 |
|
|
56
58
|
| AI 工程专项 | Daedalus | RAG、GraphRAG、MCP、Tool Calling、Memory 和 Agent Runtime。 |
|
|
57
59
|
| 行业知识专项 | Vitruvius / Euclid / Athena | BIM / IFC、建筑规范、审图语义、工程数据、结构力学、知识源、版本、授权和 RAG / Memory 入库治理。 |
|
|
60
|
+
| 工程业务专项 | Mason / Themis / Plutus / Hestia | 技术标、合同法务、工程款、结算、签证、会议闭环、行政人事和证照协同。 |
|
|
58
61
|
| 运行可靠性 | Aegis | 部署、监控、事故响应、回滚演练、SRE 和运行风险治理。 |
|
|
59
62
|
| 外部情报 | Mercury | 模型能力、AI 生态、开源项目和工具链趋势。 |
|
|
60
63
|
|
|
61
|
-
|
|
64
|
+
Aegis 当前只作为规划角色记录,不进入默认路由,也不要求项目立即创建运行时实例。等真实项目对生产运行和事故治理提出稳定需求后,再补齐角色 Source、Runtime Prompt、Skill 和 Workflow。
|
|
62
65
|
|
|
63
66
|
每个核心 Agent 目录至少包含:
|
|
64
67
|
|