pp-outlook-calendar

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/productivity/outlook-calendar/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See AGENTS.md "Generated artifacts: registry.json, cli-skills/". -->
<!-- 生成文件——请勿编辑。 本文件是library/productivity/outlook-calendar/SKILL.md的精确镜像, 由tools/generate-skills/在合并后重新生成。此处的手动编辑会在下次重新生成时被静默覆盖。请改为编辑library/下的源文件。 详见AGENTS.md中的“生成产物:registry.json, cli-skills/”。 -->

Outlook Calendar — Printing Press CLI

Outlook Calendar — Printing Press CLI

Prerequisites: Install the CLI

前提条件:安装CLI

This skill drives the
outlook-calendar-pp-cli
binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
  1. Install via the Printing Press installer:
    bash
    npx -y @mvanhorn/printing-press-library install outlook-calendar --cli-only
  2. Verify:
    outlook-calendar-pp-cli --version
  3. Ensure
    $GOPATH/bin
    (or
    $HOME/go/bin
    ) is on
    $PATH
    .
If the
npx
install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):
bash
go install github.com/mvanhorn/printing-press-library/library/productivity/outlook-calendar/cmd/outlook-calendar-pp-cli@latest
If
--version
reports "command not found" after install, the install step did not put the binary on
$PATH
. Do not proceed with skill commands until verification succeeds.
本Skill驱动
outlook-calendar-pp-cli
二进制文件。在调用本Skill的任何命令前,必须确认CLI已安装。如果未安装,请先执行以下步骤:
  1. 通过Printing Press安装器安装:
    bash
    npx -y @mvanhorn/printing-press-library install outlook-calendar --cli-only
  2. 验证安装:
    outlook-calendar-pp-cli --version
  3. 确保
    $GOPATH/bin
    (或
    $HOME/go/bin
    )已添加到
    $PATH
    环境变量中。
如果
npx
安装失败(无Node环境、离线等情况),可改用直接Go安装方式(要求Go 1.26.3或更高版本):
bash
go install github.com/mvanhorn/printing-press-library/library/productivity/outlook-calendar/cmd/outlook-calendar-pp-cli@latest
如果安装后执行
--version
提示“command not found”,说明安装步骤未将二进制文件添加到
$PATH
中。请在验证成功前不要执行Skill命令。

When to Use This CLI

何时使用本CLI

Reach for outlook-calendar-pp-cli when an agent needs to read or write a personal Microsoft 365 calendar non-interactively. It is the right choice for daily-brief, schedule-this-meeting, find-me-time, what-changed-this-week, and prep-me-for-my-next-meeting tasks. Prefer it over hitting Microsoft Graph directly when you want offline-shaped queries (conflicts, free-time math, recurring drift) that the Graph endpoints don't expose as single calls.
当Agent需要以非交互方式读取或写入个人Microsoft 365日历时,请使用outlook-calendar-pp-cli。它适用于每日简报、会议安排、空闲时间查询、本周日程变更、下一场会议准备等场景。当你需要离线形态的查询(冲突检测、空闲时间计算、重复日程偏移)而Microsoft Graph端点无法通过单次调用实现时,优先选择本工具而非直接调用Microsoft Graph。

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.
这些功能是其他同类型API工具所不具备的。

Local state that compounds

可累积的本地状态

  • conflicts
    — Find overlapping events across all your Outlook calendars in one pass — the double-bookings Outlook's own UI never shows.
    When the agent needs to know whether a proposed time blocks the user, this is the source of truth across every calendar the user owns.
    bash
    outlook-calendar-pp-cli conflicts --from today --to +7d --json --select pair_id,a.subject,b.subject,overlap_minutes
  • freetime
    — Compute N-minute gaps in your working hours over the next K days, honoring all calendars and optional OOF/tentative exclusion.
    When the agent needs to propose a meeting time, this gives a deterministic answer that respects the user's actual working hours.
    bash
    outlook-calendar-pp-cli freetime --duration 60m --within 'Mon-Fri 9-17' --next 7d --exclude-oof --json
  • review
    — Diff against the last delta-sync snapshot: what was added, rescheduled, cancelled, or had its RSVP change.
    Lets the agent answer "what changed since I last looked?" without scanning the whole week.
    bash
    outlook-calendar-pp-cli review --since last-sync --json
  • pending
    — List events whose RSVP is still pending and whose start time is in the future, ordered by start.
    Agent task: "what invites do I still need to answer?" — answered in one query.
    bash
    outlook-calendar-pp-cli pending --json
  • recurring-drift
    — For each recurring-series master, list instances whose start/end/subject/location diverged from the master pattern.
    Catches the silent organizer-side reschedules that cause people to join Teams calls at the wrong hour.
    bash
    outlook-calendar-pp-cli recurring-drift --json
  • with
    — How often have I met with this person, and when did I see them last? Counts and recent N events from local store.
    Agent task: "how often do I meet with X?" without reading the whole calendar.
    bash
    outlook-calendar-pp-cli with alice@example.com --since 90d --json
  • tz-audit
    — Surface events whose start time-zone differs from the calendar's default or from their own end-time TZ — likely-broken displays on other devices.
    Agent task: "are any of my events about to render at the wrong hour for someone?" — yes/no with the offenders.
    bash
    outlook-calendar-pp-cli tz-audit --json
  • conflicts
    — 一次性查找所有Outlook日历中的重叠事件——Outlook原生UI从未显示的双重预订情况。
    当Agent需要确认提议时间是否与用户日程冲突时,这是用户所有日历的权威数据源。
    bash
    outlook-calendar-pp-cli conflicts --from today --to +7d --json --select pair_id,a.subject,b.subject,overlap_minutes
  • freetime
    — 计算未来K天内工作时间中的N分钟空档,同时考虑所有日历及可选的外出/暂定排除规则。
    当Agent需要提议会议时间时,该命令会给出符合用户实际工作时间的确定性结果。
    bash
    outlook-calendar-pp-cli freetime --duration 60m --within 'Mon-Fri 9-17' --next 7d --exclude-oof --json
  • review
    — 与上次增量同步快照对比:列出新增、重新安排、取消或RSVP状态变更的日程。
    让Agent无需扫描整周日程即可回答“自上次查看后有哪些变更?”
    bash
    outlook-calendar-pp-cli review --since last-sync --json
  • pending
    — 列出RSVP状态仍为待定且开始时间在未来的事件,按开始时间排序。
    Agent任务:“我还有哪些邀请需要回复?”——一次查询即可得到答案。
    bash
    outlook-calendar-pp-cli pending --json
  • recurring-drift
    — 针对每个重复系列主日程,列出开始/结束时间、主题、地点偏离主模式的实例。
    捕捉组织者端静默调整日程导致用户在错误时间加入Teams会议的情况。
    bash
    outlook-calendar-pp-cli recurring-drift --json
  • with
    — 我与该人员会面的频率如何?上次会面是什么时候?从本地存储获取次数和最近N次事件。
    Agent任务:“我与X会面的频率是多少?”无需读取整个日历即可得到答案。
    bash
    outlook-calendar-pp-cli with alice@example.com --since 90d --json
  • tz-audit
    — 找出开始时区与日历默认时区或自身结束时区不同的事件——这些事件在其他设备上可能显示错误时间。
    Agent任务:“我的哪些事件可能会让其他人看到错误的时间?”——给出是/否答案及相关事件。
    bash
    outlook-calendar-pp-cli tz-audit --json

Agent-native plumbing

原生Agent适配

  • prep
    — For upcoming events in the next N hours, return a dossier: subject, location, attendee emails, organizer, body excerpt, attachments list, recurrence/online-meeting flags.
    Single tool call that gives an agent everything needed to brief the user on what's coming up.
    bash
    outlook-calendar-pp-cli prep --next 4h --json
  • prep
    — 针对未来N小时内的即将到来的事件,返回一份资料包:主题、地点、参会者邮箱、组织者、正文摘要、附件列表、重复/在线会议标记。
    单次工具调用即可为Agent提供向用户简报所需的全部信息。
    bash
    outlook-calendar-pp-cli prep --next 4h --json

Command Reference

命令参考

attachments — Manage event attachments
  • outlook-calendar-pp-cli attachments delete
    — Delete an attachment
  • outlook-calendar-pp-cli attachments get
    — Get a specific attachment by id
  • outlook-calendar-pp-cli attachments list
    — List attachments on an event
