菜单
Remove an unarchived Ark task in one step. Refuses without --force when seeded files have user content. Use when the user wants to throw away a task they no longer want.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Extract a feature SPEC from an existing codebase for brownfield Ark adoption. Produces specs/features/<slug>/SPEC.md without faking a deep-tier task. Use when the project already implements the feature and Ark needs a SPEC to reference.
Close out an Ark task by atomically committing work + task.toml + (deep tier) SPEC in one git commit. Use when the user says they're done with a task and wants to land it. Replaces the older ark-archive skill; bulk archive is now a manager-only `ark archive` CLI.
Start a standard or deep-tier Ark task. Produces PRD then PLAN, optional REVIEW on deep tier, then EXECUTE and VERIFY. Use when the user asks for feature work, refactoring, or architectural changes.
Audit every SPEC's constraints for actuator-tag health. Reports untagged rules, malformed tags, and tag/bucket mismatches across project and feature SPECs, then offers to fix them yourself or with agent assistance.
Start a research-tier Ark task. Gather a reference corpus on a topic; follow-up implementation is optional. Use when the user wants to investigate a direction before committing to a design.
Start a quick-tier Ark task. For trivial, reversible changes. Produces PRD.md only. Use when the user asks for a small fix, typo, or one-line change that's reversible in a single commit.
| name | ark-discard |
| description | Remove an unarchived Ark task in one step. Refuses without --force when seeded files have user content. Use when the user wants to throw away a task they no longer want. |
ark-discard <task description>Remove an unarchived Ark task: drop the slug from the active set, clear any session focus pointing at it, delete the task directory. Discard ≠ archive. Discard throws away tasks the user no longer wants on disk (mistyped slug, abandoned exploration). Archive preserves completed tasks as memory.
.ark/ is initialized.tasks/archive/YYYY-MM/<tier>/<slug>/ and are not touched by this command.[AI]Parse <task description>. If a slug is present, use it; otherwise default to this session's focused slug. Plumb --force through if the user passed it.
--force [AI]By default, discard refuses when any seeded artifact (PRD.md, PLAN.md, REVIEW.md, VERIFY.md) diverges from its template — the "PRD has user content" guard.
If you (the agent) are about to run ark-discard on the user's behalf without their explicit go-ahead, never pass --force. Surface the error and let the user decide.
[AI]ark agent task discard --slug <slug>
# or, when the user has authorized data loss:
ark agent task discard --slug <slug> --force
Removes the slug from tasks.active, clears session focus pointing at it, and rm -rfs .ark/tasks/<slug>/.
[AI]In one line: confirm the discard and the deleted directory path. If the discarded slug was this session's focus, mention that this session no longer has a focused task.
| Code | Cause | Recovery |
|---|---|---|
TaskNotFound | no .ark/tasks/<slug>/, or task already archived | Suggest task list if the user is unsure what's active |
TaskStillActive { file } | seeded file diverges from template; --force not set | Show the file name; ask the user whether to re-run with --force |
InvalidTaskField | slug failed validation | Reject with the validator's message |
workflow.md §8 (state & multi-session)ark-resume — switch focus instead of discarding