Night Market 技能 — 移植自 claude-night-market/attune。如需完整体验（含智能体、钩子与命令支持），请安装 Claude Code 插件。

架构感知型项目初始化

概述

一种将在线调研、架构范式选择、模板定制与决策记录整合为单一流程的项目初始化方法。当系统架构尚未确定，且该选择需要充分论证时，应使用本技能。

适用场景

• 启动新项目，但尚不确定哪种架构最为合适
• 希望采用现代、业界标准的架构方案
• 需要为架构决策提供明确依据与合理性说明
• 希望模板能根据所选范式进行针对性定制

当架构尚未确定时，请替代使用 project-init； 应在执行 project-specification 之前 使用本技能，以确立项目的架构基础。

必需的 TodoWrite 条目

1. arch-init:research-completed —— 在线调研已完成
2. arch-init:paradigm-selected —— 架构范式已选定
3. arch-init:templates-customized —— 模板已适配所选范式
4. arch-init:decision-recorded —— 已创建架构决策记录（ADR）

五步工作流

步骤 1–2：收集上下文，调研最佳实践

加载 modules/research-flow.md 获取完整的项目上下文问卷及三层搜索策略。输出结果为一份综合简报，作为步骤 3 的输入。

步骤 3：选择架构范式

加载 modules/paradigm-selection.md 查看决策矩阵（按团队规模 × 领域复杂度划分）及特殊场景覆盖规则（如流式处理、Serverless、微内核等）。提供两条路径：

• 使用 archetypes:architecture-paradigms 技能进行引导式探索；
• 直接使用决策矩阵获取快速推荐。

步骤 4–5：定制模板并记录决策

加载 modules/scaffold-generation.md 查看各范式对应的标准目录结构（示例包括 Functional Core / 六边形架构 / 微服务；其余范式由对应的 archetypes:architecture-paradigm-{name} 技能负责）以及 ADR 模板。

输出：初始化包

完成该工作流后，项目将具备以下内容：

1. 与所选架构严格匹配的目录结构
2. 体现该范式的配置项（测试组织方式、工具链、依赖提示等）
3. 一份 ADR，阐明为何选择此架构范式
4. 指向对应范式技能的链接，用于后续开发过程中的持续指导
5. 步骤 2 中调研所得的、与本项目相似的真实世界案例参考

脚本集成

上述交互式工作流为默认模式。如需自动化支持，请加载 modules/script-integration.md 查阅位于 plugins/attune/scripts/ 下的三个 Python 辅助工具（架构研究员、模板定制器、全交互流程执行器），以及库式导入用法示例。

与现有命令的集成

本技能通过在脚手架生成前增加“架构选择”阶段，对 /attune:project-init 进行增强：

# 标准初始化（不涉及架构决策）
/attune:project-init --lang python --name my-project

# 架构感知型初始化
/attune:brainstorm                  # 探索项目需求
Skill(architecture-aware-init)      # 选择架构
/attune:project-init --arch  --name my-project

示例会话

用户：“我正在为一个金融科技应用构建 Python Web API。团队共 8 名开发者，业务规则高度复杂，对安全性与审计追踪能力有严格要求。”

• 步骤 1 上下文：Web API、领域高度复杂、5–15 名工程师、安全与可审计性需求；
• 步骤 2 调研：检索金融科技 API 设计模式、审计追踪架构、CQRS+ES 的 Python 实现案例；
• 步骤 3 选择：结合调研结果与决策矩阵，最终选定 CQRS + Event Sourcing；
• 步骤 4 模板：生成命令处理器模块、查询处理器模块、事件存储、聚合根模式、投影处理器等；
• 步骤 5 ADR：说明选用 CQRS/ES 的原因（满足可审计性、应对复杂业务规则、符合监管合规要求）。

结果：项目以契合所选范式的结构完成初始化，并附带清晰、可追溯的决策依据。

相关技能

• Skill(archetypes:architecture-paradigms) —— 架构范式目录
• Skill(archetypes:architecture-paradigm-*) —— 各范式的具体实施指南
• Skill(attune:project-brainstorming) —— 架构设计前的需求构思
• Skill(attune:project-specification) —— 范式选定后的详细需求定义

参见

• /attune:project-init —— 基础项目初始化命令
• /attune:blueprint —— 范式选定后的架构规划命令
• plugins/archetypes/README.md —— 完整架构范式参考文档