企业官网建设流程全解析

agentic-awesome-skills 技能解剖：Andru.ia 解决方案架构师混合引擎（Hybrid Engine v2.0）项目诊断与路线图工作流

【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills

导读

00-andruia-consultant是 agentic-awesome-skills（AAS）仓库中收录的一枚"项目诊断型"技能（skill）：它以 Andru.ia 主解决方案架构师的身份，在项目启动之初对工作区进行体检，判定项目属于"全新创建"（Pure Engine）还是"既有系统演进"（Evolution），随后生成西班牙语的技术路线图与专家 Squad 方案。读完本文，你将掌握这枚技能的完整结构（Frontmatter 元数据、诊断分叉工作流、Squad 同步、工件物化、黄金法则），理解它在 AAS 目录/索引/插件兼容性数据中的登记形态，并能把它直接接入自己的 Claude / Codex 工作流，用于项目启动时的标准化诊断。

一、技能档案：从 Frontmatter 读懂一枚技能的身份

AAS 中的每一枚技能都以SKILL.md为核心载体，其头部 Frontmatter（YAML 元数据）是技能在仓库中被索引、分类、校验的"身份证"。关于技能结构规范，可参见 技能结构指南。

00-andruia-consultant的 Frontmatter 如下（位于 SKILL.md）：

--- id: 00-andruia-consultant name: 00-andruia-consultant description: "Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español." category: andruia risk: safe source: personal date_added: "2026-02-27" ---

逐项解读：

从仓库数据侧印证：在 data/catalog.json 中，该技能登记为{"id": "00-andruia-consultant", "category": "andruia", "risk": "safe", "source": "personal", "path": "skills/00-andruia-consultant/SKILL.md"}，并带有tags: ["00", "andruia", "consultant"]与一组按词拆分生成的triggers（含arquitecto、consultor等），说明目录系统会依据描述自动派生触发词，用于后续的检索与选择。该技能在 data/skills_index.json 与 data/plugin-compatibility.json 中同样被登记，且插件兼容性为codex: supported、claude: supported，setup.type为none——即无需额外安装配置即可在 Claude / Codex 两端运行。

二、When to Use：何时激活这枚技能

SKILL.md 明确规定其适用时机（When to Use）：

Use this skill at the very beginning of a project to diagnose the workspace, determine whether it's a "Pure Engine" (new) or "Evolution" (existing) project, and to set the initial technical roadmap and expert squad.

即：在项目最开始时使用——诊断工作区、判定项目属于"Pure Engine（全新）"还是"Evolution（演进）"、并搭建初始技术路线图与专家 Squad。这决定了它是一枚"启动阶段编排型"技能，与仓库中10-andruia-skill-smith（技能锻造）、20-andruia-niche-intelligence（垂直领域情报）等其他andruia系列技能形成阶段分工。

三、角色定位（Description）与通用指令（El Estándar Maestro）

技能自述身份为Andru.ia 的主解决方案架构师与首席技术顾问，职责是：诊断工作区当前状态，并绘制最优路线图——无论目标是从零创建，还是演进既有系统（Description）。

其下是被称为"El Estándar Maestro（大师标准）"的通用指令（General Instructions），共三条硬性约束：

1. 强制西班牙语（Idioma Mandatorio）：所有沟通、以及生成的tareas.md、plan_implementacion.md等文件，必须使用西班牙语。这是该技能最具辨识度的行为约束——它面向西语用户群，保证交付物语言统一。
2. 环境分析（Análisis de Entorno）：启动时第一动作是检测目标文件夹为空（全新）还是包含既有代码（演进）。
3. 持久化（Persistencia）：始终将诊断结果物化为本地.md文件，而非只停留在对话中。

这三条共同定义了该技能的"输出契约"：西语、先看环境、落盘成文。

四、核心工作流：诊断分叉（Bifurcación de Diagnóstico）

技能的核心逻辑是一个二分岔路：依据环境检测结果进入两条不同的诊断路径（Workflow）。

场景 A：Lienzo Blanco（空白画布 / 空文件夹）

若未检测到任何文件，则激活"Pure Engine"协议，进入诊断访谈，聚焦三个问题：

1. ¿QUÉ vamos a desarrollar?—— 我们要开发什么？
2. ¿PARA QUIÉN es?—— 面向谁？
3. ¿QUÉ RESULTADO esperas?（目标与高级美学）—— 期望什么结果（目标 + 高端质感）？

这三个问题覆盖了"做什么、给谁、做到什么标准"的产品三要素，是后续路线图的事实基础。

场景 B：Proyecto Existente（既有项目 / 检测到代码）

若检测到src、package.json等文件，则切换为**演进顾问（Consultor de Evolución）**模式，流程分为三步：

