@archsight/aios 1.0.0

package/workflows/frontend-generation.md

@@ -0,0 +1,60 @@
+# Frontend 生成流程
+
+状态：治理基线  
+适用场景：页面生成、组件实现、UI 修改、交互体验优化
+
+---
+
+## 目标
+
+生成面向国内用户的中文 UI，用最小实现满足明确交互目标，并通过视觉和功能验证。
+
+## 角色路由
+
+```text
+Janus / Mason -> Hephaestus -> Argus
+```
+
+- Janus：确认用户场景和产品边界。
+- Mason：定义页面范围、数据依赖和验收标准。
+- Hephaestus：实现 UI 和交互。
+- Argus：审查质量、可访问性、中文一致性和无关改动。
+
+## 输入
+
+- 页面目标。
+- 用户角色。
+- 数据来源。
+- 交互要求。
+- 视觉约束或设计参考。
+
+## 输出
+
+- UI 实现。
+- 中文文案。
+- 功能验证记录。
+- 视觉检查记录。
+
+## 执行步骤
+
+1. 明确页面目标和核心任务。
+2. 复用现有组件、样式和布局模式。
+3. 实现必要 UI，不做营销化空页面。
+4. 保证标签、提示、状态、错误信息统一中文。
+5. 验证桌面和移动端关键视图。
+6. 检查文本不溢出、不遮挡、不混乱。
+
+## 验收标准
+
+- UI 完成明确任务。
+- 文案统一中文。
+- 没有中英文混排问题。
+- 关键交互可用。
+- 布局在目标视口下稳定。
+
+## 禁止事项
+
+- 不生成无实际功能的展示页替代业务界面。
+- 不引入无关组件库或依赖。
+- 不用英文标签替代普通中文文案。
+

package/workflows/quality-readiness.md

@@ -0,0 +1,74 @@
+# Quality Readiness 流程
+
+状态：规划基线
+适用场景：QA 准入、UAT、试运行确认、领导演示、客户验收前、进入下一环境前、发布前质量门禁
+
+---
+
+## 目标
+
+在真正发布、推送 PR、部署或对外演示前，确认当前交付物是否具备可展示、可验收、可回归和可追责的质量证据。
+
+本流程不是发布动作本身，也不替代 `release` 流程。它回答的是：
+
+- 能不能上 UAT 或试运行环境。
+- 能不能给领导、客户或业务专家看。
+- 关键路径是否已经验证。
+- 缺口、风险和回滚准备是否清楚。
+
+## 角色路由
+
+```text
+Mason -> Themis -> Argus -> Hephaestus -> Aegis -> Mason
+```
+
+- Mason：确认验证范围、验收目标、环境和交付窗口。
+- Themis：承担 QA 责任，设计 UAT、试运行确认、测试策略、验收矩阵、回归覆盖和质量门禁。
+- Argus：审查风险、安全、质量缺口和阻断问题。
+- Hephaestus：执行测试、脚本、构建、冒烟和修复动作。
+- Aegis：确认环境、监控、回滚、事故响应和运行风险。
+- Mason：汇总结论，决定是否进入 release / ship / demo。
+
+Themis 和 Aegis 当前是规划角色；在未创建运行时实例前，Themis 的 QA 职责可由 Argus 和 Hephaestus 分担，Aegis 的运行可靠性职责可由 Mason、Hephaestus 和 Argus 分担，但输出必须保留 QA 准入和运行可靠性关注点。
+
+## 输入
+
+- 交付范围和目标环境。
+- 面向对象：内部演示、领导评审、客户验收、UAT、试运行确认、生产发布前。
+- 需求、PRD、验收标准或演示脚本。
+- 变更摘要、风险说明和已知缺口。
+- 可运行命令、测试命令、构建命令和回滚方式。
+
+## 输出
+
+- 验收矩阵。
+- 验证结果。
+- 演示 / UAT / 试运行准入结论。
+- 阻断问题和非阻断风险。
+- 回滚和应急准备。
+
+## 执行步骤
+
+1. 冻结验证范围：明确本轮要证明什么，不顺手扩大。
+2. 定义验收矩阵：核心场景、边界场景、不可接受失败、人工复核点。
+3. 准备环境：确认数据、账号、权限、配置、外部依赖和回滚路径。
+4. 执行验证：测试、构建、lint、typecheck、冒烟、关键路径人工检查。
+5. 风险审查：确认 P0 / P1、权限、安全、数据、性能和回归风险。
+6. 形成准入结论：通过、带风险通过、阻断。
+7. 记录证据：命令、结果、截图、日志、已知缺口和责任人。
+
+## 验收标准
+
+- 验证范围清晰。
+- 验收矩阵覆盖关键路径。
+- UAT / 试运行 / 演示所需环境可用。
+- 阻断问题已处理或明确停止。
+- 已知风险和未验证项被记录。
+- 回滚和应急路径明确。
+
+## 禁止事项
+
+- 不把“能打开页面”当作完整验收。
+- 不在关键路径未验证时对外演示或进入下一环境。
+- 不把缺少测试、缺少数据或缺少权限的问题包装成低风险。
+- 不在没有回滚路径时进入高风险发布。

package/workflows/rag-pipeline.md

