mcpField
S
skill-knowledge-work

skill-knowledge-work

github.com/nyldn生产力4.3k58 次安装今天更新
代码仓库

关于 skill-knowledge-work

skill-knowledge-work 是 Claude Octopus 的上下文覆盖技能，供需要手动切换开发或知识工作模式的 Codex CLI 用户使用。系统通常会自动判断上下文；该技能可强制指定模式或恢复自动检测，并支持知识工作流程的文档导出。

主要功能

  1. 01强制知识或开发上下文
  2. 02恢复上下文自动检测
  3. 03查看当前上下文模式
  4. 04按领域调整工作流侧重点
  5. 05导出 DOCX、PPTX 和 XLSX

适用场景

  1. 01纠正持续的上下文误判
  2. 02让整个会话固定使用一种模式
  3. 03将研究结果整理为演示文稿
  4. 04从工作会话提取可复用经验

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nyldn/claude-octopus --skill skill-knowledge-work

安装后在 Claude Code 中输入/skill-knowledge-work确认已加载。

附带文件agents/openai.yaml

详细介绍

宿主：Codex CLI —— 此技能原为 Claude Code 设计，后适配用于 Codex。 交叉引用的命令在 Codex 中使用已安装的技能名称，而不是 /octo:* 斜杠命令。 使用当前启用的 Codex shell 和子 Agent 工具。在当前会话尚未提供相应能力之前，不要声称某个提供方、模型或宿主子 Agent 可用。 宿主工具的对应项请参阅 skills/blocks/codex-host-adapter.md。

知识工作模式 - 上下文覆盖技能

上下文自动检测（v7.8+）

Claude Octopus 现在会自动检测工作上下文！ 系统会分析你的提示词和项目，以判断你处于开发上下文（侧重代码）还是知识上下文（侧重研究／策略）。

通常不需要使用此技能——使用以下命令时，系统会自动检测上下文：

  • octo research X - 自动检测开发类还是知识类研究
  • octo build X - 自动检测代码构建还是文档构建
  • octo review X - 自动检测代码审查还是文档审查

何时使用此覆盖设置

仅在自动检测有误时使用：

  • 自动检测选择了开发模式，但你想使用知识模式
  • 自动检测选择了知识模式，但你想使用开发模式
  • 你想为整个会话强制指定某种上下文

覆盖命令

强制使用知识上下文
/octo:km on

重置之前的所有后续工作流都将使用知识上下文。

强制使用开发上下文
/octo:km off

重置之前的所有后续工作流都将使用开发上下文。

返回自动检测
/octo:km auto

上下文检测将恢复为自动模式。

查看当前状态
/octo:km

显示当前模式（自动、知识或开发）。

自动检测的工作方式

使用任何 octo 工作流时，系统会通过分析以下内容检测上下文：

  1. 提示词内容（最强信号）：

    • 知识类指标：“市场”“ROI”“利益相关方”“策略”“用户画像”“演示文稿”“报告”“PRD”
    • 开发类指标：“API”“端点”“数据库”“实现”“代码”“函数”“部署”

  2. 项目类型（次要信号）：

    • 包含 package.json、Cargo.toml、go.mod → 开发上下文
    • 主要由 .md、.docx、.pdf 文件构成 → 知识上下文

  3. 显式覆盖设置（通过 /octo:km 设置时）：

    • 覆盖所有自动检测结果，直至重置为“auto”

视觉指示器显示上下文

工作流运行时，横幅中会显示检测到的上下文：

开发上下文：

🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Dev] Discover Phase: Technical research on caching patterns

知识上下文：

🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Knowledge] Discover Phase: Market analysis for APAC expansion

自动检测示例

示例 1：技术研究（自动 → 开发）

用户：“octo research caching strategies for our Node.js API”

Claude：（根据“Node.js API”自动检测为开发上下文）

🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Dev] Discover Phase: Technical research on caching strategies

[Researches with technical/implementation focus]
示例 2：市场研究（自动 → 知识）

用户：“octo research market opportunities in healthcare AI”

