2.8 KiB
2.8 KiB
name, description
| name | description |
|---|---|
| execute-tasks | Execute and complete a specified list of project tasks sequentially. Use when asked to work on, implement, execute, or do a set of task IDs. Supports writing, research, planning, software, and other projects; verifies results, records human review steps, and transitions completed work to testing. |
Execute Tasks
Orient
- Read AGENTS.md, project-config.json, and the task tracker.
- Load the
task-managementskill and query each requested task with./scripts/get-task <ID>. Do not assume a prefix or software project. - Confirm tasks are ready for work. If not, explain the status and ask for direction; do not silently bypass blocked or unscoped work.
- Inspect existing materials and changes. Preserve unrelated work.
Execute Sequentially
For each task:
- Transition it to
in_progressusingupdate-task. - Resolve material ambiguities with the user and agree on acceptance criteria.
- Complete the requested deliverable using the project's established methods. For a novel this may be manuscript edits; for research it may be source analysis; for software it may be code. Do not invent a language or platform.
- Update directly related documentation and verify acceptance criteria. Use configured commands only when applicable. For non-command workflows, review deliverables and report what still needs human judgment.
- When editing the bundled task tooling, run
python3 -m unittest discover -s scripts/tests -v. - Record step-by-step human verification in
docs/task-verification.md, creating it if needed. Include expected results and limitations. - Transition successful work to
testingwith--check-all, then query the task again to verify the transition. Never mark your own workdone. - Record newly discovered work with
add-task; do not expand scope silently.
Stop and explain blockers when an acceptance criterion cannot be met. Do not present unverified work as complete.
Persistence
- Do not commit unless asked. If asked, inspect
git statusand include the task/verification changes relevant to the deliverable. Do not stage unrelated edits blindly. - Use descriptive commit messages including task IDs and the required co-author trailer where applicable.
- If project-description documents exist, check their last update and refresh verification timestamps after major changes or 20 commits. Do not require nonexistent project-specific documents.
- Human reviewers move
testingtodoneand migrate verification steps todocs/human-tests.md, creating it when first needed. - If CLI tools cannot run, disclose that and agree on a manual workflow with the user rather than reporting fabricated checks.