Skip to content

Commit 2f47827

Browse files
committed
docs(task): use bare npx ai-devkit fallback
Replace npx ai-devkit@latest with bare npx ai-devkit: it prefers any installed binary (project or global) with zero network and only fetches when absent, avoiding both @latest's bypass of installed versions and pin staleness. Instruction text only.
1 parent 9eae9bf commit 2f47827

1 file changed

Lines changed: 21 additions & 20 deletions

File tree

‎skills/task/SKILL.md‎

Lines changed: 21 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,14 @@ description: AI DevKit · Track dev-lifecycle / structured-debug progress on a d
88
Record development progress on a durable task: phase, progress, next step,
99
blockers, and validation evidence.
1010

11-
Requires the optional task command. Use `npx ai-devkit@latest` for task and
11+
Requires the optional task command. Prefer the installed `ai-devkit`
12+
binary; if unavailable, use `npx ai-devkit` for task and
1213
agent commands. Before recording task events, run a real read probe:
1314

1415
```bash
15-
npx ai-devkit@latest task list --json
16+
npx ai-devkit task list --json
1617
# or, when a task name is known:
17-
npx ai-devkit@latest task list --name <task-name> --json
18+
npx ai-devkit task list --name <task-name> --json
1819
```
1920

2021
Only treat task tracing as available when the read probe exits 0. If it fails,
@@ -47,7 +48,7 @@ task tracing is unavailable or unusable.
4748

4849
Use `agent-management` when attribution is needed:
4950

50-
1. Run the `agent-management` self-identification workflow with `npx ai-devkit@latest agent list --json`.
51+
1. Run the `agent-management` self-identification workflow with `npx ai-devkit agent list --json`.
5152
2. Match the current agent entry from that list. Prefer an exact session match when available; otherwise use the unambiguous entry for the current project/worktree.
5253
3. Build actor flags from the matched entry:
5354
`--agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId>`.
@@ -56,7 +57,7 @@ Use `agent-management` when attribution is needed:
5657
4. If identity is ambiguous, do not guess. Continue task logging without actor
5758
flags rather than fabricating attribution.
5859
5. Add `--agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId>` to every mutation command once known. If a task already
59-
exists, run `npx ai-devkit@latest task assign <task-name> --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json` once so
60+
exists, run `npx ai-devkit task assign <task-name> --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json` once so
6061
the task snapshot has current ownership.
6162
6. If actor identity is unknown, run the same mutation commands without the four
6263
actor flags.
@@ -68,41 +69,41 @@ When self identity is known, add all four actor flags to every mutation command:
6869

6970
```bash
7071
# Create the task once (capture taskId from --json if needed)
71-
npx ai-devkit@latest task create --title "<title>" --name <task-name> --phase requirements --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
72+
npx ai-devkit task create --title "<title>" --name <task-name> --phase requirements --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
7273

7374
# If the task already exists, assign current ownership once when known
74-
npx ai-devkit@latest task assign <task-name> --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
75+
npx ai-devkit task assign <task-name> --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
7576

7677
# Mark real work as active after create/resume
77-
npx ai-devkit@latest task status <task-name> active --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
78+
npx ai-devkit task status <task-name> active --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
7879

7980
# Advance phase as the lifecycle moves on
80-
npx ai-devkit@latest task phase <task-name> implementation --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
81+
npx ai-devkit task phase <task-name> implementation --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
8182

8283
# Progress (use --text; positional text is ignored)
83-
npx ai-devkit@latest task progress <task-name> --text "Implementing task CLI" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
84+
npx ai-devkit task progress <task-name> --text "Implementing task CLI" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
8485

8586
# Next step
86-
npx ai-devkit@latest task next <task-name> "Run validation" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
87+
npx ai-devkit task next <task-name> "Run validation" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
8788

8889
# Blockers
89-
npx ai-devkit@latest task status <task-name> blocked --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
90-
npx ai-devkit@latest task blocker <task-name> add "Waiting for review" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
91-
npx ai-devkit@latest task blocker <task-name> resolve <blocker-id> --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
92-
npx ai-devkit@latest task status <task-name> active --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
90+
npx ai-devkit task status <task-name> blocked --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
91+
npx ai-devkit task blocker <task-name> add "Waiting for review" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
92+
npx ai-devkit task blocker <task-name> resolve <blocker-id> --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
93+
npx ai-devkit task status <task-name> active --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
9394

9495
# Validation evidence - record after a fresh verify/tdd/test run
95-
npx ai-devkit@latest task evidence <task-name> --passed --command "npm test" --exit-code 0 --summary "tests passed" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
96+
npx ai-devkit task evidence <task-name> --passed --command "npm test" --exit-code 0 --summary "tests passed" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
9697

9798
# Reference an artifact (never copies the file)
98-
npx ai-devkit@latest task artifact <task-name> docs/ai/testing/foo.md --kind test-report --description "Testing notes" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
99+
npx ai-devkit task artifact <task-name> docs/ai/testing/foo.md --kind test-report --description "Testing notes" --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
99100

100101
# Read current status / list
101-
npx ai-devkit@latest task show <task-name> --json
102-
npx ai-devkit@latest task list --name <task-name> --json
102+
npx ai-devkit task show <task-name> --json
103+
npx ai-devkit task list --name <task-name> --json
103104

104105
# Close at lifecycle end
105-
npx ai-devkit@latest task close <task-name> completed --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
106+
npx ai-devkit task close <task-name> completed --agent <agent-name> --agent-type <agent-type> --pid <pid> --session <sessionId> --json
106107
```
107108

108109
## When to emit (by workflow)

0 commit comments

Comments
 (0)