Claude：（根据“market opportunities”自动检测为知识上下文）

🐙 **CLAUDE OCTOPUS ACTIVATED** - Multi-provider research mode
🔍 [Knowledge] Discover Phase: Strategic research on healthcare AI market

[Researches with business/strategic focus]
示例 3：自动检测错误时进行覆盖

用户：“octo research React patterns”
Claude：（自动检测为开发模式）🔍 [Dev] Discover Phase...

用户：“实际上，这是用于演示文稿的。强制使用知识模式。”

Claude：“正在将上下文覆盖设置为知识模式。”

/octo:km on

用户：“octo research React patterns”
Claude：（使用覆盖设置）🔍 [Knowledge] Discover Phase...（重点关注趋势、采用情况和战略影响）

示例 4：查看当前状态

用户：“我当前处于什么上下文模式？”

Claude：

Current mode: Auto-detection (no override set)
Last detected context: Dev (based on project having package.json)

To override: /octo:km on (force Knowledge) or /octo:km off (force Dev)
To return to auto: /octo:km auto

不同上下文的变化

开发上下文 🔧
工作流重点
octo research X技术实现、库、代码模式
octo build X代码生成、架构、测试
octo review X代码质量、安全性、性能
Agentcodex、backend-architect、code-reviewer、security-auditor
知识上下文 🎓
工作流重点
octo research X市场分析、竞争研究、文献综述
octo build XPRD、战略文档、演示文稿、报告
octo review X文档质量、论证力度、完整性
Agentsstrategy-analyst、ux-researcher、exec-communicator、product-writer

文档交付 📄

运行知识工作流后，导出为专业格式：

  • DOCX - 用于报告和商业案例的 Word 文档
  • PPTX - 用于利益相关方演示材料的 PowerPoint 演示文稿
  • XLSX - 用于数据分析的 Excel 电子表格

只需说：“将其导出为 Word”或“创建 PowerPoint 演示文稿”。

覆盖命令参考

命令描述
/octo:km显示当前状态（auto、on 或 off）
/octo:km on强制所有工作流使用知识上下文
/octo:km off强制所有工作流使用开发上下文
/octo:km auto恢复自动检测（默认）

何时不应使用覆盖

不要覆盖，如果：

  • 自动检测正常工作
  • 你正在处理混合任务（让系统单独检测每个提示词）
  • 你只想查看检测到的上下文（查看横幅）

覆盖适用于：

  • 为整个会话强制指定上下文
  • 修正持续的误检测
  • 你确定比自动检测更了解情况的特定用例

跨任务经验总结

在重要工作会话结束时，提取经验：

  1. 这是什么任务类型？（调试、实现、研究、审查）
  2. 哪种方法有效？哪些失败了？
  3. 下次你会如何改进？

将经验存储在 .claude-octopus/learnings/<date>-<summary>.json 中：

{
  "date": "2026-03-21",
  "task_type": "debugging",
  "approach": "Traced the error from the test failure back to the API handler",
  "outcome": "success",
  "lesson": "Always check middleware ordering before investigating handler logic"
}

每个经验文件记录：task_type、approach、outcome 和 lesson。

会话开始：相关性匹配

在会话开始时，检查相关经验：

  • 读取 .claude-octopus/learnings/ 目录
  • 根据任务类型和与当前工作相关的文件模式进行匹配
  • 将最相关的 3 条经验作为上下文注入（约占令牌预算的 5%）
  • 优先考虑近期经验；降低 30 天以前经验的优先级
预算控制
  • 每个会话最多提取 5 条经验（防止写入失控）
  • 最多保留 50 个经验文件（自动删除最旧的文件）
  • 相关性注入最多包含 3 条经验，并占用约 5% 的可用令牌预算
  • 经验文件是轻量级 JSON（每个约 200 字节）

相关技能

  • /octo:discover - 研究工作流（自动检测上下文）
  • /octo:develop - 构建工作流（自动检测上下文）
  • /octo:deliver - 审查工作流（自动检测上下文）
  • /octo:docs - 文档导出（适用于两种上下文）

评论

支持 Markdown