SuperAPI AI 工具集

architecture-aware-init

写作与研究

查看项目

更新于 10-15 17:20

技能介绍

用途:面向新项目初始化,在生成脚手架之前先完成在线调研、架构范式选择、模板定制与决策记录,适合架构尚未确定且需要论证依据的场景。官方建议在架构未定时用它替代 project-init,并在 project-specification 之前使用以确立架构基础。

主要能力:包含四步待办项(调研完成、范式选定、模板定制、决策记录)与五步工作流。步骤1-2收集项目上下文并调研最佳实践,加载 modules/research-flow.md 获取问卷与三层搜索策略,产出综合简报;步骤3加载 modules/paradigm-selection.md,依据团队规模与领域复杂度的决策矩阵及流式、无服务器、微内核等特殊覆盖规则选择范式,可走 archetypes:architecture-paradigms 引导探索或直接用矩阵快速推荐;步骤4-5加载 modules/scaffold-generation.md 定制范式专属目录结构(如 Functional Core、Hexagonal、微服务)并生成 ADR。

使用方式:默认交互式工作流;自动化时可加载 modules/script-integration.md,使用 plugins/attune/scripts/ 下的三个 Python 辅助脚本(架构调研器、模板定制器、完整交互流程)及库式导入示例。与现有命令集成示例: /attune:project-init --lang python --name my-project /attune:brainstorm Skill(architecture-aware-init) /attune:project-init --arch <paradigm> --name my-project

产出:与所选架构匹配的目录结构、反映范式的配置(测试布局、工具、依赖提示)、解释选择理由的 ADR、相关范式技能链接及类似真实项目参考。

限制与退出条件:需勾选全部四项待办;ADR 须引用步骤2调研证据;目录结构须与所选 archetypes:architecture-paradigm-* 技能规定一致;若调研后仍无法确定,须给出前两名候选及权衡并等待用户明确选择,不得静默默认;调研运行时 research.json 保存偏好与规避列表并通过 --research-file 传入,推荐理由须包含命名“research”的规则。具体脚本参数、安装方式与收费信息暂未提供。