@@ -0,0 +1,57 @@
+# RAG / GraphRAG Pipeline Workflow
+
+## 定位
+
+用于建筑行业知识、BIM / IFC、规范条文、业务文档进入 RAG、GraphRAG 或知识图谱链路。
+
+## 触发场景
+
+- 新知识源入库。
+- 设计 chunk、实体、关系、索引和检索策略。
+- 评估 RAG / GraphRAG 答案质量。
+- 构建规范审查、智能审图或行业知识问答能力。
+
+## 参与角色与 Skill
+
+| 阶段 | 主 Agent | Skill |
+| --- | --- | --- |
+| 领域语义建模 | Vitruvius | `aios-knowledge` |
+| Runtime / Pipeline 设计 | Daedalus | `aios-runtime` |
+| 架构边界 | Atlas | `aios-arch` |
+| 任务拆解 | Mason | `aios-plan` |
+| 实现执行 | Hephaestus | `aios-exec` |
+| 风险审查 | Argus | `aios-review` |
+
+## 输入
+
+- 知识源：规范、标准、BIM / IFC、招采、交付、业务文档。
+- 目标问题和用户场景。
+- 数据规模、更新频率、版本和来源。
+- 期望引用、追溯和评估方式。
+
+## 执行顺序
+
+1. Vitruvius 拆解领域对象、术语、条文条件和待核验项。
+2. Daedalus 设计 chunk、抽取、embedding、索引、检索、重排、引用和评估。
+3. Atlas 判断知识层、平台层和 Runtime 层边界。
+4. Mason 拆解实现任务和验证路径。
+5. Hephaestus 执行受控实现或文档落地。
+6. Argus 审查数据污染、Prompt 注入、工具权限和发布风险。
+
+## 输出
+
+- 领域模型。
+- 数据处理流程。
+- 检索和生成链路。
+- 评估指标。
+- 风险与待核验项。
+- 后续任务。
+
+## 验收标准
+
+- 每个知识结论可追溯来源。
+- chunk、实体、关系和索引策略有明确理由。
+- RAG / GraphRAG 有评估方式。
+- 不能自动判断的行业问题被标注。
+- 权限、数据污染和 Prompt 注入风险已审查。
+

package/workflows/release.md

@@ -0,0 +1,58 @@
+# Release 流程
+
+状态：治理基线  
+适用场景：版本发布、部署、交付验收、回滚准备
+
+---
+
+## 目标
+
+确保交付内容可验证、可回滚、风险可控。
+
+## 角色路由
+
+```text
+Mason -> Argus -> Hephaestus -> Mason
+```
+
+- Mason：确认发布范围、依赖和交付清单。
+- Argus：审查质量、安全和风险。
+- Hephaestus：执行构建、部署、脚本和发布动作。
+
+## 输入
+
+- 发布范围。
+- 变更摘要。
+- 测试结果。
+- 回滚策略。
+- 环境和权限说明。
+
+## 输出
+
+- 发布记录。
+- 验证结果。
+- 回滚路径。
+- 已知风险。
+
+## 执行步骤
+
+1. 冻结发布范围。
+2. 确认测试、lint、类型检查或必要人工验证已完成。
+3. 确认配置、环境变量和权限。
+4. 执行发布。
+5. 做发布后验证。
+6. 记录结果和风险。
+
+## 验收标准
+
+- 发布范围清晰。
+- 关键验证通过。
+- 回滚路径明确。
+- 无未说明的高风险项。
+
+## 禁止事项
+
+- 不在验证缺失时发布。
+- 不在回滚路径不清晰时发布高风险变更。
+- 不把未完成事项包装成已完成。
+

package/workflows/review.md

@@ -0,0 +1,70 @@
+# Review 流程
+
+状态：治理基线  
+适用场景：代码审查、架构审查、安全审查、AI 生成内容审查
+
+---
+
+## 目标
+
+在合并或交付前发现真实风险，优先阻止缺陷、越界修改、过度设计和安全问题。
+
+## 与 `code-review` 的关系
+
+`review.md` 是综合评审入口，适用于代码、架构、安全、AI 生成内容和交付完整性的总览审查。
+
+如果任务对象是 PR、diff、commit 或 AI 生成代码，应进入 [Code Review Workflow](code-review.md)，并使用 `aios-review`。
+
+## 角色与 Skill 路由
+
+| 审查对象 | 主 Agent | Skill | 后续 Workflow |
+| --- | --- | --- | --- |
+| PR / diff / AI 生成代码 | Argus | `aios-review` | `code-review` |
+| 架构边界 / 技术选型 | Atlas | `aios-arch` | `architecture-review` |
+| 交付计划 / 测试完整性 | Mason | `aios-plan` | `feature-development` |
+| RAG / MCP / Memory / Tool | Daedalus | `aios-runtime` | `rag-pipeline` |
+| BIM / IFC / 规范语义 | Vitruvius | `aios-knowledge` | `rag-pipeline` |
+
+## 输入
+
+- diff 或 PR。
+- 需求背景。
+- 测试结果。
+- 影响范围说明。
+
+## 输出
+
+- 按严重程度排序的 review finding。
+- 必须修复项。
+- 可选改进项。
+- 测试缺口。
+- 推荐进入的后续 workflow。
+
+## 审查重点
+
+- 是否满足明确需求。
+- 是否存在无关改动。
+- 是否过度设计。
+- 是否引入安全、权限、数据泄露风险。
+- 是否缺少关键测试。
+- 是否破坏既有行为。
+
+## 验收标准
+
+- P0 / P1 问题必须修复后才能继续。
+- P2 问题必须有修复或明确接受风险。
+- P3 建议不得阻塞交付。
+- 每个发现都应能路由到明确 Agent、Skill 或 Workflow。
+
+## 回滚与恢复
+
+- 如果评审发现阻断问题，停止当前交付，回到对应 workflow 的修复阶段。
+- 如果评审对象不清，先回到 Mason 做任务拆解。
+- 如果问题属于架构边界，回到 Atlas 做架构评审。
+- 如果已进入代码修改，回滚策略以具体项目的 Git 分支、PR 和发布策略为准。
+
+## 禁止事项
+
+- 不用风格偏好阻塞交付。
+- 不把可选重构伪装成必须修复。
+- 不忽略 AI 生成代码的越界风险。