架构智能体框架 ldqanh1408/architect-agent-framework

Architect Agent Framework 插件

候选版本：1.0.0。发布状态：hihi。

English · Tiếng Việt · 安装指南 · Hướng dẫn cài đặt · 贡献指南 · Hướng dẫn đóng góp · 更新日志

用这个插件，在当前核心工作区里准备有边界的架构任务，覆盖 Claude Code（claude）、OpenAI Codex（codex） 和 DeepSeek Harness（dsh） 三个宿主。插件打包了四个目录技能、三个基础技能和一个运行时技能，还内嵌了零安装的运行时引擎（architect_framework/、vendor/sdd-agent/ 和 contracts/）。插件自带的本地 MCP 服务器对外提供提案、调度和观测能力。

按目标宿主的本地插件流程操作。配置启动器时，指向当前这份代码检出的解释器。alpha 包尚未正式发布。

MCP 和钩子清单要求宿主 PATH 上有一个名为 python 的 Python 3.10+ 命令，原生 Windows 也一样。把 ARCHITECT_PYTHON 设为准备好的环境里的解释器。否则启动器会探测自己当前的解释器，并在 uv 可用时用它，在隔离环境里补齐缺失的依赖。想直接执行任何运行时动作，在插件目录下运行 python scripts/architect_runtime.py --bootstrap <command>。

标记文件缺失，需要显式初始化或迁移。标记文件格式错误，需要修复。旧的审批不能授权当前的工作。

快速开始与多宿主安装

直接从本仓库安装打包好的技能、共享模板和 16 条命令，覆盖 Claude Code、OpenAI Codex 和 DeepSeek Harness：

./install.sh --all --agent all # macOS / Linux / WSL / Git Bash
.\install.ps1 -All -Agent all # Windows PowerShell

需要配置可选的实时评审 API 密钥（JEV_API_KEY）时，把 .env.example 复制为 .env（或 ~/.architect-framework/.env）。完整安装细节见 INSTALL.md 和 INSTALL.vi.md。

八条端到端架构工作流（UC-01 .. UC-08）

| 用例 | 命令 | 默认配置档 | 产出 |
| UC-01：从原始想法到澄清后的 SRS | /architect-clarify <idea or brief.md> | seed · solo-author | 苏格拉底式访谈（最多 5 个问题，带默认答案），产出 clarified-requirements.md |
| UC-02：快速通道 MVP 规格 | /architect-quickstart [source] | standard · solo-author | 落地 12–25 个核心页面，打上见证标记，并通过 sdd check |
| UC-03：完整企业级最大规格 | /architect-design --profile maximal --sources <...> --out <dir> | maximal · solo-author | 自主执行 6 个阶段（Intake、Materialize、Waves、Prepare-Check、Gate、Review） |
| UC-04：遗留代码与测试审计 | /architect-audit --against <SRS> | standard / maximal | 对照规格核对实现，记录 CNF-* 冲突 |
| UC-05：单点方案（单个 ADR/API） | /architect-route 与 /architect-execute --standalone | standalone | 路由到 Domain × Task 技能对，写出独立产物 |
| UC-06：规格评审与门禁检查 | /architect-check --full 与 /architect-review [--live] | 当前工作区 | 运行反占位/深度门禁（DTG-01..10）、02-spec-critic 和分片评审器 |
| UC-07：活规格变更请求 | /architect-change <change description> | 增量 | 计算图影响半径，验证 DTG-07 不回归 |
| UC-08：C4 控制台、技能与签核 | /architect-console、/architect-skills、/architect-approve | 工作台（:8767） | 交互式 C4 地图（读取 < 20ms）、297 技能槽管理器、WebAuthn Passkey 签核 |

完整的 16 条命令手册和多 harness 指南见 docs/QUICKSTART-USE-CASES.md。

工作台与人工决策

打开打印出的 localhost 链接。/runs 显示 Overview、Runs、Gate inbox、Documents 和 Settings。/ 显示确切的候选变更和文档决策。

派发签名只允许一次任务尝试。文档验收仍然独立。阅读不会启动任何工作。调度暂停会停止新的派发。正在运行的主机 worker 可以继续。取消会围栏掉迟到的结果。

由人自己在终端启动 architect-runtime console serve <workspace> --enroll。在那里注册配置好的评审者并确认指纹。复制来的密钥需要在每台机器上显式信任。

智能体不能注册密钥、签署决策或验收文档。MCP 不暴露任何人工审批工具。缺少可信密钥时，必需的门禁保持待定。

评审与已安装技能

配置确切的模型、范围、截止时间、尝试次数和预留预算。检查不会调用它。筛查无法证明有依据的正确性。标签签名不会自动让模型合格。

用 architect-runtime skills offer <skill-id> 检查槽位。用 architect-runtime skills install <package.zip> 安装兼容内容。已接受的授权控制写入。

阅读随附的运行时技能和命令目录。写作检查器只覆盖部分内容，不认证 ASD-STE100。

当前核心路径取代了已退役的运行时。缺少独立人工证据的地方，发布资格仍不完整。本地测试使用合成 worker 和虚拟密钥。真实主机、物理设备、原生 OS 运行、真实模型和用户研究需要单独的证据。

当前工作台预览

这些图片使用公开支付示例。
它们显示待处理的合成任务，不是已验收的文档。这些预览是合成的工作台示例。证据索引记录了已验证的来源和产物修订。
打开本地工作台概览，查看待处理任务数量和未完成的就绪状态。

依赖关系、写入范围和部分观测，请使用 /runs。

在派发门禁中审查任务范围。文档验收仍是另一项独立决策。

打包提供的界面

| 界面 | 数量 |
| 命令 | 16 |
| 技能 | 8 |
| MCP 工具 | 29 |

MCP 工具提供核心规划、候选方案和观测能力。人工签名仍保留在可信审查界面中。

文档、问题反馈与社区贡献

| 资源 | English | Tiếng Việt / Template |
| 文档索引 | docs/README.md | docs/QUICKSTART-USE-CASES.md |
| 核心与 E2E 指南 | GUIDE-SDD-CORE.md · GUIDE-CORE-RUNS.md | GUIDE-E2E-PIPELINE.md · CONCEPTS.md |
| 命令行、门禁与支持 | REFERENCE-CLI.md · REFERENCE-GATES.md | SUPPORT-MATRIX.md · TROUBLESHOOTING.md |
| 贡献指南 | CONTRIBUTING.md · docs/CONTRIBUTING.md | CONTRIBUTING.vi.md |
| 行为准则与安全 | CODE_OF_CONDUCT.md · SECURITY.md | CODE_OF_CONDUCT.vi.md · SECURITY.vi.md |
| 变更日志、隐私与许可 | CHANGELOG.md · PRIVACY.md · LICENSE | CHANGELOG.vi.md · NOTICE |
| 报告 Bug / 请求功能 | Bug Report | Feature Request |
| 提议技能 / 适配器 / PR | Skill Proposal · Adapter Proposal | Pull Request Template |