建筑设计
- 作者仓库星标 0
- 作者仓库 skills
- 领域
- 设计与多媒体
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tommimarkus · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Architecture Design
Build, Extract, Review, and Lookup ArchiMate® and UML® dediren packages. This is
the router; load references only when their conditions apply.
## Package
Canonical source is `docs/architecture/<feature>.dediren/`: edit source and
policies, recreate generated output, use SVG as proof, treat OEF/XMI as optional
compatibility export, and list only actual views in `project.json`.
## Boundary
Owns ArchiMate® and UML® notation when the artifact is a dediren
architecture/design package, package source/policies, SVG/OEF/XMI evidence,
drift, cross-notation `properties.uml.architecture_context` handoff links, and
`ARCH-*` findings. Delegate UI, API, infra, security, test-quality, live cloud
observation, and implementation details that are not being modeled as package
handoff facts.
## Inputs
Pre-flight: inspect prompt, target package/source paths, existing dediren source,
selected notation/profile, rendered SVG/OEF/XMI evidence, validation logs,
requested mode, quality target, and export need. Infer only the default mode. If
target/evidence/scope is missing or ambiguous, ask the user before
edits/findings.
## Modes
- **Build**: create/edit package source from architect intent.
- **Extract**: lift evidenced code/IaC/API/UI/workflow facts; mark
architect-owned content. Put source-backed groups in `model.json` under
`plugins.generic-graph.views[].groups`, not `project.json`.
- **Review**: assess validity, readability, SVG, optional export, and drift;
lead with findings.
- **Lookup**: answer bounded notation/package/reverse-lookup questions only.
Default: architect intent -> Build; source without package -> Extract; supplied
package/readiness/drift -> Review; narrow fact -> Lookup. Refuse forward-only
Business, Motivation, Strategy, or Physical extraction from source; suggest
Build.
## Workflow
1. Read [architecture](../../docs/architecture-reference/architecture.md) and
[workflow](references/procedures/architecture-operational-workflow.md).
2. Run [self-check](references/procedures/self-check.md) before runtime claims;
it uses [dediren-release.sh](references/scripts/dediren-release.sh) to
resolve the pinned GitHub™ release bundle.
3. Select notation from `plugins.generic-graph.semantic_profile`, view kinds,
export request, or prompt. Load `references/notations/archimate.md` for
ArchiMate, `references/notations/uml.md` for UML®, and both for mixed
packages.
4. Preserve ids, labels, source evidence, policies, architect-owned intent, and
explicit cross-notation links.
5. Load task references below. In Extract mode, load
`references/source-weighting.md` before selecting ArchiMate element,
relationship, or view types unless the task is a purely mechanical update to
an existing package. Keep a compact rationale for every non-obvious
source-to-ArchiMate choice. Build/Extract may mutate source; Review/Lookup
do not mutate by default.
6. Validate before quality claims; return [output](references/output-format.md).
7. Stop when required evidence is missing, dediren returns an error envelope,
the notation is unsupported, or a blocking finding prevents requested
readiness.
## References
| Need | Use |
|---|---|
| ArchiMate notation/profile | `references/notations/archimate.md` |
| UML® notation/profile and ArchiMate handoff links | `references/notations/uml.md` |
| Review/readiness | `references/smell-catalog.md`, `references/red-flags.md`, `references/procedures/professional-readiness.md` |
| implementation-readiness review | `references/procedures/implementation-readiness-review.md` |
| Source-weighted ArchiMate element/relation selection | `references/source-weighting.md`; details in `../../docs/architecture-reference/source-weighting.md` |
| Drift | `references/procedures/drift-detection.md` |
| OEF/downstream validation | `references/procedures/external-validation-handoff.md` |
| Dediren release resolver | `references/scripts/dediren-release.sh`; use through self-check before runtime claims, and run `bash -n references/scripts/dediren-release.sh` when editing the resolver |
| .NET extraction | `references/procedures/lifting-rules-dotnet.md` |
| Java extraction | `references/procedures/lifting-rules-java.md` |
| Bicep extraction | `references/procedures/lifting-rules-bicep.md` |
| GitHub Actions extraction | `references/procedures/lifting-rules-gha.md` |
| Process extraction | `references/procedures/lifting-rules-process.md`, `references/procedures/process-view-emission.md`, `references/procedures/seed-views.md` |
| Examples/smoke tests | `references/fixtures/dediren/basic/` |
| Skill maintenance | `references/evals`, `references/source-grounding.md` |
章节与文件索引
按说明文件中的顺序排列。
套餐
边界
输入
模式
工作流程
文件/命令 -> docs/architecture/<feature>.dediren/ · project.json · properties.uml.architecture_context · ARCH-* · model.json · plugins.generic-graph.views[].groups · plugins.generic-graph.semantic_profile · references/notations/archimate.md
内容校验值 -> f4563f71832d
当前原文的自动摘译,尚未人工审校。
套餐
规范源是
docs/architecture/<feature>.dediren/:编辑源和策略,重新创建生成的输出,使用 SVG 作为证明,将 OEF/XMI 视为可选兼容性导出,并在project.json中仅列出实际视图。边界
当工件是 dediren 架构/设计包、包源/策略、SVG/OEF/XMI 证据、漂移、交叉符号
properties.uml.architecture_context切换链接和ARCH-*结果时,拥有 ArchiMate® 和 UML® 符号。委托 UI、API、基础设施、安全性、测试质量、实时云观察以及未建模为包的实现细节输入
飞行前:检查提示、目标包/源路径、现有 dediren 源、选定的符号/配置文件、渲染的 SVG/OEF/XMI 证据、验证日志、请求的模式、质量目标和导出需求。仅推断默认模式。如果目标/证据/范围缺失或不明确,请在编辑/发现之前询问用户。
模式
构建:根据架构师意图创建/编辑包源。摘录:提升证据代码/IaC/API/UI/工作流程事实;标记建筑师拥有的内容。将源支持的组放在
plugins.generic-graph.views[].groups下的model.json中,而不是project.json。审查:评估有效性、可读性、SVG、可选导出和漂移;工作流程
阅读架构和工作流程。在运行时声明之前运行自检;它使用 dediren-release.sh 来解析固定的 GitHub™ 发布包。