循环助手：高效处理迭代任务

📌 Skill 基础信息

Skill 名称：cyclotic

简称：cyclotic

来源：社区第三方（xornivore/skills）

运行宿主：Claude Code Agent

核心定位：检查 Linear 工作周期（cycle）的准备情况，通过多维度指标评估周期规划的健康度，帮助团队在规划阶段发现问题并及时调整。

🧩 内部核心组成

该 Skill 采用模块化架构，包含以下核心组件：

子 Agent 集合

无独立子 Agent，通过统一的处理管道执行

斜杠命令

命令名	功能简述
cyclotic prep	检查即将开始的活跃周期准备情况
cyclotic prep next	检查下一个即将到来的周期
cyclotic review	回顾最近完成的周期执行情况
cyclotic init	初始化配置和工作组设置
cyclotic configure	配置设置（init 的别名）

MCP 工具依赖

Linear MCP（必需）：用于读取 Linear 工作区数据
incident.io MCP（可选）：用于值班轮换查询

模板文件

factsheet-template.yaml：数据采集模板
config-template.toml：配置模板

Hooks 钩子

无显式钩子定义，通过模式路由处理不同场景

目录结构

cyclotic/
├── assets/           # 模板文件
│   ├── factsheet-template.yaml
│   └── config-template.toml
├── references/       # 参考文档
│   ├── ingest.md
│   ├── capacity.md
│   ├── flags.md
│   ├── presentation.md
│   ├── verbose.md
│   └── init-flow.md
└── tests/fixtures/   # 测试用例

🛠 安装与启用方式

前置依赖：

Claude Code Agent 环境
Linear MCP 已安装并认证

安装步骤：

# 安装 cyclotic skill
npx skills add xornivore/skills@cyclotic --agent claude-code -y

# 安装必需的 Linear MCP
claude mcp add linear --transport sse https://mcp.linear.app/sse

# 可选：安装 incident.io MCP（用于值班轮换检查）
claude mcp add incident-io --transport http https://mcp.incident.io/mcp

配置初始化：

首次运行需执行 cyclotic init 进行交互式配置，生成 ~/.config/cyclotic/GROUP.toml 配置文件。

📋 标准工作流

用户输入指令：用户通过特定短语触发（如 "cyclotic prep"）
模式路由解析：解析用户意图，确定运行模式（prep/review）和人员过滤
配置读取：读取 ~/.config/cyclotic/ 下的工作组配置
数据采集：通过 Linear MCP 一次性读取所有相关数据
容量计算：基于采集数据进行纯算术容量计算
问题标记：评估各种规划问题标记（flags）
报告渲染：按预设顺序输出检查报告
盲点说明：在页脚说明数据采集的局限性

典型使用链路：cyclotic prep → 数据采集 → 容量计算 → 问题检测 → 报告输出

⚠️ 关键限制、缺陷、注意事项

平台限制：

仅支持 Linear 项目管理平台
需要 Claude Code Agent 环境

Token 消耗：中等，因需要读取大量周期数据

适合项目：

使用 Linear 进行敏捷开发的项目
需要周期规划健康度检查的团队
希望避免过度承诺的规划场景

不适合项目：

非 Linear 平台的项目
需要写入或修改 Linear 数据的场景
个人绩效评估或跟踪

已知坑点：

未安装 incident.io MCP 时无法检查值班轮换
未估算的工作量不计入容量计算（显示为 "+"）
配置需要手动初始化

生产环境适用性：✅ 可用，但需确保 MCP 连接稳定

✅ 适用场景 & ❌ 不适合场景

适用场景：

周期规划前的健康度检查
识别过度分配或分配不足的团队成员
发现需要拆分的过大工作项
检查待办事项（backlog）的梳理情况
回顾周期执行情况和遗留工作

不适合场景：

❌ 需要修改 Linear 数据（创建/编辑问题、调整估算）
❌ 个人绩效评估或跨周期跟踪
❌ 速度趋势或估算准确性分析
❌ 非 Linear 平台的项目管理

如何安装

skills install --user xornivore/skills

通用安装教程：在哪里输入上面的命令

上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：

打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
把上面的安装命令复制进去，回车运行，等待下载与注册完成。
重启或重新加载 AI 工具，让新安装的 Skill 被识别。
新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。

Claude 桌面版（macOS / Windows）

桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。

Claude Code（终端 CLI）

直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。

VS Code（含 GitHub Copilot）

打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。

Cursor

底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。

Windsurf

底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。

其他工具（ChatGPT、本地脚本等）

不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。

风险提示

✅ 低风险

自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。