@pennixrv/trellis 0.7.0-beta.9 → 0.7.1-beta.1

package/dist/migrations/manifests/0.7.1-beta.1.json

@@ -0,0 +1,186 @@
+{
+  "version": "0.7.1-beta.1",
+  "description": "Remove retired Channel, subnode and planning workflow assets",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Hash-verified cleanup removes retired generated roles, helpers and skills without migrating existing tasks.",
+  "migrations": [
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/agents/check.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "edb4f57361407249a53bf5998ebf91c40d2b969e826a2c5e1b4e813a08bcb175"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/agents/implement.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "66e25ad046c94869442834bc3cdfbd5a9a7412d3ff54561d64d2886552c27e87"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/agents/subnode.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "e3cbcbb9cafcd931d0725c91e97955469f23ba64db92eee10c66d465ce2896d5"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/agents/subnode-profiles.json",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "b862bd997cb8874ae0e167ca47abcd315840e6a6102373c3e516e969f14ee8a2"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/scripts/subnode_artifact.py",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "35a9f0476f2e719cb82716fabcb38c0bc4004e76e8d7b63bd3ebffdb62d3aac2"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/scripts/workspace_note.py",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "2159a1445ff80e63e2e81d1589445d18710ae81bd54d1e6fd1a9b9b1ee629081"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/scripts/common/context_projection.py",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "a1699dad6a35c5d8b53110be40d2d5da60b1b561290f83141348f9845497301f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/scripts/common/continuation_record.py",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "17e7d7198052a3214adf0240efdeb474538e1c670f79d03ee292af6c7b5f02b5"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/scripts/common/ownership_record.py",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "023f30f568e2a0acccb84f2626d4f996b1f08e1ffd651a7caebf139e18a75254"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/scripts/common/task_migration.py",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "386af968f10ff76dc223637d36b179354924a4e0ffcf6f077eaee67ed086f7c6"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".trellis/scripts/common/task_planning.py",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "7893ba09bbdcdec99d3cb987463d9e14d4d962ba460f03e2c717d9f4fc26dd89"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-channel/SKILL.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "a6f602aa5c0e57ec0638bc9c99bfcf7c9a3608b0b3364ac4782dfe91e4351f64"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-channel/references/command-reference.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "35c3e0c7e11660ac0e25ae8debb727d5439a35f71b79eef4a3982ad5c9836229"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-channel/references/forum.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "9ab0491262aeb1db34d42aa065115689a41b7becea093de2c4ec12a8d8a3deda"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-channel/references/multi-target-dispatch.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "7f74841c6dedc58ccfd7de946c9ffc789ca11ef7b95c8cd516e1f78c26c15140"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-channel/references/progress-debugging.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "78f9771b281056fc9ed17ca889404caab66afb4b89d624bb6346f5e82a06b52a"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-channel/references/subnode-work.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "ba900fcb3d7054bcdb65bbeefa1731e9c73c8f6d95d7d6c2832b0d94e8c5f95f"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-channel/references/workers.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "4785c3ec1a19c078b05ea6f47610e020b3dc6e0b4aeac3cf4ae81c41ab1d5e26"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-channel/references/workflows.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "cf083518eb81331f64908388694d6b887b640a59c1bf064d369f9efef81c92b9"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-idea-to-closed-plan/SKILL.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "9ab419254b3815ada79ae961aee3e73cbbacc9d3eeb085042ff97d94a6654cd2"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-meta/references/local-architecture/multi-agent-channel.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "af7d5fc2ee374f66f71da90a5770ced217c3a8459537ec4e08d57cd64f91cb72"
+      ]
+    },
+    {
+      "type": "safe-file-delete",
+      "from": ".agents/skills/trellis-research-record/SKILL.md",
+      "description": "Retired generated asset; current native workflow no longer provides this file",
+      "allowed_hashes": [
+        "f433da1e9fe6f5003a2c4330a72b2998433b91e4b73d4d2c22622a620ad0966a"
+      ]
+    }
+  ],
+  "notes": "Run trellis update without --migrate. Modified files remain protected; old task records and handoff history are not migrated."
+}

package/dist/migrations/manifests/0.7.1.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.1",
+  "description": "引入新的 Trellis 任务工作流、Teamwork 协作和默认内置原生工作流。",
+  "breaking": true,
+  "recommendMigrate": false,
+  "changelog": "稳定版引入新的 Trellis 任务工作流和 Teamwork 协作，默认工作流随 CLI 打包提供。旧 Channel 运行时数据不会迁移到新的任务模型。",
+  "migrations": [],
+  "notes": "本版本不迁移或导入旧 Channel 运行时数据。"
+}

package/dist/templates/claude/hooks/statusline.py

@@ -111,13 +111,6 @@ def _get_current_task_for_input(trellis_dir: Path, cc_data: dict) -> dict | None
         return None
 
     active = resolve_active_task(trellis_dir.parent, cc_data, platform="claude")
-    if active.source_type == "unbound_ambiguous":
-        return {
-            "title": f"Task binding ambiguous ({len(active.candidate_paths)} candidates)",
-            "status": "unbound_ambiguous",
-            "priority": "P?",
-            "source": active.source,
-        }
     if not active.task_path:
         return None
 

package/dist/templates/codex/hooks/session-start.py

@@ -229,14 +229,6 @@ def _resolve_task_dir(trellis_dir: Path, task_ref: str) -> Path:
 
 def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
     active = _resolve_active_task(trellis_dir, hook_input)
-    if active.source_type == "unbound_ambiguous":
-        candidates = "\n".join(f"- {candidate}" for candidate in active.candidate_paths)
-        return (
-            "Status: TASK BINDING AMBIGUOUS\n"
-            f"Candidates:\n{candidates}\n"
-            "Next: Review the candidates and run `python3 ./.trellis/scripts/task.py start <task>` "
-            "with the intended task once a direct session identity is available."
-        )
     if not active.task_path:
         return (
             "Status: NO ACTIVE TASK\n"
@@ -266,13 +258,9 @@ def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
     if task_status == "completed":
         return (
             f"Status: COMPLETED\nTask: {task_title}\n"
-            f"Next: Archive with `python3 ./.trellis/scripts/task.py archive {task_dir.name}` "
-            "or start a new task."
+            "Next: Start another task or end the session; finish-work only records the session journal."
         )
 
-    has_prd = (task_dir / "prd.md").is_file()
-    has_design = (task_dir / "design.md").is_file()
-    has_implement = (task_dir / "implement.md").is_file()
     present = [
         name
         for name in ("prd.md", "design.md", "implement.md", "implement.jsonl", "check.jsonl")
@@ -280,20 +268,18 @@ def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
     ]
     present_line = ", ".join(present) if present else "none"
 
-    if not has_prd:
-        return (
-            f"Status: PLANNING\nTask: {task_title}\nPresent: {present_line}\n"
-            "Next: Load trellis-brainstorm and write prd.md. Stay in planning."
-        )
-
     if task_status == "planning":
-        if has_design and has_implement:
-            next_action = "Review planning artifacts with the user before `task.py start`."
-        else:
-            next_action = (
-                "Lightweight task can ask for start review with PRD-only; "
-                "complex task must add design.md and implement.md before `task.py start`."
-            )
+        next_action = (
+            "Follow the current per-turn workflow-state. Task lifecycle status and artifact presence "
+            "do not identify the business phase. If no phase route is initialized, load "
+            "`trellis-goal-exploration-and-requirements` and confirm the requirements baseline "
+            "before initializing the route."
+        )
+        if any(
+            path.is_file() and not _has_curated_jsonl_entry(path)
+            for path in (task_dir / "implement.jsonl", task_dir / "check.jsonl")
+        ):
+            next_action += " Curate task context manifests only when a dispatched agent needs them."
         return (
             f"Status: PLANNING\nTask: {task_title}\nPresent: {present_line}\n"
             f"Next: {next_action}"
@@ -301,8 +287,9 @@ def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
 
     return (
         f"Status: {task_status.upper()}\nTask: {task_title}\nPresent: {present_line}\n"
-        "Next: Follow the matching per-turn workflow-state. Context order is jsonl entries, "
-        "prd.md, design.md if present, implement.md if present."
+        "Next: Follow the matching per-turn workflow-state; task lifecycle status does not "
+        "identify the business phase. Context order is jsonl entries, `prd.md`, `design.md` "
+        "if present, `implement.md` if present."
     )
 
 
@@ -391,10 +378,7 @@ def _build_compact_current_state(
     lines.append(_format_git_state(repo_root))
 
     active = _resolve_active_task(trellis_dir, hook_input)
-    if active.source_type == "unbound_ambiguous":
-        candidates = ", ".join(active.candidate_paths)
-        lines.append(f"Current task: ambiguous; candidates={candidates}; bind explicitly.")
-    elif active.task_path:
+    if active.task_path:
         task_dir = _resolve_task_dir(trellis_dir, active.task_path)
         status = "unknown"
         task_json = task_dir / "task.json"
@@ -436,14 +420,23 @@ def _extract_range(content: str, start_header: str, end_header: str) -> str:
     lines = content.splitlines()
     start: "int | None" = None
     end: int = len(lines)
-    start_match = f"## {start_header}"
-    end_match = f"## {end_header}"
+    start_matches = {f"## {start_header}", "## 阶段索引", "## Phase Index"}
+    end_matches = {
+        f"## {end_header}",
+        f"### {end_header}",
+    }
+    phase_titles = ("目标探索与需求核对阶段", "Goal Exploration and Requirements Confirmation Phase")
     for i, line in enumerate(lines):
         stripped = line.strip()
-        if start is None and stripped == start_match:
+        if start is None and stripped in start_matches:
             start = i
             continue
-        if start is not None and stripped == end_match:
+        heading = stripped.lstrip("#").strip()
+        is_phase_heading = stripped.startswith(("## ", "### ")) and any(
+            heading == title or heading.endswith((f"：{title}", f": {title}"))
+            for title in phase_titles
+        )
+        if start is not None and (stripped in end_matches or is_phase_heading):
             end = i
             break
     if start is None:
@@ -491,11 +484,11 @@ def _build_workflow_toc(workflow_path: Path) -> str:
 
     out_lines = [
         "# Development Workflow - Session Summary",
-        "Full guide: .trellis/workflow.md. Step detail: `python3 ./.trellis/scripts/get_context.py --mode phase --step <X.Y>`.",
+        "Full guide: .trellis/workflow.md. Phase detail: load the Skill named in the active phase breadcrumb.",
         "",
     ]
 
-    phases = _extract_range(content, "Phase Index", "Phase 1: Plan")
+    phases = _extract_range(content, "阶段索引", "目标探索与需求核对阶段")
     if phases:
         out_lines.append(_strip_breadcrumb_tag_blocks(phases).rstrip())
 

package/dist/templates/common/bundled-skills/trellis-decision-space-construction-and-merging/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: trellis-decision-space-construction-and-merging
+description: 当前任务进入决策空间构造与归并阶段时，整理实质决策、候选、证据、依赖与决策树。
+---
+
+# 决策空间构造与归并阶段
+
+当 `current_phase_id` 为 `decision_space_construction_and_merging` 时使用。阅读本 Skill 同目录的 `workflow.md`，并基于已确认且仍有效的需求基线工作。
+
+决策空间构造与归并阶段负责展示和归并决策空间，不代替用户锁定保留决定。简单问题使用清单或比较表；只有前置选择或条件会改变后续选项时才建立决策树。阶段结果由 Trellis CLI 接受；无实质候选差异时可按证据跳过本阶段。

package/dist/templates/common/bundled-skills/trellis-decision-space-construction-and-merging/workflow.md

@@ -0,0 +1,40 @@
+# 决策空间构造与归并阶段流程
+
+核对目标探索与需求核对阶段已确认的目标基线及当前 `artifact_revision`。判断候选差异、条件分支是否会影响交付、验收、风险或下游选择。若没有实质差异，可记录基线引用、跳过理由、解决方案设计与收敛阶段的最低输入和需要重新进入本阶段的变化条件，再由 Trellis CLI 核验跳过。
+
+需要构造时，梳理决策项及其权限、候选、重要排除项与理由；按需补齐证据、适用约束、标准、阈值、依赖、影响和优先级。证据足够时给出推荐；证据不足则保留未知或待决项，不伪造结论。仅当选择之间存在条件依赖时使用决策树，并标明分支条件、来源、未知路径及其下游影响。互斥、共享依赖或汇合关系可用依赖图；独立候选用比较表或清单即可。
+
+新颖机制、重大重构、跨组件边界变化或关键取舍缺少可信本地先例时，进行有界的 `prior-art review`，记录适用性与采纳或排除理由。只读 Teamwork 可按需补充证据；主代理核验报告后归并。将 `DecisionSpace` 或有据跳过记录交由 Trellis CLI 接受，待用户决定交由解决方案设计与收敛阶段处理。
+
+```mermaid
+flowchart TD
+  input["核对已确认且仍有效的需求基线"] --> material{"差异或条件分支会改变交付、验收、风险或下游选择？"}
+  material -->|"否"| skip["记录 revision、理由、解决方案设计与收敛阶段所需的最低输入和重入条件"]
+  skip --> accepted["Trellis CLI 核验并接受跳过记录"]
+  material -->|"是"| items["整理决策项、权限、候选和重要排除项"]
+  items --> evidence["补充适用证据、标准、依赖、优先级和影响"]
+  evidence --> prior{"触发 prior-art review 条件？"}
+  prior -->|"是"| review["有界核对相关开源实现或公开提案"]
+  prior -->|"否"| merge["汇总当前证据"]
+  review --> merge
+  evidence --> teamwork_gate{"只读 Teamwork 评议有净收益？"}
+  teamwork_gate -->|"是"| teamwork["获取并核验只读 Teamwork 报告"]
+  teamwork_gate -->|"否"| merge
+  teamwork --> merge
+  merge --> representation{"候选关系需要条件分支吗？"}
+  representation -->|"是"| tree["建立可追溯决策树并标明相关未知路径"]
+  representation -->|"否"| simple["使用清单、比较表或适用的依赖图"]
+  tree --> assess["核对证据、覆盖范围、关系与当前 revision"]
+  simple --> assess
+  assess -->|"目标或范围变化"| goal_exploration_and_requirements["回到目标探索与需求核对阶段，更新基线"]
+  assess -->|"证据或候选仍有缺口"| items
+  assess -->|"可供方案收敛"| output["Trellis CLI 接受 DecisionSpace"]
+  accepted --> solution_design_and_convergence["进入解决方案设计与收敛阶段"]
+  output --> solution_design_and_convergence
+```
+
+### 离开阶段的条件
+
+- 有实质决策空间时，候选、关键证据、关系、未知项和推荐均能支持下一阶段比较；不要求固定字段数量或同时使用多种图表。
+- 无实质差异时，跳过记录须能说明当前基线、判断依据和重新进入条件。
+- 保留用户决定不在本阶段锁定；外部参考不替代项目事实或用户选择。

package/dist/templates/common/bundled-skills/trellis-delivery-review-and-closeout/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: trellis-delivery-review-and-closeout
+description: 当前任务进入交付审查与现场收尾阶段时，核对当前交付候选、未结事项、接受条件和资源处置。
+---
+
+# 交付审查与现场收尾阶段
+
+当 `current_phase_id` 为 `delivery_review_and_closeout` 时使用。阅读本 Skill 同目录的 `workflow.md`，只审查当前路线和 revision 下的交付，不在本阶段重新设计或实施。
+
+本阶段核验交付与合同、接受条件、工作包、集成、验证、未结发现和资源事实。当前合同内缺口按最早受影响阶段回流或暂停；合同外遗留应记录责任方、触发条件、影响和后续引用。满足交付条件后由 Trellis CLI 接受；只有明确撤回才进入取消处置。会话交接包是独立附加操作，不是阶段或任务收尾的前置条件。

package/dist/templates/common/bundled-skills/trellis-delivery-review-and-closeout/workflow.md

@@ -0,0 +1,55 @@
+# 交付审查与现场收尾阶段流程
+
+绑定当前 `task_route_revision`、输入和结果 revision，按解决方案设计与收敛阶段确认的优先级和依赖检查任务实施与测试验证阶段的工作包、适用的集成与验证、合同差异和未结发现；只有路线实际涉及必需子任务或受托资源时，才核对相应事实。分析型路线只核对实际分析产物，不制造实施工作包。验证按通过、失败、未运行或受限记录；合同允许且风险可接受时说明未运行原因、影响和替代证据，否则暂停或回到任务实施与测试验证阶段。
+
+实施、集成或必需验证缺陷回到任务实施与测试验证阶段；方案、合同、风险、依赖、回退或停止条件失效回到解决方案设计与收敛阶段；候选、标准或条件变化回到决策空间构造与归并阶段；目标、范围或接受目标变化回到目标探索与需求核对阶段。必要证据缺失时，暂停并停留在交付审查与现场收尾阶段；必要用户决定缺失时，通过 `pennix-decision-grill` 同步请求决定，答复前保持暂停，收到答复后重新核对当前输入和受影响阶段。当前合同内未完成工作不能改记为遗留后关闭。合同外、已明确延期或撤回后不继续的事项，可在现有收尾产物中记录范围、责任方、触发条件、影响和后续任务引用；没有遗留时不另造清单。
+
+满足当前合同且没有待处理缺口时，由 Trellis CLI 接受交付审查并形成 `delivery_ready`；`no_go` 也须经交付审查与现场收尾阶段后才能完成任务。只有合同、用户明确要求或不可由主代理替代的重要价值与风险取舍需要用户接受时，才等待用户确认。用户要求修改或拒绝时，使当前交付候选失效并按影响回流。调用 `complete` 前核验任务生命周期；只有路线实际创建、委派或依赖外部执行资源时，才核验其处置状态。相关资源仍可能写入、泄露、造成数据风险或状态无法确认时，保留现场并阻止完成。若用户明确撤回，Trellis CLI 将路线收敛为仅包含交付审查与现场收尾阶段并记录原因；存在关联子任务时，逐项记录继续、转为独立任务或取消的决定及依据，继续时保留父子关系，转为独立任务时记录子任务和依据后再解除关系，取消时另行执行子任务自身的取消流程。完成子任务处置后，再核验当前路线实际涉及的外部执行资源；资源仍可能写入、泄露、造成数据风险或状态无法确认时保留现场并阻止取消，风险解除后才调用 `cancel --reason`。
+
+```mermaid
+flowchart TD
+  candidate["绑定当前 revision 的分析产物或实施交付候选"] --> review["按当前合同核验工作包、适用的集成与验证、差异及相关子任务和资源"]
+  review --> gaps{"存在合同内缺口或失效事实？"}
+  gaps -->|"实施、集成或必需验证"| task_implementation["回到任务实施与测试验证阶段"]
+  gaps -->|"方案或合同"| solution_design_and_convergence["回到解决方案设计与收敛阶段"]
+  gaps -->|"候选、标准或条件"| decision_space_construction_and_merging["回到决策空间构造与归并阶段"]
+  gaps -->|"目标、范围或接受目标"| goal_exploration_and_requirements["回到目标探索与需求核对阶段"]
+  gaps -->|"必要证据缺失"| wait["暂停并留在交付审查与现场收尾阶段"]
+  gaps -->|"必要用户决定缺失"| decision_grill["pennix-decision-grill 同步请求必要决定；答复前暂停"]
+  decision_grill --> candidate
+  wait --> candidate
+  gaps -->|"无"| residual{"是否有可保留的合同外或已延期遗留？"}
+  residual -->|"是"| record["记录责任方、触发条件、影响和后续引用"]
+  residual -->|"否"| accept["Trellis CLI 接受 delivery_ready 或 no_go"]
+  record --> accept
+  accept --> user_gate{"交付合同、用户明确要求或不可由主代理替代的价值/风险取舍要求用户接受？"}
+  user_gate -->|"否"| ready["核验任务生命周期及适用资源后按条件 complete"]
+  user_gate -->|"是"| ask_accept["pennix-decision-grill 同步请求用户接受"]
+  ask_accept --> answer{"用户答复是否明确？"}
+  answer -->|"接受"| ready
+  answer -->|"未答复或答复不清"| user_wait["保持暂停并等待明确答复"]
+  user_wait --> candidate
+  answer -->|"要求修订或拒绝"| invalidate["使当前交付候选失效并判断最早受影响阶段"]
+  invalidate -->|"实施、集成或验证"| task_implementation
+  invalidate -->|"候选、标准或条件"| decision_space_construction_and_merging
+  invalidate -->|"方案或合同"| solution_design_and_convergence
+  invalidate -->|"目标、范围或接受目标"| goal_exploration_and_requirements
+  withdraw["用户明确撤回"] --> cancel_route["Trellis CLI 将路线收敛为仅‘交付审查与现场收尾阶段’并记录原因"]
+  cancel_route --> child_disposition{"关联子任务如何处置？"}
+  child_disposition -->|"继续"| child_continue["保留父子关系"]
+  child_disposition -->|"转为独立任务"| child_independent["记录子任务标识与依据后解除父子关系"]
+  child_disposition -->|"取消"| child_cancel["另行执行子任务自身的取消流程"]
+  child_disposition -->|"无关联子任务"| cancelReview
+  child_continue --> cancelReview
+  child_independent --> cancelReview
+  child_cancel --> cancelReview
+  cancelReview["核验当前路线涉及的子任务和资源处置"]
+  cancelReview --> safe{"是否仍有资源可能写入、泄露或造成数据风险？"}
+  safe -->|"是或状态未知"| preserve["保留现场并阻止取消"]
+  preserve --> cancelReview
+  safe -->|"否"| cancel["Trellis CLI cancel --reason"]
+```
+
+### 与会话交接的边界
+
+正式会话交接包仅在用户明确要求时按其独立 Skill 处理。它不改变阶段、路线或任务状态，也不是 `delivery_ready`、`complete` 或 `cancel` 的前置条件。

package/dist/templates/common/bundled-skills/trellis-goal-exploration-and-requirements/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: trellis-goal-exploration-and-requirements
+description: 当前任务处于目标探索与需求核对阶段时，核对目标、范围、成功条件、约束、证据与用户确认。
+---
+
+# 目标探索与需求核对阶段
+
+当 Trellis 任务的 `current_phase_id` 为 `goal_exploration_and_requirements` 时使用。先阅读本 Skill 同目录的 `workflow.md`，再按当前项目事实选择必要的探索深度和证据来源。
+
+阶段产物和用户确认通过 Trellis CLI 记录。离开本阶段前，必须由用户明确确认绑定当前 `artifact_revision` 的目标与需求基线；只要求修订或尚未确认时，继续停留在本阶段。确认不等于最终方案批准或实施授权。

package/dist/templates/common/bundled-skills/trellis-goal-exploration-and-requirements/workflow.md

@@ -0,0 +1,33 @@
+# 目标探索与需求核对阶段流程
+
+先核对用户请求、目标对象和项目背景。新项目明确问题、用户、领域及系统边界；既有项目核对目标仓库、组件、当前版本、适用规则、现状和影响范围。按问题选择本地源码、历史记录、外部资料或用户维护知识等证据来源；只在独立取证有净收益时使用 Trellis Teamwork。
+
+整理目标、范围、成功条件、关键约束和责任方。区分已知事实、假设、证据冲突和未知事项；缺少会改变目标或路线的用户事实时，通过 `pennix-decision-grill` 同步询问。记录会阻断推进的问题及恢复条件；不影响当前路线的事项可明确责任方和后续处理。
+
+形成 `phase_output`，至少包含当前目标与需求基线、必要证据、不确定性、`phase_result` 和非约束性的 `route_advice`。`route_advice` 简要说明任务类型、复杂度画像和项目背景如何影响阶段选择，并记录复杂度判断的实际触发维度与理由；不机械计分或套用固定路由矩阵，也不要求固定字段或篇幅。路线发生变化时，使用 Trellis CLI 更新受影响的分类和阶段，并按影响范围重新核验。阶段可等待用户补充或因依赖阻塞；只有用户确认当前基线且阶段产物有效时，才以 `accepted` 离开本阶段。将阶段产物及引用提交 Trellis CLI 核验后，向用户展示简明基线并请求确认或修订。
+
+```mermaid
+flowchart TD
+  request["核对请求、项目背景和目标对象"] --> evidence["选择必要证据并核验现状"]
+  evidence --> baseline["整理目标、范围、成功条件与约束"]
+  baseline --> enough{"关键事实是否足以形成基线？"}
+  enough -->|"否，需用户补充"| ask["Trellis CLI 记录 needs_user_input；同步询问"]
+  ask --> wait["等待答复并留在目标探索与需求核对阶段"]
+  wait --> evidence
+  enough -->|"否，依赖阻断"| blocked["记录 blocked 与恢复条件"]
+  blocked -->|"依赖恢复后"| evidence
+  enough -->|"是"| output["形成 phase_output 并由 Trellis CLI 核验"]
+  output --> confirm["向用户展示当前基线并请求确认"]
+  confirm --> decision{"用户是否明确确认当前版本？"}
+  decision -->|"要求修订"| evidence
+  decision -->|"尚未确认"| wait
+  decision -->|"明确确认"| gate["以当前 artifact_revision 记录确认并接受阶段"]
+  gate --> route["按当前路线选择后续阶段；跳过决策空间构造与归并阶段也保留此确认"]
+```
+
+### 离开阶段的条件
+
+- `accepted` 及明确用户确认必须绑定当前 `artifact_revision`；产物改变后重新核验并取得确认。
+- `needs_user_input` 或 `blocked` 时不推进阶段游标。
+- `terminated` 不代表用户撤回任务；如用户明确撤回，按交付审查与现场收尾阶段中的取消审查处理。
+- 可从目标探索与需求核对阶段直接进入解决方案设计与收敛阶段，但不能绕过需求基线确认。