persona-setup

name	persona-setup
description	AI 人格操作系统首次运行设置向导。引导用户完成初始工作区配置，包括预设选择（编程助手、行政助理、营销助手或自定义人格）。检测现有安装，收集个性化上下文，使用模板构建工作区结构，配置 SOUL.md、USER.md 和 MEMORY.md 文件。触发关键词：setup、install、preset、get started、first run、fresh install、initialize、wizard、onboard、configure workspace、initial setup、persona configuration、设置、安装、初始化、向导、配置。
allowed-tools	["Bash","Read","Write","Glob","AskUserQuestion"]

AI 人格操作系统设置向导

本技能引导用户完成 AI 人格操作系统的首次运行设置，在 ~/workspace 创建个性化工作区并配置人格文件。

概述

设置向导执行以下操作：

1. 检测现有安装以避免覆盖用户数据
2. 展示预设选择菜单，提供 4 种人格模板
3. 通过交互式问题收集个性化上下文
4. 使用适当的模板和示例构建工作区结构
5. 显示完成摘要并提供可选的高级功能

关键规则

• 绝不要告诉用户运行命令 — 始终使用 Bash 工具直接执行命令
• 未经用户明确许可，绝不要修改现有工作区文件
• 只存在 4 个已记录的预设（coding-assistant、executive-assistant、marketing-assistant、custom）
• 所有操作仅限于 ~/workspace 范围内
• 高级功能（cron、网关、Discord）仅为可选提及，绝不强行推送

阶段 1：安装后检测

步骤 1.1：检查现有工作区

使用 Bash 工具检查 ~/workspace 是否存在并包含核心文件：

if [ -d ~/workspace ]; then
  existing_files = []
  for file in SOUL.md USER.md MEMORY.md; do
    if [ -f ~/workspace/$file ]; then
      existing_files.append(file)
    fi
  done

  if existing_files.length > 0; then
    state.workspace_exists = true
    state.existing_files = existing_files
  fi
fi

步骤 1.2：处理现有安装

如果 state.workspace_exists == true，通知用户：

"检测到 ~/workspace 下已有 AI 人格操作系统工作区，包含以下文件：[列出 state.existing_files]。此设置向导用于全新安装。您希望：

• 跳过设置，使用现有工作区
• 创建备份并重新初始化（将备份到 ~/workspace.backup.TIMESTAMP）
• 取消设置"

根据响应：

• 跳过：以成功消息退出
• 备份：使用 Bash 执行 mv ~/workspace ~/workspace.backup.$(date +%Y%m%d_%H%M%S)，然后进入阶段 2
• 取消：正常退出

如果未检测到现有工作区，进入阶段 2。

阶段 2：预设选择

步骤 2.1：展示预设菜单

向用户展示以下完全一致的预设选择菜单（原文照搬）：

欢迎使用 AI 人格操作系统设置！

请选择一个预设以开始：

1. 编程助手
   - 协助软件开发、调试、代码审查
   - 主动建议测试、文档编写、代码重构
   - 跟踪项目、任务、技术决策

2. 行政助理
   - 管理日程、会议、邮件草稿
   - 主动提醒、截止日期跟踪、优先级管理
   - 处理通讯、报告、战略规划支持

3. 营销助手
   - 内容创作、活动策划、数据分析
   - 主动内容创意、发布提醒、趋势分析
   - 社交媒体管理、SEO 优化、受众洞察

4. 自定义人格
   - 定义自己的人格名称、角色和行为
   - 选择沟通风格和主动程度
   - 完全控制人格和能力

您希望选择哪个预设？（1-4）

步骤 2.2：捕获预设选择

使用 AskUserQuestion 获取选择：

{
  "questions": [
    {
      "id": "preset_choice",
      "question": "您希望选择哪个预设？（1-4）",
      "default": "1"
    }
  ]
}

映射响应：

• 1 → state.preset = "coding-assistant"
• 2 → state.preset = "executive-assistant"
• 3 → state.preset = "marketing-assistant"
• 4 → state.preset = "custom"
• 模糊/不清楚的回答 → state.preset = "coding-assistant"（默认）

将预设存储在 state.preset。

阶段 3：收集个性化上下文

步骤 3.1：询问通用问题（预设 1-3）

对于预设 1、2 或 3，收集基本个性化信息：

