2026-09-09 本地已验证完成、待交审的治理修复,一直未提交: - 6 个 skill(trellis-before-dev/brainstorm/check/continue/finish-work/start) 统一改为"先检查当前和直接相关既有任务,复用优先于新建",取代原来"复杂任务 先请求新建 task"的默认动作;新增 worktree/active-task 一致性校验步骤。 - project-governance.md 新增两节:Task Reuse(任务复用判据)、Active Task And Worktree Alignment(激活任务与实际执行 worktree 一致性检查,防止跨 worktree 会话把上一个任务的 workflow-state 当成当前任务)。 - workflow.md 的 Request Triage / Parent-Child 章节、no_task 面包屑同步改写。 本地已过 task validate、check-trellis-governance.mjs、check-process-contract.mjs、 audit-docs.mjs、git diff --check;无业务代码改动。 Co-Authored-By: Claude Sonnet 5 <[email protected]>
1.9 KiB
1.9 KiB
name, description
| name | description |
|---|---|
| trellis-start | Initialize or resume non-trivial work in this Trellis project. Skip pure consultation and small isolated edits unless task tracking is requested. |
Start Session
- Classify the request before loading context. Pure consultation and small isolated edits do not need a task or a task-creation question. Preserve risk boundaries in AGENTS.md.
- For tracked work, verify
python3 .trellis/scripts/task.py current --sourcefrom the actual execution worktree when entering or switching scope/worktrees. Match it to the intended task; do not treat a previously injected task as proof. Reuse the result while scope and cwd remain unchanged. Do not enumerate unrelated journals and historical tasks. - Read the workflow Phase Index and current step on demand. Read the current PRD, then design and implementation notes if needed. Reuse unchanged material already loaded in this session.
- Prefer the current or directly related existing task; add a scoped repair stage rather than creating a directory for every fix. Only seek new-task consent when independently managed work has no suitable owner. Follow project-governance.md → Task Reuse. With a planning task, complete missing decisions; an approved unchanged plan needs no repeat approval.
- For implementation load trellis-before-dev; for verification load trellis-check. Load spec indexes only for affected layers and follow relevant links, not every guideline.
The project workflow and task status are authoritative over legacy user-level Trellis skills. Missing optional tools require a supported fallback or a precise limitation report, not repeated permission requests.
For an already approved task, use official task.py start <task> on mismatch, then read back current and phase before implementation. Follow .trellis/spec/hyb-oa/project-governance.md → Active Task And Worktree Alignment; never create a shared pointer or infer hook delivery from start's success message.