建筑设计

设计与多媒体 社区

技能解读

当前原文的自动摘译,尚未人工审校。

套餐

规范源是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™ 发布包。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
设计与多媒体
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tommimarkus · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
即装即用
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
未检出明确要求
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

作者说明文件(原文) SKILL.md

# 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` |

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。