{
  "questions": [
    {
      "id": "user_name",
      "question": "您的名字是什么？",
      "default": "User"
    },
    {
      "id": "user_nickname",
      "question": "我该怎么称呼您？（昵称或首选名称）",
      "default": "<与 user_name 相同>"
    },
    {
      "id": "user_role",
      "question": "您的职业角色或职位是什么？",
      "default": "Professional"
    },
    {
      "id": "user_goal",
      "question": "您使用 AI 人格操作系统的主要目标是什么？",
      "default": 
    
  

将响应存储在：

• state.user_name（默认："User"）
• state.user_nickname（默认：与 user_name 相同）
• state.user_role（默认："Professional"）
• state.user_goal（默认："提高生产力"）

设置预设特定的默认值：

• state.persona_name = "Persona"
• state.persona_role = "personal assistant"
• state.comm_style = "c"（平衡型）
• state.proactive_level = "b"（适度）

步骤 3.2：询问扩展问题（预设 4 - 自定义）

对于预设 4（自定义），收集所有个性化信息，包括人格配置：

{
  "questions": [
    {
      "id": "user_name",
      "question": "您的名字是什么？",
      "default": "User"
    },
    {
      "id": "user_nickname",
      "question": "我该怎么称呼您？（昵称或首选名称）",
      "default": "<与 user_name 相同>"
    },
    {
      "id": "user_role",
      "question": "您的职业角色或职位是什么？",
      "default": "Professional"
    },
    {
      "id": "user_goal",
      "question": "您使用 AI 人格操作系统的主要目标是什么？",
      "default": 
    
    
       
       
       
    
    
       
       编程导师行政助理创意伙伴
       
    
    
       
       
       
    
    
       
       
       
    
  

存储所有响应，默认值与步骤 3.1 相同，加上：

• state.persona_name（默认："Persona"）
• state.persona_role（默认："personal assistant"）
• state.comm_style（默认："c"）
• state.proactive_level（默认："b"）

阶段 4：构建工作区结构

步骤 4.1：创建目录结构

使用 Bash 工具创建工作区目录：

mkdir -p ~/workspace/memory
mkdir -p ~/workspace/projects
mkdir -p ~/workspace/context

步骤 4.2：复制预设专属启动包

根据 state.preset，从插件资源复制适当的启动包：

preset_examples = {
  "coding-assistant": "${CLAUDE_PLUGIN_ROOT}/examples/coding-assistant/",
  "executive-assistant": "${CLAUDE_PLUGIN_ROOT}/examples/executive-assistant/",
  "marketing-assistant": "${CLAUDE_PLUGIN_ROOT}/examples/marketing-assistant/",
  "custom": "${CLAUDE_PLUGIN_ROOT}/examples/custom/"
}

source_dir = preset_examples[state.preset]

# 将预设示例目录中的所有文件复制到 ~/workspace
cp -r ${source_dir}/* ~/workspace/

使用 Bash 工具执行复制操作。

步骤 4.3：复制共享模板

复制所有预设都需要的共享模板文件：

# 复制 SOUL.md 模板
cp ${CLAUDE_PLUGIN_ROOT}/assets/SOUL.md.template ~/workspace/SOUL.md

# 复制 MEMORY.md 模板
cp ${CLAUDE_PLUGIN_ROOT}/assets/MEMORY.md.template ~/workspace/MEMORY.md

使用 Bash 工具执行复制操作。

步骤 4.4：个性化模板文件

使用 Bash 工具配合 sed 来个性化已复制的模板：

# 个性化 SOUL.md
sed -i 's/{{PERSONA_NAME}}/'"${state.persona_name}"'/g' ~/workspace/SOUL.md
sed -i 's/{{PERSONA_ROLE}}/'"${state.persona_role}"'/g' ~/workspace/SOUL.md
sed -i 's/{{COMM_STYLE}}/'"${state.comm_style}"'/g' ~/workspace/SOUL.md
sed -i 's/{{PROACTIVE_LEVEL}}/'"${state.proactive_level}"'/g' ~/workspace/SOUL.md

# 个性化 MEMORY.md
sed -i 's/{{USER_NAME}}/'"${state.user_name}"'/g' ~/workspace/MEMORY.md
sed -i 's/{{USER_NICKNAME}}/'"${state.user_nickname}"'/g' ~/workspace/MEMORY.md

通过 Bash 工具使用 && 链接在一个调用中执行所有 sed 命令。

步骤 4.5：生成 USER.md

使用 heredoc 配合收集的信息创建 USER.md。使用 Bash 工具：

cat > ~/workspace/USER.md <<'EOF'
# 用户档案

## 基本信息

**姓名：** ${state.user_name}
**称呼：** ${state.user_nickname}
**角色：** ${state.user_role}
**主要目标：** ${state.user_goal}

## 工作区上下文

**预设：** ${state.preset}
**设置日期：** $(date +%Y-%m-%d)

## 偏好设置

沟通风格：参见 SOUL.md 中的人格配置
主动程度：参见 SOUL.md 中的人格配置

## 活跃项目

<!-- 此部分将在您工作时填充 -->

## 重要上下文

<!-- 添加 AI 应始终记住的任何上下文 -->

---

*此文件由 AI 人格操作系统设置向导生成。您可以随时编辑和扩展。*
EOF

执行前替换实际的变量值。

阶段 5：显示设置摘要

步骤 5.1：验证安装

使用 Bash 工具列出已创建的文件：

ls -la ~/workspace/
ls -la ~/workspace/memory/

将输出存储在 state.workspace_contents。

步骤 5.2：显示成功摘要

向用户展示包含文件检查清单的完成消息：

✓ AI 人格操作系统设置完成！

您的工作区已创建在 ~/workspace，包含以下结构：

核心文件：
  ✓ SOUL.md       - 人格配置和行为
  ✓ USER.md       - 您的档案和偏好
  ✓ MEMORY.md     - 跨会话的持久记忆

目录：
  ✓ memory/       - 会话日志和历史上下文
  ✓ projects/     - 项目专用文件和笔记
  ✓ context/      - 额外上下文文档

预设专属文件：
  [列出 state.workspace_contents 中的额外文件]

您的 ${state.preset} 人格已准备就绪！

下一步：
1. 审查并自定义 SOUL.md 以微调人格行为
2. 更新 USER.md 添加额外上下文
3. 启动新会话 — 您的人格将自动加载

步骤 5.3：提供可选高级功能（不强制）

将高级功能作为可选增强提及，绝不强制：

"您后续可以探索的可选高级功能：

• 心跳监控：定期检查和进度跟踪
• Cron 集成：定时任务和自动化工作流
• 团队模式：多用户工作区支持
• Discord 集成：通知和远程交互

这些都是完全可选的。您当前的设置已完全可用。您想了解其中任何功能的详情，还是准备好开始使用您的人格了？"

根据响应：

• 如果用户询问某个功能，提供简要说明并提及可以稍后配置
• 如果用户准备好开始，以以下信息结束："好的！您的 AI 人格操作系统已就绪。启动新会话，您的人格将从 ~/workspace 自动加载。"

状态管理

在整个执行过程中跟踪以下变量：

state.workspace_exists = false  # 检测到 ~/workspace 时为 true
state.existing_files = []       # 现有核心文件列表
state.preset = ""               # 选定的预设标识
state.user_name = "User"
state.user_nickname = ""        # 默认为 user_name
state.user_role = "Professional"
state.user_goal = "提高生产力"
state.persona_name = "Persona"
state.persona_role = "personal assistant"
state.comm_style = "c"          # a/b/c/d
state.proactive_level = "b"     # a/b/c
state.workspace_contents = ""   # 创建后的 ls 输出

错误处理

缺少插件资源

如果在 ${CLAUDE_PLUGIN_ROOT}/assets/ 或 ${CLAUDE_PLUGIN_ROOT}/examples/ 未找到模板文件：

1. 使用 Glob 搜索插件根目录
2. 如果仍未找到，通知用户："设置向导需要 AI 人格操作系统插件资源。请确保插件已正确安装。"
3. 提供继续最小化设置的选项（创建目录和基本文件，不使用模板）

权限错误

如果 mkdir 或 cp 命令因权限错误失败：

1. 向用户展示错误消息
2. 建议检查目录权限："您可能需要对主目录的写入权限。"
3. 提供替代方案："您想指定不同的工作区位置吗？"

无效的预设选择

如果用户输入无法映射到 1-4：

1. 默认使用预设 1（coding-assistant）
2. 通知用户："默认使用编程助手预设。您可以稍后通过编辑 SOUL.md 来自定义您的人格。"

成功标准

设置完成条件：

• ~/workspace 目录存在且结构正确
• SOUL.md、USER.md 和 MEMORY.md 已创建并个性化
• 预设专属示例文件已复制
• 用户收到确认摘要
• 目录创建和文件操作过程中无错误

注意事项

• 本技能创建新的工作区。如需修改现有工作区，用户应直接编辑文件或使用 persona-update 技能（如果可用）
• 模板替换使用简单的 sed 替换。对于复杂的个性化，考虑使用 Write 工具配合模板渲染
• 预设示例应包含适合各人格类型的启动文件（如 coding-assistant 包含示例项目结构，executive-assistant 包含会议模板等）
• 所有 Bash 操作应通过 Bash 工具执行，绝不要建议用户手动运行命令