SuperAPI AI 工具集

architecture-compass

编程与开发

查看项目

更新于 10-16 09:35

技能介绍

Architecture Compass 的目标是让架构决策显式、具约束力、可本地追溯并可执行。它面向需要绑定式架构治理的工作,提供五个公开工作流:setup 建立或协调仓库原生 ADR 治理;audit 严格只读地评估架构、ADR 覆盖、漂移与验证;refactor 执行已由本地已接受 ADR 治理的明确有界变更;plan-refactor 协作并持久化已批准的有界重构规格而不实施;plan-run-refactor 规划、持久化、复查并执行已批准的较大或含决策的重构。没有自动工作流,需按任务证据路由,激活时先列出全部五个选项、所选路线、理由与授权范围;意图不明时须询问。

用法上,先读取 ADR 目录,按 Scope、Category、Tags、Applies when 选择条目,Short 先行,Long 在决策约束任务或存在冲突时读取,Guide 仅用于现行流程、示例、命令或兼容说明;Long 为准,Short 不得放宽,Guide 非规范性。不要为窄任务加载整个库。

权限与协作分两条独立轴:宿主/仓库指令、权限、受保护路径与用户授权决定可执行什么;已接受或取代的 ADR 决定预期架构。当前代码只证明当前状态,不证明预期策略。若请求违反已接受 ADR,须显式警告并停止受影响实现,直到接受后续决策或撤回冲突。架构来源按 AC-ADR-046 排序,不得把矛盾来源混合为未记录的折中,也不得借此扩大用户或宿主授予的操作权限。

安全规则明确:不得编造仓库事实、路径、命令、ADR、映射或宿主能力;不得因某公开技能可用或被推荐就安装、调用或配置;不得在可复用产物中暴露密钥、客户数据或内部主机名;破坏性、不可逆、外部、部署、发布、生产及扩大范围的工作需要单独授权。audit 保持可强制执行的只读行为,不创建产物或变更;refactor 仅在已接受本地 ADR 完全覆盖且请求授权整个有界变更时进行,否则停止。

该技能不附带可执行运行时脚本,使用仓库原生验证器前须先理解其行为与写入效果,不得在审计中发明或安装辅助工具。输出按对应报告资产与 AC-ADR-004 证据表组装,包含工作流集与选择、覆盖、写入范围/状态/受保护状态、已检查与不可用证据、决策/映射或发现、已批准计划或变更、AC-ADR-049 台账、风险/延期触发条件与下一授权动作。审计发现按严重度排序,不提供补丁或仓库写入。产品名称、命令与代码内容保持原样;资料未提供的收费、价格与平台信息暂未提供。