availability — Free/busy and meeting-time intelligence (degraded on personal Microsoft accounts; prefer freetime for self-only queries)
  • outlook-calendar-pp-cli availability find
    — Suggest meeting times based on attendee availability and constraints
  • outlook-calendar-pp-cli availability schedule
    — Get free/busy schedule for a list of users (limited on personal Microsoft accounts)
calendars — Manage Outlook calendars on your account
  • outlook-calendar-pp-cli calendars create
    — Create a new calendar
  • outlook-calendar-pp-cli calendars default
    — Get the user's default calendar
  • outlook-calendar-pp-cli calendars delete
    — Delete a calendar
  • outlook-calendar-pp-cli calendars get
    — Get a calendar by id
  • outlook-calendar-pp-cli calendars list
    — List all calendars on the account
  • outlook-calendar-pp-cli calendars update
    — Update a calendar
categories — Manage Outlook master categories used to tag events
  • outlook-calendar-pp-cli categories create
    — Create a new master category
  • outlook-calendar-pp-cli categories delete
    — Delete a master category
  • outlook-calendar-pp-cli categories list
    — List master categories
delta — Incremental delta-sync of events into the local SQLite store
  • outlook-calendar-pp-cli delta events
    — Pull incremental event changes since the last delta token
  • outlook-calendar-pp-cli delta view
    — Pull incremental calendar-view changes within a window
events — Outlook calendar events on your default or named calendar
  • outlook-calendar-pp-cli events accept
    — Accept a meeting invite
  • outlook-calendar-pp-cli events cancel
    — Cancel an event you organized (notifies attendees)
  • outlook-calendar-pp-cli events create
    — Create a new event on the default calendar
  • outlook-calendar-pp-cli events decline
    — Decline a meeting invite
  • outlook-calendar-pp-cli events delete
    — Delete an event by id
  • outlook-calendar-pp-cli events dismiss
    — Dismiss the reminder for an event
  • outlook-calendar-pp-cli events forward
    — Forward an event to additional attendees
  • outlook-calendar-pp-cli events get
    — Get a single event by id
  • outlook-calendar-pp-cli events instances
    — List occurrences of a recurring event in a date range
  • outlook-calendar-pp-cli events list
    — List events on the default calendar
  • outlook-calendar-pp-cli events range
    — List events occurring within a date range (calendarView; expands recurring instances)
  • outlook-calendar-pp-cli events search
    — Server-side search across events ($search query)
  • outlook-calendar-pp-cli events snooze
    — Snooze the reminder for an event until a specific time
  • outlook-calendar-pp-cli events tentative
    — Tentatively accept a meeting invite
  • outlook-calendar-pp-cli events update
    — Update fields on an existing event (subject, body, time, location, attendees)
attachments — 管理事件附件
  • outlook-calendar-pp-cli attachments delete
    — 删除附件
  • outlook-calendar-pp-cli attachments get
    — 通过ID获取指定附件
  • outlook-calendar-pp-cli attachments list
    — 列出事件的所有附件
availability — 空闲/忙碌状态及会议时间智能分析(个人Microsoft账户功能受限;仅查询自身日程时优先使用freetime命令)
  • outlook-calendar-pp-cli availability find
    — 根据参会者可用性和约束条件建议会议时间
  • outlook-calendar-pp-cli availability schedule
    — 获取用户列表的空闲/忙碌日程(个人Microsoft账户功能受限)
calendars — 管理账户中的Outlook日历
  • outlook-calendar-pp-cli calendars create
    — 创建新日历
  • outlook-calendar-pp-cli calendars default
    — 获取用户的默认日历
  • outlook-calendar-pp-cli calendars delete
    — 删除日历
  • outlook-calendar-pp-cli calendars get
    — 通过ID获取日历
  • outlook-calendar-pp-cli calendars list
    — 列出账户中的所有日历
  • outlook-calendar-pp-cli calendars update
    — 更新日历
categories — 管理用于标记事件的Outlook主类别
  • outlook-calendar-pp-cli categories create
    — 创建新的主类别
  • outlook-calendar-pp-cli categories delete
    — 删除主类别
  • outlook-calendar-pp-cli categories list
    — 列出所有主类别
delta — 将事件增量同步到本地SQLite存储
  • outlook-calendar-pp-cli delta events
    — 拉取自上次增量令牌以来的事件增量变更
  • outlook-calendar-pp-cli delta view
    — 拉取指定时间范围内的日历视图增量变更
events — 默认日历或指定日历中的Outlook日历事件
  • outlook-calendar-pp-cli events accept
    — 接受会议邀请
  • outlook-calendar-pp-cli events cancel
    — 取消你组织的事件(通知参会者)
  • outlook-calendar-pp-cli events create
    — 在默认日历中创建新事件
  • outlook-calendar-pp-cli events decline
    — 拒绝会议邀请
  • outlook-calendar-pp-cli events delete
    — 通过ID删除事件
  • outlook-calendar-pp-cli events dismiss
    — 关闭事件提醒
  • outlook-calendar-pp-cli events forward
    — 将事件转发给额外参会者
  • outlook-calendar-pp-cli events get
    — 通过ID获取单个事件
  • outlook-calendar-pp-cli events instances
    — 列出指定日期范围内重复事件的所有实例
  • outlook-calendar-pp-cli events list
    — 列出默认日历中的事件
  • outlook-calendar-pp-cli events range
    — 列出指定日期范围内发生的事件(calendarView;展开重复实例)
  • outlook-calendar-pp-cli events search
    — 在服务器端搜索事件(使用$search查询)
  • outlook-calendar-pp-cli events snooze
    — 将事件提醒暂停到指定时间
  • outlook-calendar-pp-cli events tentative
    — 暂定接受会议邀请
  • outlook-calendar-pp-cli events update
    — 更新现有事件的字段(主题、正文、时间、地点、参会者)

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
outlook-calendar-pp-cli which "<capability in your own words>"
which
resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code
0
means at least one match; exit code
2
means no confident match — fall back to
--help
or use a narrower query.
当你知道要执行的操作但不确定对应命令时,可直接询问CLI:
bash
outlook-calendar-pp-cli which "<用你自己的语言描述功能>"
which
命令会将自然语言的功能查询解析为CLI精选功能索引中最匹配的命令。退出码
0
表示至少找到一个匹配项;退出码
2
表示没有明确匹配项——请改用
--help
或缩小查询范围。

Recipes

使用示例

Daily brief

每日简报

bash
outlook-calendar-pp-cli prep --next 24h --json --select subject,start,end,location,attendees
Agent-friendly daily snapshot with all the fields a briefing needs and nothing else.
bash
outlook-calendar-pp-cli prep --next 24h --json --select subject,start,end,location,attendees
适合Agent的每日快照,包含简报所需的所有字段,无冗余内容。

Find an hour next week

查找下周的1小时空档

bash
outlook-calendar-pp-cli freetime --duration 60m --within 'Mon-Fri 9-17' --next 7d --exclude-oof --json
Returns gap windows in working hours, OOF excluded — pipe to
jq '.[0]'
for the first opening.
bash
outlook-calendar-pp-cli freetime --duration 60m --within 'Mon-Fri 9-17' --next 7d --exclude-oof --json
返回工作时间内的空档窗口,排除外出时间——可通过管道符
jq '.[0]'
获取第一个可用时段。

What changed since Monday

查看自周一以来的日程变更

bash
outlook-calendar-pp-cli review --since 'Mon 09:00' --json
Diff buckets (added/rescheduled/cancelled/rsvp-changed) that surface organizer-side reschedules.
bash
outlook-calendar-pp-cli review --since 'Mon 09:00' --json
按分类展示变更(新增/重新安排/取消/RSVP变更),突出组织者端的日程调整。

Pending RSVPs

待回复的RSVP邀请

bash
outlook-calendar-pp-cli pending --json --select subject,start,organizer.email
All future events whose RSVP is still pending — narrow output via
--select
so the agent only sees the fields it needs.
bash
outlook-calendar-pp-cli pending --json --select subject,start,organizer.email
所有未来的RSVP待定事件——通过
--select
缩小输出范围,让Agent仅获取所需字段。

Conflict scan with deep
--select

深度筛选的冲突扫描

bash
outlook-calendar-pp-cli conflicts --from today --to +14d --json --select pair.a.subject,pair.b.subject,overlap_minutes,calendar.a,calendar.b
Agents on multi-calendar users (consultant + personal) hit
conflicts
first to know what's actually colliding; dotted
--select
keeps the payload tiny.
bash
outlook-calendar-pp-cli conflicts --from today --to +14d --json --select pair.a.subject,pair.b.subject,overlap_minutes,calendar.a,calendar.b
使用多日历的用户(如顾问+个人日历)的Agent可通过
conflicts
命令首先了解实际冲突情况;点式
--select
参数可保持返回数据量极小。

Auth Setup

认证设置

Authentication uses OAuth 2.0 device-code flow against
https://login.microsoftonline.com/common
. Run
outlook-calendar-pp-cli auth login --device-code
once; visit the displayed URL on any device, enter the code, and you're done. Tokens are cached at
~/.config/outlook-calendar-pp-cli/config.toml
(mode 0600). The CLI auto-refreshes the access token on expiry using the stored refresh token, so subsequent commands run non-interactively. The default client id is the Microsoft-published Graph PowerShell client (works with personal Microsoft accounts out of the box); pass
--client-id
to use your own Azure app registration. Personal Microsoft accounts (Outlook.com, Hotmail, Live, MSA) are first-class and tested.
Run
outlook-calendar-pp-cli doctor
to verify setup.
认证使用OAuth 2.0设备码流连接
https://login.microsoftonline.com/common
。只需执行一次
outlook-calendar-pp-cli auth login --device-code
;在任意设备上访问显示的URL,输入代码即可完成认证。令牌缓存于
~/.config/outlook-calendar-pp-cli/config.toml
(权限模式0600)。CLI会使用存储的刷新令牌在访问令牌过期时自动刷新,因此后续命令可非交互执行。默认客户端ID是微软发布的Graph PowerShell客户端(开箱即可用于个人Microsoft账户);可通过
--client-id
参数使用你自己的Azure应用注册。个人Microsoft账户(Outlook.com、Hotmail、Live、MSA)是一等公民并经过测试。
执行
outlook-calendar-pp-cli doctor
验证设置是否正确。

Agent Mode

Agent模式

Add
--agent
to any command. Expands to:
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    outlook-calendar-pp-cli attachments list mock-value --agent --select id,name,status
  • Previewable
    --dry-run
    shows the request without sending
  • Offline-friendly — sync/search commands can use the local SQLite store when available
  • Non-interactive — never prompts, every input is a flag
  • Explicit retries — use
    --idempotent
    only when an already-existing create should count as success, and
    --ignore-missing
    only when a missing delete target should count as success
在任何命令后添加
--agent
参数。该参数等价于:
--json --compact --no-input --no-color --yes
  • 可管道传输 — 标准输出为JSON,错误信息输出到标准错误
  • 可筛选
    --select
    参数保留字段子集。点式路径可深入嵌套结构;数组可遍历元素。对于冗长的API,这是保持上下文简洁的关键:
    bash
    outlook-calendar-pp-cli attachments list mock-value --agent --select id,name,status
  • 可预览
    --dry-run
    参数显示请求但不发送
  • 离线友好 — 同步/搜索命令可在本地SQLite存储可用时使用本地数据
  • 非交互 — 从不提示,所有输入均通过标志参数提供
  • 显式重试 — 仅当已存在的创建操作应视为成功时使用
    --idempotent
    参数;仅当删除目标不存在应视为成功时使用
    --ignore-missing
    参数

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
Parse
.results
for data and
.meta.source
to know whether it's live or local. A human-readable
N results (live)
summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
从本地存储或API读取数据的命令会将输出包装在来源信封中:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
解析
.results
获取数据,通过
.meta.source
判断数据是实时的还是本地的。只有当标准输出是终端时,才会在标准错误输出中打印人类可读的
N results (live)
摘要;管道传输/Agent消费者仅会在标准输出获取纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
outlook-calendar-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
outlook-calendar-pp-cli feedback --stdin < notes.txt
outlook-calendar-pp-cli feedback list --json --limit 10
Entries are stored locally at
~/.outlook-calendar-pp-cli/feedback.jsonl
. They are never POSTed unless
OUTLOOK_CALENDAR_FEEDBACK_ENDPOINT
is set AND either
--send
is passed or
OUTLOOK_CALENDAR_FEEDBACK_AUTO_SEND=true
. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当你(或Agent)发现本CLI存在问题时,可记录反馈:
outlook-calendar-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
outlook-calendar-pp-cli feedback --stdin < notes.txt
outlook-calendar-pp-cli feedback list --json --limit 10
反馈条目存储在本地
~/.outlook-calendar-pp-cli/feedback.jsonl
文件中。除非设置了
OUTLOOK_CALENDAR_FEEDBACK_ENDPOINT
且传递了
--send
参数或设置
OUTLOOK_CALENDAR_FEEDBACK_AUTO_SEND=true
,否则反馈条目绝不会被POST发送。默认行为是仅存储在本地。
请记录让你感到意外的内容,而非正式的错误报告。简短、具体、单行描述:这才是有价值的反馈。

Output Delivery

输出交付

Every command accepts
--deliver <sink>
. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or
application/x-ndjson
when
--compact
)
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
每个命令都支持
--deliver <sink>
参数。输出会发送到指定的接收端,同时(或替代)输出到标准输出,因此Agent无需手动管道即可路由命令结果。支持三种接收端:
接收端效果
stdout
默认;仅输出到标准输出
file:<path>
原子化将输出写入
<path>
(先写入临时文件再重命名)
webhook:<url>
将输出体POST到指定URL(当使用
--compact
时为
application/json
application/x-ndjson
格式)
未知的协议会被拒绝,并返回结构化错误信息列出支持的协议集。Webhook失败会返回非零退出码,并在标准错误输出中记录URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
outlook-calendar-pp-cli profile save briefing --json
outlook-calendar-pp-cli --profile briefing attachments list mock-value
outlook-calendar-pp-cli profile list --json
outlook-calendar-pp-cli profile show briefing
outlook-calendar-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults.
agent-context
lists all available profiles under
available_profiles
so introspecting agents discover them at runtime.
配置文件是一组保存的标志值,可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时(如HeyGen的“Beacon”模式),可使用该功能。
outlook-calendar-pp-cli profile save briefing --json
outlook-calendar-pp-cli --profile briefing attachments list mock-value
outlook-calendar-pp-cli profile list --json
outlook-calendar-pp-cli profile show briefing
outlook-calendar-pp-cli profile delete briefing --yes
显式标志参数始终优先于配置文件中的值;配置文件中的值优先于默认值。
agent-context
命令会在
available_profiles
下列出所有可用配置文件,因此自省Agent可在运行时发现这些配置文件。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误(参数错误)
3资源未找到
4需要认证
5API错误(上游问题)
7速率限制(请等待后重试)
10配置错误

Argument Parsing

参数解析

Parse
$ARGUMENTS
:
  1. Empty,
    help
    , or
    --help
    → show
    outlook-calendar-pp-cli --help
    output
  2. Starts with
    install
    → ends with
    mcp
    → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with
    --agent
    )
解析
$ARGUMENTS
的规则:
  1. 为空、
    help
    --help
    → 显示
    outlook-calendar-pp-cli --help
    输出
  2. install
    开头
    → 若结尾为
    mcp
    → MCP安装;否则 → 参见上方前提条件部分
  3. 其他情况 → 直接使用(添加
    --agent
    参数执行CLI命令)

MCP Server Installation

MCP服务器安装

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:
bash
claude mcp add outlook-calendar-pp-mcp -- outlook-calendar-pp-mcp
Verify:
claude mcp list
从本CLI已发布的公共库条目或预构建版本安装MCP二进制文件,然后注册:
bash
claude mcp add outlook-calendar-pp-mcp -- outlook-calendar-pp-mcp
验证:
claude mcp list

Direct Use

直接使用

  1. Check if installed:
    which outlook-calendar-pp-cli
    If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the
    --agent
    flag:
    bash
    outlook-calendar-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help:
    outlook-calendar-pp-cli <command> --help
    .
  1. 检查是否已安装:
    which outlook-calendar-pp-cli
    若未找到,可提供安装选项(参见顶部前提条件部分)。
  2. 将用户查询与上方“独特功能”和“命令参考”中的最佳命令匹配。
  3. 添加
    --agent
    参数执行:
    bash
    outlook-calendar-pp-cli <command> [subcommand] [args] --agent
  4. 若存在歧义,可查看子命令帮助:
    outlook-calendar-pp-cli <command> --help