Insigoo 工作助手

> 版本: v2.1 | 安装时自动检测: ✅ 已启用

安装流程

第一步：自动冲突检测

安装本 skill 时，系统会自动执行以下检测：

# 检测旧版 insigoo skill 是否存在
检测路径: ~/.workbuddy/skills/insigoo/

检测结果与处理建议：

处理选项：

• 选项A（推荐）：禁用旧版（保留备份，可恢复）

```bash

mv ~/.workbuddy/skills/insigoo/ ~/.workbuddy/skills/insigoo_DISABLED/

```

• 选项B：删除旧版（不可恢复）

```bash

rm -rf ~/.workbuddy/skills/insigoo/

```

• 选项C：保留两者（可能导致触发混淆，不推荐）

第二步：安装新版

确认无冲突后：

1. 将 insigoo_assistant 目录安装到 ~/.workbuddy/skills/
2. 验证安装成功

第三步：初始化索引（如需要）

首次使用时，如用户需要建立索引，执行首次扫描（静默模式）。

功能概述

通用人机协作技能，整合协作方法论与多级任务索引系统。

一、核心协作约定

约定0：任务审视原则

任务进行中调用时，先审视任务目标和执行标准，再继续。

适用场景：

• 任务执行到一半，用户要求继续或调整方向
• 发现任务目标模糊或执行标准不明确

审视步骤：

1. 读取项目文档，确认任务目标
2. 厘清验收标准、边界条件
3. 与用户确认后继续执行

审视清单：

□ 任务最终交付物是什么？
□ 验收标准是什么？
□ 与用户原始意图是否一致？

约定1：方案前置原则

除有明确产出需求的任务外，先确定执行方案，再执行。

适用场景：

• 用户提出需要多步执行的任务
• 任务涉及数据分析、功能开发、报告撰写等复杂工作

执行方式：

1. 分析任务需求
2. 输出执行方案（含步骤分解、预期产出）
3. 等待用户确认后再执行

约定2：复杂任务建档

对于步骤 ≥ 5 的任务，启动前建立工作标准文档。

文档结构：

# [任务名称] 工作标准
## 任务目标
## 执行方案
## 当前进度
## 关键决策记录
## 下一步

约定3：记忆维护原则

记忆文档更新采用"追加 + 清理"策略。

具体规则：

1. 追加优先：保留历史脉络
2. 主动删除：错误认知、废弃方案、无关历史信息
3. 避免污染：过时信息会影响后续判断

约定4：最小化干扰原则

对已有项目操作时，只对当前任务相关的内容进行操作。

约定5：失败处理机制

单个任务失败超过3次时，主动停止并给出建议。

二、多级索引架构

2.1 四级索引结构

WORK_INDEX.md              ← 中央索引（全局任务目录）
       ↓
QUICK_INDEX.md             ← 项目快速索引
       ↓
context_bridge/*.json      ← 上下文桥接
       ↓
MEMORY.md                  ← 长期记忆

索引读取优先级：

1. 提到任务 → 先读 WORK_INDEX.md 定位项目
2. 获取项目快照 → 读 QUICK_INDEX.md
3. 需要更多细节 → 读 context_bridge JSON
4. 需要完整上下文 → 读 MEMORY.md

2.2 文件位置约定

> {工作区根目录} 通常为 ~/.workbuddy/，可通过环境变量 HOME 获取用户主目录。

2.3 查询代价对比

三、WORK_INDEX.md 格式

# 工作索引 (WORK INDEX)

**最后更新**: YYYY-MM-DD HH:MM:SS
**项目总数**: N

---

## 项目列表

### 项目ID: YYYYMMDDHHMMSS
- **项目名称**: [名称]
- **项目路径**: [绝对路径]
- **关键词**: 关键词1, 关键词2
- **任务目标**: [简要描述]
- **状态**: 未开始 | 进行中 | 已暂停 | 已完成
- **创建时间**: YYYY-MM-DD
- **最后更新**: YYYY-MM-DD HH:MM:SS

---

四、QUICK_INDEX.md 格式

# 快速索引 - [项目名称]

**项目ID**: YYYYMMDDHHMMSS
**更新时间**: YYYY-MM-DD HH:MM:SS

---

## 基本信息

- **创建时间**: YYYY-MM-DD
- **项目类型**: Web应用 | 小程序 | 数据分析 | 文档撰写 | 其他
- **当前状态**: 未开始 | 进行中 | 已暂停 | 已完成

---

## 最近上下文

（最近1-3次对话的关键信息）

---

## 下一步行动

1. [行动1]
2. [行动2]

五、context_bridge 格式

{
  "project_id": "YYYYMMDDHHMMSS",
  "project_name": "[项目名称]",
  "last_sync": "YYYY-MM-DD HH:MM:SS",
  "snapshot": {
    "current_task": "[当前任务]",
    "progress": "[进度描述]",
    "key_decisions": [],
    "next_actions": [],
    "blockers": []
  },
  "sync_history": [],
  "metadata": {
    "version": "1.0",
    "created_at": "YYYY-MM-DD HH:MM:SS",
    "updated_at": "YYYY-MM-DD HH:MM:SS"
  }
}

六、首次安装扫描

首次安装此 skill 时，如用户需要，建立基础索引。

扫描原则

1. 静默执行：扫描过程不在对话中实时输出，避免上下文超限
2. 增量扫描：只扫描包含 .workbuddy/ 目录的文件夹
3. 最小报告：扫描完成后写入报告文件，仅告知结果摘要

扫描报告输出位置

{工作区根目录}/.workbuddy/SCAN_REPORT.md

报告格式

# 首次扫描报告

**扫描时间**: YYYY-MM-DD HH:MM:SS
**发现项目**: N 个

---

## 已建立索引的项目

| 项目ID | 名称 | 状态 |
|--------|------|------|
| ... | ... | ... |

索引文件已创建：
- WORK_INDEX.md
- QUICK_INDEX.md (N 个)
- context_bridge/ (N 个)

---

七、触发条件汇总

八、维护命令

九、原则优先级

1. 用户明确指令 > 协作约定
2. 准确性 > 效率
3. 透明沟通 > 默默猜测

十、参考资料

详细规范参考：

• references/WORK_INDEX_RULES.md - 完整索引规则
• references/CONTEXT_BRIDGE_FORMAT.md - JSON 格式说明

Insigoo 工作助手 v2.1 — 通用人机协作技能

附录：安装冲突处理（手动模式）

> ⚠️ 以下为手动处理参考。本 skill v2.1 已内置自动检测，如上方自动流程未触发，可使用以下步骤。

替换步骤（从旧版 insigoo 升级）

1. 备份旧版配置（可选）

```

复制 ~/.workbuddy/skills/insigoo/ 目录到备份位置

```

1. 删除旧版

```

删除 ~/.workbuddy/skills/insigoo/ 目录

```

1. 安装新版

```

安装 insigoo_assistant v2.x

```

1. 验证索引文件
• 检查 ~/.workbuddy/WORK_INDEX.md 是否存在
• 检查各项目的 QUICK_INDEX.md 是否存在
• 如索引文件正常，说明升级成功

功能对比

回滚方案

如升级后遇到问题，可回滚到旧版：

1. 删除 insigoo_assistant 目录
2. 从备份恢复 insigoo 目录