Pilot

Pilot - 技能领航员

前置协议

环境检测

PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo "unknown")
BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
COMMIT=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown")

echo "PROJECT: $PROJECT_ROOT"
echo "BRANCH: $BRANCH"
echo "COMMIT: $COMMIT"

工件目录初始化

mkdir -p memory/artifacts/pilot

经验读取（推荐）

触发时机：分析任务类型前，为当前任务准备最佳实践

推荐动作：调用 experience-manager 技能检索相关经验

执行步骤：

1. 提取任务关键词

``` 从用户请求中提取：

• 核心任务关键词
• 技术栈关键词
• 问题类型关键词

```

1. 写入请求工件

``json Write( file_path="memory/artifacts/pilot/experience-request.json", content={ "requesting_skill": "pilot", "action": "retrieve", "task_keywords": ["关键词1", "关键词2"], "task_type": "bugfix|feature|refactor", "technologies": ["Technology1", "Technology2"] } ) ``

1. 读取经验结果

`` result = Read("memory/artifacts/experience-manager/experience-result.json") ``

1. 应用到技能推荐

```markdown 基于历史经验，推荐以下技能链：

1. /investigate - 快速定位问题（历史成功率 90%）
2. /first-principles - 分析根本原因（历史应用 5 次）
3. /pdca-cycle - 迭代优化

⚠️ 预防措施（来自历史经验）：

• 新项目优先检查国际化配置
• 使用标准配置模板

```

价值：基于历史经验优化技能推荐，提高成功率。

错误预防（自动）

触发时机：检测到潜在错误风险时

自动动作：调用 experience-manager 获取预防建议

执行步骤：

1. 检测风险

``` 在分析任务类型时，检测常见的错误风险：

• 缺少配置检查
• 使用了已废弃的API
• 忽略了边界情况

```

1. 写入预防请求

``json Write( file_path="memory/artifacts/pilot/error-prevention-request.json", content={ "requesting_skill": "pilot", "action": "prevent", "current_step": "任务分析", "context": { "technology": "...", "feature": "...", "risk_factors": [...] } } ) ``

1. 展示预防建议

```markdown ## 💡 错误预防提醒

检测到潜在风险：国际化配置缺失

预防措施：

• 优先检查 next.config.js 中的 i18n 配置
• 使用标准配置模板

历史错误：2026-03-20 类似错误 ```

价值：提前预防错误，避免重复踩坑。

Overview

智能分析用户请求，推荐最佳的方法论技能组合，实现技能协同工作。

核心价值：

• 自动识别任务类型
• 推荐最优技能链
• 提供执行上下文
• 减少决策负担

核心原则：让技能协同工作，发挥 1+1>2 的效果。

When to Use

适用场景：

• 用户发起任何任务请求
• 用户不确定应该使用哪个技能
• 用户希望获得技能推荐
• 复杂任务需要多个技能配合

不适用场景：

• 用户明确指定了要使用的技能
• 简单的问答或信息查询

The Process

digraph orchestrator {
    rankdir=TB;

    "用户请求" [shape=box, style=filled, fillcolor="#c8e6c9"];
    "分析任务类型" [shape=diamond, style=filled, fillcolor="#bbdefb"];
    "匹配技能模板" [shape=box, style=filled, fillcolor="#fff9c4"];
    "推荐技能链" [shape=box, style=filled, fillcolor="#f8bbd0"];
    "用户确认" [shape=diamond, style=filled, fillcolor="#e1bee7"];
    "执行技能链" [shape=box, style=filled, fillcolor="#81c784"];
    "保存工件" [shape=box, style=filled, fillcolor="#81c784"];

    "用户请求" -> "分析任务类型";
    "分析任务类型" -> "匹配技能模板";
    "匹配技能模板" -> "推荐技能链";
    "推荐技能链" -> "用户确认";
    "用户确认" -> "执行技能链" [label="确认"];
    "执行技能链" -> "保存工件";
}

步骤详解

步骤 1: 分析任务类型

识别任务类型：

• 🎯 目标明确 → goal-oriented
• 💡 需要创新 → first-principles
• 🏗️ 架构设计 → ddd-strategic-design
• 🔧 实现细节 → ddd-tactical-design
• 📦 复杂系统 → mvp-first
• 🔄 持续改进 → pdca-cycle
• 📊 战略分析 → swot-analysis

步骤 2: 匹配技能模板

根据任务类型，匹配预设的技能模板：

模板 1: 新系统设计

goal-oriented → first-principles → ddd-strategic-design → ddd-tactical-design → mvp-first → pdca-cycle

模板 2: 性能优化

goal-oriented → first-principles → pdca-cycle

模板 3: 技术选型

goal-oriented → first-principles → swot-analysis

模板 4: 架构重构

goal-oriented → first-principles → ddd-strategic-design → pdca-cycle

步骤 3: 推荐技能链

根据用户请求和任务类型，推荐技能执行顺序。

步骤 4: 用户确认

使用 AskUserQuestion 让用户确认推荐的技能链。

步骤 5: 执行技能链

按顺序内联执行技能（跳过重复的前置协议）。

步骤 6: 保存工件

保存编排结果和执行记录。

技能模板库

模板 1: 新系统设计（完整流程）

适用：用户说"设计一个XX系统"、"从零开始做一个XX"

1. /goal-oriented
   - 明确系统目标和成功标准

2. /first-principles
   - 从本质思考系统设计

3. /ddd-strategic-design
   - 识别限界上下文
   - 设计上下文关系

4. /ddd-tactical-design
   - 设计聚合、实体、值对象
   - 实现领域模型

5. /mvp-first
   - 筛选 MVP 功能
   - 优先级规划

6. /pdca-cycle
   - 迭代实施

模板 2: 性能优化

适用：用户说"优化XX性能"、"提升XX速度"

1. /goal-oriented
   - 明确优化目标（响应时间  "$ARTIFACT_FILE" <<EOF
{
  "skill": "pilot",
  "version": "1.0.0",
  "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
  "project": "$PROJECT_ROOT",
  "branch": "$BRANCH",
  "commit": "$COMMIT",
  "input": {
    "user_request": "用户的原始请求"
  },
  "output": {
    "task_type": "识别的任务类型",
    "recommended_skills": [
      "skill-1",
      "skill-2"
    ],
    "execution_result": "success"
  }
}
EOF

echo "ARTIFACT SAVED: $ARTIFACT_FILE"
ln -sf "$ARTIFACT_FILE" memory/artifacts/pilot/latest.json

目标文件更新

如果存在目标文件，记录编排完成。

建议后续技能

编排器完成后，技能链已执行完毕，通常无需推荐后续技能。

Common Pitfalls

误区 1: 过度编排

表现：为简单任务推荐复杂的技能链

正确做法：

• 简单任务 → 简短技能链（1-2 个技能）
• 复杂任务 → 完整技能链（5-6 个技能）

误区 2: 忽略用户意图

表现：机械地推荐模板，不考虑用户的具体需求

正确做法：

• 分析用户请求的细节
• 根据具体需求调整推荐的技能链

误区 3: 强制执行

表现：不给用户选择的机会，直接执行技能链

正确做法：

• 使用 AskUserQuestion 让用户确认
• 提供自定义选项

References

• gstack 技能编排架构
• superpowers 技能协作模式
• methodolog-skills 技能依赖关系图

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: konglong87
• Source: konglong87/methodology-skills
• License: MIT
• Homepage: https://konglong87.github.io/anything-ai/

Install and usage instructions live in the source repository linked above.