1. 技术扫描（Escaneo Técnico）：分析当前技术栈（Stack）、架构，以及潜在的技术债务。
2. 处方访谈（Entrevista de Prescripción），三个问题：
   • ¿QUÉ queremos mejorar o añadir sobre lo ya construido? —— 在已有基础上要改进或新增什么？
   • ¿CUÁL es el mayor punto de dolor o limitación técnica actual? —— 当前最大的痛点或技术瓶颈是什么？
   • ¿A QUÉ estándar de calidad queremos elevar el proyecto? —— 要把项目提升到什么质量标准？
3. 诊断交付（Diagnóstico）：在继续推进之前，先给出一份简明的"技术处方（Prescripción Técnica）"。

该场景强调"先处方、后动手"，避免对既有系统盲目重构。

五、Squad 同步与工件物化（Fase de Sincronización）

两个场景在收集到访谈答案后，汇合到同一阶段（Squad Sync & Materialization）：

1. 映射技能（Mapear Skills）：查询技能根注册表（即 AAS 目录，如 data/skills_index.json），依据项目需求提出一个 3～5 人的专家 Squad，例如@ui-ux-pro、@refactor-expert、@security-expert。这种"按需拼装专家"的机制正是 AAS 目录驱动选择（catalog-driven selection）的典型用法。
2. 生成工件（Generar Artefactos，西班牙语）：
   • tareas.md：细化的积压工作清单（Backlog），创建型或重构型；
   • plan_implementacion.md：技术路线图，且遵循"钻石标准"（见下）。

两个文件全部以西班牙语撰写，落盘到工作区，作为后续开发的可执行依据。

六、黄金法则（Reglas de Oro）

技能在末尾收束两条不可违背的元规则（Golden Rules）：

1. 智能上下文（Contexto Inteligente）：不混用之前项目的数据——每个文件夹都是独立实体。这是防止"跨项目上下文污染"的关键约束，与 AAS 生态中"上下文管理"类技能（如context-management-*）的关切一致。
2. 钻石标准（Estándar de Diamante）：始终优先选择可扩展、安全、美学上更优的解决方案。这一标准贯穿诊断结论与路线图的所有技术选型。

七、实战示例与边界（Example / Limitations）

示例请求（Example）：

Diagnostica este progetto IA, stabilisci se è nuovo o esistente e proponi roadmap tecnica e gruppo di competenze necessari. （诊断这个 AI 项目，判定它是新的还是既有的，并提出技术路线图与所需的能力团队。）

注意示例原文是意大利语——技能会以西班牙语回应，这正好示范了"输入语言无关、输出强制西语"的行为契约。

限制声明（Limitations）同样重要，是技能安全使用的护栏：

• 仅在任务与上述范围明确匹配时使用；
• 不要把输出当作环境专属验证、测试或专家评审的替代品；
• 当所需输入、权限、安全边界或成功标准缺失时，停下来请求澄清。

这三条限制将该技能严格定位为"诊断与规划辅助"，而非"自动执行/自动修改"的工具，与其risk: safe的安全分级相互印证。

八、如何在 AAS 仓库中查看与接入这枚技能

1. 查看技能本体：直接阅读 SKILL.md，该技能仅有单文件（无examples/、scripts/等可选目录），属于轻量级纯指令型技能。
2. 在目录中检索：通过 data/catalog.json（总技能清单）或 data/skills_index.json 定位00-andruia-consultant条目，确认其分类、风险等级、触发词与插件支持情况。
3. 插件兼容性：在 data/plugin-compatibility.json 中可见其对 Codex 与 Claude 均标记为supported，且setup.type: none，表示无需额外初始化即可被上述 Agent 加载。
4. 安装/激活到本地：仓库提供了 activate-skills.sh（Linux/macOS）与 activate-skills.bat（Windows）脚本，可将技能目录安装到目标 Agent 的 skills 目录中；接入后在项目启动时向 Agent 发出"诊断本项目"类请求即可触发本技能。
5. 了解技能编写规范：若希望以它为范本创作同类诊断型技能，可参考 技能结构指南 中关于 Frontmatter 字段（name/description/category/risk/source/date_added）与推荐章节（Overview / When to Use / Instructions / Examples）的说明——00-andruia-consultant的"When to Use + 分叉工作流 + 黄金法则 + 限制"结构正是"标准技能"以上的典型形态。

结语

00-andruia-consultant用不足百行的篇幅，完整封装了一条可复用的项目启动诊断流水线：环境探测 → 场景分叉（Pure Engine / Evolution）→ 结构化访谈 → Squad 拼装 → 西语工件落盘，并辅以safe风险分级、智能上下文与钻石标准三条纪律。在 agentic-awesome-skills 的 2000+ 技能生态中，它扮演着"启动阶段总入口"的角色——先于具体的开发、重构、安全技能介入，为整个项目确定方向与人员编排。理解这枚技能，既能直接用于你自己的 AI 项目启动诊断，也能作为学习"如何在 SKILL.md 中设计分支式诊断工作流"的绝佳范本。

【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills