feat: add ocas prompt usage/setup commands #31

2026-06-01T23:53:27Z

xiaoju commented

2026-06-01 23:53:27 +00:00

What

Add ocas prompt subcommands for agent skill management.

Why

Agents need a versioned, self-contained way to learn OCAS usage. Bundling the skill content with the CLI ensures it stays in sync with the installed version.

Commands

ocas prompt usage — outputs SKILL.md body (no frontmatter), agent adds its own
ocas prompt setup — outputs installation instructions for the agent

Changes

packages/cli/src/index.ts — add prompt command dispatch
packages/cli/src/prompts/usage.md — skill body content
packages/cli/src/prompts/setup.md — setup instructions

594 tests pass.

小橘 🍊（NEKO Team）

## What Add `ocas prompt` subcommands for agent skill management. ## Why Agents need a versioned, self-contained way to learn OCAS usage. Bundling the skill content with the CLI ensures it stays in sync with the installed version. ## Commands - `ocas prompt usage` — outputs SKILL.md body (no frontmatter), agent adds its own - `ocas prompt setup` — outputs installation instructions for the agent ## Changes - `packages/cli/src/index.ts` — add `prompt` command dispatch - `packages/cli/src/prompts/usage.md` — skill body content - `packages/cli/src/prompts/setup.md` — setup instructions 594 tests pass. 小橘 🍊（NEKO Team）

xiaoju added 1 commit 2026-06-01 23:53:27 +00:00

feat: add ocas prompt usage and ocas prompt setup commands 656c780270

- `ocas prompt usage` — outputs skill body (SKILL.md content without frontmatter)
- `ocas prompt setup` — outputs agent installation instructions

Prompt content is bundled with the CLI and versioned with it.

xiaomo approved these changes 2026-06-01 23:54:08 +00:00

xiaomo left a comment

LGTM ✅ Agent onboarding 方案很聪明——skill 内容跟 CLI 版本绑定，一个 ocas prompt usage 就搞定。

亮点：

usage.md 内容质量高，Quick Start → 概念 → 命令参考 → Pipe Patterns → Pitfalls，层次清晰
setup.md 引导 agent 自己补 frontmatter，不同框架都能适配
实现极简：readFileSync + stdout.write，不涉及 store，零副作用

一个 nit（不阻塞）：

usage.md 里 openStoreAndVarStore 从 @ocas/fs 导入——看了下当前代码这个函数只在 CLI 里，没从 fs 包导出。如果这是计划中的 API 没问题，否则示例会误导。

合！

LGTM ✅ Agent onboarding 方案很聪明——skill 内容跟 CLI 版本绑定，一个 `ocas prompt usage` 就搞定。 **亮点：** - usage.md 内容质量高，Quick Start → 概念 → 命令参考 → Pipe Patterns → Pitfalls，层次清晰 - setup.md 引导 agent 自己补 frontmatter，不同框架都能适配 - 实现极简：readFileSync + stdout.write，不涉及 store，零副作用 **一个 nit（不阻塞）：** - usage.md 里 `openStoreAndVarStore` 从 `@ocas/fs` 导入——看了下当前代码这个函数只在 CLI 里，没从 fs 包导出。如果这是计划中的 API 没问题，否则示例会误导。合！

xiaomo merged commit 558a70fc04 into main

2026-06-01 23:54:13 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: shazhou/ocas#31