Pflow Task Add

Adds a new task to the mdtodo task list. The agent clarifies the task's essence, formulates a concise title and description with expected result, then adds it via mdtodo. Invoked manually only.

phpinfo 984aa5d 2 files · 5.0 KB Updated

File contents

On any failure (non-zero exit, or "status":"error" in the JSON) print ⚠️ <error.message> and stop.

Steps

  1. Clarify. You MUST understand (a) what the task is about and (b) the expected result. If the user's description is ambiguous, ask — never assume. Formulate:

    • TITLE — concise task name (single line).
    • DESCRIPTION — expected result and key details (optional, may be multiline).
    • VERSION — version tag in vX.Y.Z format (optional, only if the user specifies one).
  2. Add. Run .agents/skills/pflow-task-add/scripts/task-add-run.sh --title "TITLE" [--description "DESCRIPTION"] [--version "VERSION"] → JSON {status:"ok",title,version,mdtodo_file,has_description}. Reply:

    ✅ Task added: <title>
    File: <mdtodo_file>
    

Gotchas

  • If the tasks file does not exist, the script creates an empty file before adding the task.
  • --description inserts indented lines under the task in the markdown file, visible via mdtodo list.

phpinfo/pflow-skills/tree/main/skills/pflow-task-add commit 984aa5d263

Frequently asked questions

npx skillmds@latest add phpinfo/pflow-task-add