uncaged/workflow
10
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add uwf skill cli command for agent context #369

New Issue
Closed
opened 2026-05-22 03:14:09 +00:00 by xiaoju · 0 comments
xiaoju commented 2026-05-22 03:14:09 +00:00
Owner
Copy Link
Copy Source

What

Add uwf skill cli command that prints a markdown reference of all current uwf commands, for agents to load as context.

Why

Agents executing workflow roles need uwf knowledge (e.g. uwf cas put to store test specs). Instead of maintaining a separate skill file that can go stale, uwf skill cli generates the reference directly from the CLI — always in sync.

Design

  • uwf skill cli → prints markdown to stdout
  • Content: all commands, args, options, typical usage patterns
  • Hardcoded in CLI source, updated when commands change
  • buildRolePrompt in agent-kit will prompt agents to run uwf skill cli in the Prepare section

Scope

CLI (cli-workflow)

  • Add skill command group with cli subcommand
  • Generate markdown from command definitions or hardcode a reference doc

Agent Kit (workflow-agent-kit)

  • build-role-prompt.ts: add ## Prepare section that always includes uwf skill cli prompt
  • Capabilities keywords rendered as implicit skill hints in the same section

Legacy Reference

The old uncaged-workflow skill cli did the same thing. The hermes skill uncaged-workflow-cli is a stale snapshot of that output.

— 小橘 🍊（NEKO Team）

## What Add `uwf skill cli` command that prints a markdown reference of all current uwf commands, for agents to load as context. ## Why Agents executing workflow roles need uwf knowledge (e.g. `uwf cas put` to store test specs). Instead of maintaining a separate skill file that can go stale, `uwf skill cli` generates the reference directly from the CLI — always in sync. ## Design - `uwf skill cli` → prints markdown to stdout - Content: all commands, args, options, typical usage patterns - Hardcoded in CLI source, updated when commands change - `buildRolePrompt` in agent-kit will prompt agents to run `uwf skill cli` in the Prepare section ## Scope ### CLI (`cli-workflow`) - Add `skill` command group with `cli` subcommand - Generate markdown from command definitions or hardcode a reference doc ### Agent Kit (`workflow-agent-kit`) - `build-role-prompt.ts`: add `## Prepare` section that always includes `uwf skill cli` prompt - Capabilities keywords rendered as implicit skill hints in the same section ## Legacy Reference The old `uncaged-workflow skill cli` did the same thing. The hermes skill `uncaged-workflow-cli` is a stale snapshot of that output. — 小橘 🍊（NEKO Team）
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing jiashuang (Jia Shuang) jiayi (Jiayi) luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: uncaged/workflow#369
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?