refactor: update skill invocation methods and enhance CLI usage examples

This commit is contained in:
catlog22
2026-03-05 10:59:07 +08:00
parent bf057a927b
commit 99a45e3136
3 changed files with 85 additions and 51 deletions

View File

@@ -92,18 +92,24 @@ Skill(skill="workflow-tdd-plan", args="--mode tdd-verify")
## Using Skills
### CLI Interface
### Recommended: CCW Orchestrator
Use `/ccw` command with natural language - CCW analyzes intent and auto-selects appropriate skill:
```bash
# Invoke via ccw command
ccw --help
# CCW auto-routes to brainstorm skill
/ccw "头脑风暴: 用户通知系统设计"
# Or use triggers directly
ccw brainstorm
ccw team lifecycle
# CCW auto-routes to team lifecycle workflow
/ccw "从零开始: 用户认证系统"
# CCW auto-routes to review cycle
/ccw "review: 代码质量检查"
```
### Programmatic Interface
### Direct Skill Invocation
Use `Skill()` tool for direct skill calls:
```javascript
// Basic usage
@@ -116,6 +122,17 @@ Skill(skill="team-lifecycle-v4", args="Build user authentication")
Skill(skill="workflow-plan", args="--mode verify")
```
### CCW Team CLI (Message Bus Only)
`ccw team` is **only** for team message bus operations, not for invoking team skills:
```bash
# Message bus operations
ccw team log --session-id TLS-xxx --from executor --type state_update
ccw team list --session-id TLS-xxx --last 5
ccw team status --session-id TLS-xxx
```
## Custom Skills
Create your own skills for team-specific workflows:
@@ -173,24 +190,23 @@ Skill(skill="my-custom-skill", args="input")
**Scenario**: Implement a new user dashboard feature
```bash
# Step 1: Brainstorm the feature
ccw brainstorm
# Follow prompts to define:
# - Dashboard widgets (stats, charts, recent activity)
# - Layout preferences
# - Data refresh intervals
# Step 1: Brainstorm the feature (via CCW orchestrator)
/ccw "头脑风暴: 用户仪表板功能设计"
# Or use Skill directly:
# Skill(skill="brainstorm")
# Step 2: Plan implementation
ccw workflow-plan "Build user dashboard with configurable widgets"
# Outputs: IMPL-001.json with task breakdown
# Step 2: Plan implementation (via CCW orchestrator)
/ccw "Plan: Build user dashboard with configurable widgets"
# Or use Skill directly:
# Skill(skill="workflow-plan", args="Build user dashboard")
# Step 3: Execute with team
ccw team lifecycle
# Step 3: Execute with team lifecycle
Skill(skill="team-lifecycle-v4", args="Build user dashboard")
# Or use quick iteration:
ccw workflow-lite-planex && ccw workflow-execute
# Skill(skill="workflow-lite-planex")
# Step 4: Review and refine
ccw review-code
Skill(skill="review-code")
# Fix any issues found
```
@@ -215,12 +231,13 @@ ccw workflow-execute --task "Fix N+1 query in user endpoint"
**Scenario**: Migrate from JavaScript to TypeScript
```bash
# Step 1: Analyze codebase
ccw workflow:refactor-cycle
# Identifies tech debt and creates migration plan
# Step 1: Analyze codebase (via CCW orchestrator)
/ccw "refactor: JavaScript to TypeScript migration"
# Or use Skill directly:
# Skill(skill="workflow:refactor-cycle")
# Step 2: Execute migration in phases
ccw team roadmap-dev --epic "ts-migration"
# Step 2: Execute with team roadmap
Skill(skill="team-roadmap-dev", args="--epic ts-migration")
# Progressively migrates modules with tests
```