cowork-flow 0.0.33 → 0.0.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "description": "CLI for installing and maintaining cowork-flow collaboration templates.",
   "type": "module",
   "bin": {

package/template/.claude/agents/cowork-check.md

@@ -35,7 +35,7 @@ the task.
 
 Load context before checking:
 1. Read the task directory from the bound runtime context.
-2. Read `<task>/prd.md`.
+2. Read `<task>/decision-anchor.md`.
 3. Read the plan file linked from this task (check `<task>/task.json` `relatedFiles` for a plan path, or search `.cowork-flow/plans/` for a plan file referencing this task directory). Use the plan's Verify commands and Expected results as the checklist for each step.
 4. Read `<task>/check.jsonl`.
 5. Read `git diff`.

package/template/.claude/agents/cowork-implement.md

@@ -35,8 +35,8 @@ the task.
 
 Load context before editing:
 1. Read the task directory from the bound runtime context.
-2. Read `<task>/prd.md`.
-3. Read `<task>/info.md` if present.
+2. Read `<task>/decision-anchor.md`.
+3. Read .
 4. Read `<task>/implement.jsonl`.
 5. Read each JSONL `file` entry.
 6. Read the plan file linked from this task (check `<task>/task.json` `relatedFiles` for a plan path, or search `.cowork-flow/plans/` for a plan file referencing this task directory). Follow the plan steps in order — each step has Files, Action, Verify, and Expected fields.

package/template/.cowork-flow/.version

@@ -1 +1 @@
-0.0.33
+0.0.35

package/template/.cowork-flow/scripts/__init__.py

@@ -0,0 +1 @@
+"""Cowork Flow runtime scripts."""

package/template/.cowork-flow/scripts/commands/task.py

@@ -39,6 +39,7 @@ else:
     import _bootstrap  # noqa: F401
 from common.core.files import (
     read_json_file as _read_json_file,
+    read_text_utf8 as _read_text,
     write_json_file as _write_json_file,
 )
 from common.gates.gates import GateResult, GateRunner
@@ -466,17 +467,6 @@ def _write_jsonl(path: Path, entries: list[dict]) -> None:
     path.write_text("\n".join(lines) + "\n", encoding="utf-8")
 
 
-def _read_text_if_present(path: Path) -> str:
-    """读取文本文件并返回去空白后的内容；不存在或读取失败时返回空字符串。"""
-    if not path.is_file():
-        return ""
-
-    try:
-        return path.read_text(encoding="utf-8").strip()
-    except (OSError, IOError):
-        return ""
-
-
 def _task_start_blockers(task_dir: Path) -> list[str]:
     """返回启动任务前必须处理的准备阻塞项。"""
     blockers: list[str] = []
@@ -485,13 +475,17 @@ def _task_start_blockers(task_dir: Path) -> list[str]:
     if not task_json.is_file():
         blockers.append("task.json is missing")
 
-    prd_file = task_dir / "prd.md"
-    if not _read_text_if_present(prd_file):
-        blockers.append("prd.md is missing or empty")
+    # 只检查存在性 — R-WF-008 负责章节内容完整性
+    if _read_text(task_dir / "prd.md"):
+        # 旧格式：提示需要迁移（cmd_start 会自动迁移）
+        if not _read_text(task_dir / "decision-anchor.md"):
+            blockers.append("prd.md found; task start will auto-migrate to decision-anchor.md")
+    elif not _read_text(task_dir / "decision-anchor.md"):
+        blockers.append("decision-anchor.md is missing or empty")
 
     for jsonl_name in CONTEXT_JSONL_FILES:
         jsonl_file = task_dir / jsonl_name
-        if not _read_text_if_present(jsonl_file):
+        if not _read_text(jsonl_file):
             blockers.append(f"{jsonl_name} is missing or empty")
 
     return blockers
@@ -512,7 +506,7 @@ def _task_context_validation_issues(
 
     for jsonl_name in CONTEXT_JSONL_FILES:
         jsonl_file = task_dir / jsonl_name
-        if not _read_text_if_present(jsonl_file):
+        if not _read_text(jsonl_file):
             continue
 
         error_count = _validate_jsonl(jsonl_file, repo_root, quiet=quiet)
@@ -661,10 +655,29 @@ def cmd_create(args: argparse.Namespace) -> int:
 
                 print(colored(f"Linked as child of: {parent_dir.name}", Colors.GREEN), file=sys.stderr)
 
+    # --from-plan: 自动生成 decision-anchor.md 骨架
+    if getattr(args, "from_plan", None):
+        plan_path = Path(args.from_plan)
+        if plan_path.is_file():
+            plan_text = plan_path.read_text(encoding="utf-8")
+            goal = next(
+                (line.split(":", 1)[1].strip() for line in plan_text.splitlines()
+                 if line.startswith("**Goal:**") or line.startswith("**目标:**")),
+                None,
+            )
+            if goal:
+                anchor_file = task_dir / "decision-anchor.md"
+                if not anchor_file.exists():
+                    anchor_file.write_text(
+                        f"## 目标\n\n{goal}\n\n## 验收标准\n- [ ] \n",
+                        encoding="utf-8",
+                    )
+                    print(f"  {colored('[OK]', Colors.GREEN)} Generated decision-anchor.md from plan")
+
     print(colored(f"Created task: {dir_name}", Colors.GREEN), file=sys.stderr)
     print("", file=sys.stderr)
     print(colored("Next steps:", Colors.BLUE), file=sys.stderr)
-    print("  1. Create prd.md with requirements", file=sys.stderr)
+    print("  1. Create decision-anchor.md with requirements", file=sys.stderr)
     print("  2. Run: ./.cowork-flow/run task init-context <dir> <dev_type>", file=sys.stderr)
     print("  3. Run: ./.cowork-flow/run task start <dir>", file=sys.stderr)
     print("", file=sys.stderr)
@@ -961,11 +974,29 @@ def cmd_start(args: argparse.Namespace) -> int:
         for blocker in blockers:
             print(f"  - {blocker}", file=sys.stderr)
         print(
-            "Hint: write prd.md, run ./.cowork-flow/run task init-context <dir> <dev_type>, then retry",
+            "Hint: write decision-anchor.md, run ./.cowork-flow/run task init-context <dir> <dev_type>, then retry",
             file=sys.stderr,
         )
         return 1
 
+    # 自动迁移旧 prd.md 到 decision-anchor.md
+    prd_file = full_path / "prd.md"
+    anchor_file = full_path / "decision-anchor.md"
+    if prd_file.exists() and not anchor_file.exists():
+        content = prd_file.read_text(encoding="utf-8").strip()
+        if not content:
+            content = "(empty legacy prd.md)"
+        if "## 目标" not in content and "## Goal" not in content:
+            content = "## 目标\n\n" + content
+        if "## 验收标准" not in content and "## Acceptance" not in content:
+            content += "\n\n## 验收标准\n- [ ] \n"
+        anchor_file.write_text(content, encoding="utf-8")
+        prd_file.unlink()
+        print(
+            colored("  [迁移] prd.md → decision-anchor.md", Colors.YELLOW),
+            file=sys.stderr,
+        )
+
     validation_issues = _task_context_validation_issues(full_path, repo_root)
     if validation_issues:
         print(colored("Error: Task context validation failed", Colors.RED), file=sys.stderr)
@@ -1937,6 +1968,7 @@ def main() -> int:
     p_create.add_argument("--priority", "-p", default="P2", help="Priority (P0-P3)")
     p_create.add_argument("--description", "-d", help="Task description")
     p_create.add_argument("--parent", help="Parent task directory (establishes subtask link)")
+    p_create.add_argument("--from-plan", "-f", help="Path to plan file (auto-generate decision-anchor skeleton)")
 
     # init-context
     p_init = subparsers.add_parser("init-context", help="Initialize context files")

package/template/.cowork-flow/scripts/common/core/execution_context.py

@@ -268,8 +268,8 @@ def build_worker_resume_text(
             if isinstance(file_value, str) and file_value.strip():
                 suffix = f" - {reason}" if isinstance(reason, str) and reason.strip() else ""
                 lines.append(f"- {file_value}{suffix}")
-    if context.task_dir and (repo_root / context.task_dir / "prd.md").is_file():
-        lines.append(f"- Read task PRD: {context.task_dir}/prd.md")
+    if context.task_dir and (repo_root / context.task_dir / "decision-anchor.md").is_file():
+        lines.append(f"- Read task PRD: {context.task_dir}/decision-anchor.md")
     lines.append("- Follow only the files, steps, and commands named in the worker brief.")
 
     forbidden_actions = context_data.get("forbiddenActions")

package/template/.cowork-flow/scripts/common/gates/tdd_evidence.py

@@ -1,5 +1,14 @@
 #!/usr/bin/env python3
-"""TDD evidence validation for task review gates."""
+"""
+TDD 红绿证据校验（task_review / task_complete 阶段）。
+
+读取 <task>/tdd.jsonl，验证每条 evidence 或 exemption 记录的结构完整
+性与业务意图。验证结果分两类出口：
+- validate_tdd_evidence: 全量校验（review 阶段）
+- validate_tdd_red_evidence: 仅检查 red 证据完整性（implement 入口提醒）
+
+acceptanceId 的提取同时支持 AC-001、AC-1、验收标准：1 三种写法。
+"""
 
 from __future__ import annotations
 
@@ -82,7 +91,7 @@ SETUP_FAILURE_MARKERS = (
 def validate_tdd_evidence(task_dir: Path) -> list[dict]:
     """Return TDD evidence violations for a task directory."""
     task_dir = Path(task_dir)
-    prd_text = _read_text(task_dir / "prd.md")
+    prd_text = _read_text(task_dir / "decision-anchor.md")
     evidence_path = task_dir / EVIDENCE_FILE
 
     if not evidence_path.is_file():
@@ -127,7 +136,7 @@ def validate_tdd_evidence(task_dir: Path) -> list[dict]:
 def validate_tdd_red_evidence(task_dir: Path) -> list[dict]:
     """Return violations when implementation would start without red evidence."""
     task_dir = Path(task_dir)
-    prd_text = _read_text(task_dir / "prd.md")
+    prd_text = _read_text(task_dir / "decision-anchor.md")
     if not _task_requires_tdd(prd_text):
         return []
 
@@ -210,7 +219,10 @@ def _read_jsonl(path: Path) -> tuple[list[dict], list[dict]]:
 
 
 def _acceptance_ids(prd_text: str) -> set[str]:
-    return set(re.findall(r"\bAC-\d{3}\b", prd_text))
+    """提取验收标准 ID，支持 AC-001、AC-1、验收标准：1 等格式。"""
+    ids = set(re.findall(r"\bAC-(\d{1,4})\b", prd_text, re.IGNORECASE))
+    ids |= set(re.findall(r"验收标准[：:]\s*(\d+)", prd_text))
+    return {f"AC-{n}" for n in ids}
 
 
 def _validate_evidence(

package/template/.cowork-flow/scripts/common/gates/validate_implementation.py

@@ -1,8 +1,13 @@
 #!/usr/bin/env python3
 """
-Implementation validation script.
+R-AG-002 到 R-AG-009 的门禁检查器。
 
-Validates code changes against forbidden action rules after task implementation.
+在 task_review 阶段运行：通过 git diff 获取工作树的未提交改动，逐项
+检查 forbidden_action 规则。每项规则以 (repo_root, modified_files, diff_output,
+rule_index) 为入参，返回 violation dict 列表。
+
+结果汇总到 GateResult：存在 severity=block 的 violation 时阻断 review 流程，
+warn 级别仅输出警告。
 """
 
 from __future__ import annotations
@@ -186,29 +191,54 @@ def _check_unrequested_features(
     task_dir: Path,
     rule_index: dict[str, dict],
 ) -> list[dict]:
-    """R-AG-005: Check if unrequested features were introduced"""
+    """R-AG-005: Check if unrequested files were modified (diff files must be in implement.jsonl)."""
     violations = []
 
-    # Read PRD
-    prd_path = task_dir / "prd.md"
-    if not prd_path.exists():
+    # Collect allowed files from implement.jsonl
+    implement_jsonl = task_dir / "implement.jsonl"
+    if not implement_jsonl.exists():
         return violations
 
-    prd_content = prd_path.read_text(encoding="utf-8")
+    allowed_files: set[str] = set()
+    try:
+        for line in implement_jsonl.read_text(encoding="utf-8").splitlines():
+            line = line.strip()
+            if not line:
+                continue
+            try:
+                entry = json.loads(line)
+            except json.JSONDecodeError:
+                continue
+            file_path = entry.get("file")
+            if isinstance(file_path, str) and file_path:
+                # Normalize paths (strip repo root prefix if present)
+                allowed_files.add(file_path)
+                # Also add stripped versions for matching
+                if file_path.startswith("./"):
+                    allowed_files.add(file_path[2:])
+                else:
+                    allowed_files.add(f"./{file_path}")
+    except (OSError, UnicodeDecodeError):
+        return violations
 
-    # Check for obvious extra features
-    # This is a simple heuristic check, actual implementation may need more complex NLP analysis
-    feature_indicators = [
-        r"Added.*feature",
-        r"New.*functionality",
-        r"Implemented.*module",
-    ]
+    if not allowed_files:
+        return violations
 
-    for pattern in feature_indicators:
-        if re.search(pattern, diff_output) and not re.search(pattern, prd_content):
+    # Get modified project files (exclude .cowork-flow/ metadata)
+    modified_files = _get_modified_files(repo_root)
+    for file_path in modified_files:
+        # Skip .cowork-flow metadata files and template files
+        if ".cowork-flow/" in file_path:
+            continue
+        normalized = file_path.replace("\\", "/")
+        # Check if file is in allowed list
+        if normalized not in allowed_files and f"./{normalized}" not in allowed_files:
             rule = rule_index.get("R-AG-005")
             violations.append(
-                rule_violation(rule, "", detail=f"detected pattern: {pattern}")
+                rule_violation(
+                    rule, file_path,
+                    detail=f"modified file not in implement.jsonl allowed list"
+                )
                 if rule
                 else _missing_rule(repo_root, "R-AG-005")
             )

package/template/.cowork-flow/scripts/common/git/git_context.py

@@ -189,7 +189,7 @@ def _get_active_task_snapshot(repo_root: Path) -> ActiveTaskSnapshot:
     return ActiveTaskSnapshot(
         path=active_task,
         data=data,
-        has_prd=(active_task_dir / "prd.md").is_file(),
+        has_prd=(active_task_dir / "decision-anchor.md").is_file(),
     )
 
 
@@ -271,7 +271,7 @@ def _build_resume_checklist(
     commands.append(f"./{DIR_WORKFLOW}/run task list-context {active_task}")
 
     if snapshot.has_prd:
-        read_files.append(f"{active_task}/prd.md")
+        read_files.append(f"{active_task}/decision-anchor.md")
 
     read_files.extend(_task_plan_references(repo_root, snapshot))
     notes.append("Read current plan status only when continuing implementation.")
@@ -314,7 +314,7 @@ def _append_resume_checklist(
         return
 
     active_task = snapshot.path
-    prd_path = f"{active_task}/prd.md"
+    prd_path = f"{active_task}/decision-anchor.md"
     if prd_path in read_files:
         lines.append(f"- Read active task PRD: {prd_path}")
     else:
@@ -362,7 +362,7 @@ def _append_active_task(
 
     if include_prd_hint and snapshot.has_prd:
         lines.append("")
-        lines.append("[!] This task has prd.md - read it for task details")
+        lines.append("[!] This task has decision-anchor.md - read it for task details")
     lines.append("")
 
 

package/template/.cowork-flow/scripts/common/task/readiness.py

@@ -11,13 +11,13 @@ from .task_utils import find_task_by_name
 
 REQUIRED_L2_MARKERS = {
     "goal and user value": (
-        ("## goal", "## problem", "目标"),
+        ("## goal", "## problem", "## 目标", "目标"),
         ("## benefits", "user value", "用户价值", "价值"),
     ),
-    "non-goals": (("## non-goals", "non-goals", "非目标"),),
-    "key assumptions": (("assumption", "assumptions", "关键假设"),),
-    "scope boundary": (("## scope", "scope boundary", "范围边界", "scope:"),),
-    "acceptance criteria": (("acceptance criteria", "## acceptance", "验收标准", "验收"),),
+    "non-goals": (("## non-goals", "non-goals", "## 非目标", "非目标"),),
+    "key assumptions": (("assumption", "assumptions", "## 关键假设", "关键假设"),),
+    "scope boundary": (("## scope", "scope boundary", "## 范围边界", "范围边界", "scope:"),),
+    "acceptance criteria": (("acceptance criteria", "## acceptance", "## 验收标准", "验收标准", "验收"),),
 }
 
 VERIFICATION_COMMAND_MARKERS = (
@@ -167,10 +167,10 @@ def _read_l2_context(repo_root: Path, change_dir: Path, plan_path: Path | None,
         _read_text(change_dir / "proposal.md"),
         _read_text(change_dir / "spec.md"),
         _read_text(change_dir / "design.md"),
-        _read_text(task_dir / "prd.md"),
+        _read_text(task_dir / "decision-anchor.md"),
     ]
     for ancestor in _task_ancestry(repo_root, task_dir)[1:]:
-        parts.append(_read_text(ancestor / "prd.md"))
+        parts.append(_read_text(ancestor / "decision-anchor.md"))
     if plan_path is not None:
         parts.append(_read_text(plan_path))
     return "\n\n".join(part for part in parts if part)

package/template/.cowork-flow/spec/contracts/decision-anchor.md

@@ -0,0 +1,68 @@
+# Decision Anchor Contract
+
+**每个 task 必须有 `decision-anchor.md`，它是执行时防止漂移的唯一权威决策来源。**
+
+它合并并替代了原来的 `prd.md`，同时承载"做什么"和"为什么不这么做"两个职责，压缩任务产物数量。
+
+## Schema
+
+```markdown
+# Decision Anchor
+
+## 目标
+<一句话>
+
+## 验收标准
+- [ ] AC-001: <可验证>
+- [ ] AC-002: <可验证>
+
+## 被拒方案（可选）
+- **方案B**: <简述> — 拒绝原因: <为什么>
+
+## 关键假设（可选）
+- <假设1>
+
+## 范围边界（可选）
+- 范围内: <列出>
+- 范围外: <列出>
+
+## 验证命令（可选）
+- `<command>` → <expected>
+```
+
+## 章节要求
+
+| 章节 | 必填 | 原因 |
+|------|------|------|
+| `## 目标` | 必备 | 没有目标就没有验收基准 |
+| `## 验收标准` | 必备 | 没有验收标准 task_start 会被阻断 |
+| `## 被拒方案` | 可选 | brainstorming 任务必填，防止执行时重新考虑被拒方案 |
+| `## 关键假设` | 可选 | 复杂任务填写，暴露隐性约束 |
+| `## 范围边界` | 可选 | 防止范围蔓延 |
+| `## 验证命令` | 可选 | 复杂任务填写，作为自动验证依据 |
+
+## 场景
+
+| 场景 | 来源 | 填充内容 |
+|------|------|---------|
+| 有 brainstorming | 从讨论结论提取 | 全部章节 |
+| 无 brainstorming（需求明确） | 从需求描述和 plan 提取 | 最小：目标 + 验收标准 |
+
+## 产物压缩
+
+合并前（6个文件）：`prd.md` + `implement.jsonl` + `check.jsonl` + `debug.jsonl` + `tdd.jsonl` + `task.json`
+
+合并后（5个文件）：`decision-anchor.md` + `implement.jsonl` + `check.jsonl` + `debug.jsonl` + `tdd.jsonl` + `task.json`
+
+**净减 1 个文件类型。相关文件追踪现在由 implement.jsonl 统一负责。**
+
+## Gate 联动
+
+- `R-WF-008`: task_start 阶段阻断，检查 `## 目标` 和 `## 验收标准` 章节存在
+- `cowork-implement` 读取：见 .cowork-flow/spec/contracts/subagent-dispatch.md
+- `cowork-check` 读取：同上
+- `debug.jsonl` 引用：可选，偏差诊断时写入 anchor 锚点差异
+
+## 迁移
+
+已有 `prd.md` 的任务：首次 `task start` 时自动搬运内容，加默认章节标题，删除 `prd.md`。

package/template/.cowork-flow/spec/contracts/workflow-state-templates.md

@@ -50,7 +50,7 @@ are constraints only; they are not the task itself.
 ## planning
 
 [workflow-state:planning]
-活动任务处于计划阶段。先完成 prd.md，整理带有规格/调研文件的 implement.jsonl 和 check.jsonl，再运行 task start，之后才派发 cowork-implement。
+活动任务处于计划阶段。先完成 decision-anchor.md，整理带有规格/调研文件的 implement.jsonl 和 check.jsonl，再运行 task start，之后才派发 cowork-implement。
 [/workflow-state:planning]
 
 ## in_progress

package/template/.cowork-flow/spec/references/definition-of-done.md

@@ -41,5 +41,5 @@
 | DoD | AC |
 |---|---|
 | 项目级不变量——本次任务不例外 | PRD 特有的完成条件 |
-| 来源：spec/references/definition-of-done | 来源：<task>/prd.md |
+| 来源：spec/references/definition-of-done | 来源：<task>/decision-anchor.md |
 | 两者都满足 = 任务真正完成 |

package/template/.cowork-flow/spec/runtime/rules.json

@@ -221,7 +221,7 @@
       "id": "R-WF-011",
       "type": "phase_gate",
       "severity": "warn",
-      "scope": "task_archive",
+      "scope": "all",
       "condition": "Archive should happen before final commit to avoid committing unreviewed code",
       "message": "Uncommitted changes detected. Archive the task first, then commit the archived result.",
       "fix_hint": "Run './.cowork-flow/run task archive <name>' first. Then commit the archive result.",

package/template/.cowork-flow/spec/schemas/rules.schema.json

@@ -38,7 +38,7 @@
           },
           "scope": {
             "type": "string",
-            "enum": ["task_start", "task_review", "task_complete", "check", "implement", "all"],
+            "enum": ["task_start", "task_review", "task_complete", "check", "implement", "task_archive", "all"],
             "description": "Scope where rule applies"
           },
           "condition": {

package/template/.cowork-flow/workflow.md

@@ -47,7 +47,7 @@ changes -> brainstorming -> read spec -> plan -> tasks -> implement -> check ->
 | --- | --- |
 | 开发者身份 | `.cowork-flow/.developer` |
 | 当前会话任务 | `.cowork-flow/.runtime/sessions/<context-key>.json` |
-| 任务目标 | `.cowork-flow/tasks/<task>/prd.md` |
+| 任务目标 | `.cowork-flow/tasks/<task>/decision-anchor.md` |
 | 实现上下文 | `.cowork-flow/tasks/<task>/implement.jsonl` |
 | 检查上下文 | `.cowork-flow/tasks/<task>/check.jsonl` |
 | 调试上下文 | `.cowork-flow/tasks/<task>/debug.jsonl` |
@@ -77,8 +77,8 @@ changes -> brainstorming -> read spec -> plan -> tasks -> implement -> check ->
 | 代理 | 读取 | 允许 | 禁止 | 输出 |
 | --- | --- | --- | --- | --- |
 | `cowork-research` | 任务上下文和调研输入 | 只做调研，只写入 `<task>/research/` | 改代码、改规格、改任务状态、操作 Git | 调研结论和证据 |
-| `cowork-implement` | `<task>/prd.md`、`<task>/info.md`、`<task>/implement.jsonl` 和 JSONL 指向的文件 | 按任务范围实现 | 启动其他代理、提交、归档、运行 `task start`、`task finish` 或 `task archive` | 改动文件和验证命令 |
-| `cowork-check` | `<task>/prd.md`、`<task>/check.jsonl` 和 `git diff` | 检查行为、测试、规格同步和遗漏；范围内问题直接修复 | 提交、归档、启动其他代理 | 检查结论、修复内容和验证结果 |
+| `cowork-implement` | `<task>/decision-anchor.md`、`<task>/implement.jsonl` 和 JSONL 指向的文件 | 按任务范围实现 | 启动其他代理、提交、归档、运行 `task start`、`task finish` 或 `task archive` | 改动文件和验证命令 |
+| `cowork-check` | `<task>/decision-anchor.md`、`<task>/check.jsonl` 和 `git diff` | 检查行为、测试、规格同步和遗漏；范围内问题直接修复 | 提交、归档、启动其他代理 | 检查结论、修复内容和验证结果 |
 
 ## 3.1 固定代理派发入口
 
@@ -160,7 +160,7 @@ L2 任务在 `task start` 前必须通过 readiness gate；同一 blocker 列表
     ```bash
     ./.cowork-flow/run task create "<title>" --slug <task-name>
     ```
-6. 对创建的每项任务写 `prd.md`，至少包含目标、范围、验收标准、相关文件、验证方式。
+6. 对创建的每项任务写 `decision-anchor.md`，至少包含 `## 目标` 和 `## 验收标准` 两个章节。相关文件通过 `implement.jsonl` 跟踪（运行 `task add-context` 添加）。
 7. 初始化上下文：
     ```bash
     ./.cowork-flow/run task init-context <task-dir> <type>

package/template/.opencode/agents/cowork-check.md

@@ -36,7 +36,7 @@ signal.
 Rules:
 
 - Read the task directory from the bound runtime context.
-- Read `<task>/prd.md`, the plan file linked from this task (check `<task>/task.json` `relatedFiles` for a plan path, or search `.cowork-flow/plans/`), `<task>/check.jsonl`, each JSONL `file` entry, and
+- Read `<task>/decision-anchor.md`, the plan file linked from this task (check `<task>/task.json` `relatedFiles` for a plan path, or search `.cowork-flow/plans/`), `<task>/check.jsonl`, each JSONL `file` entry, and
   current `git diff`.
 - Check behavior, tests, spec sync, and scope.
 - Fix only in-scope issues.

package/template/.opencode/agents/cowork-implement.md

@@ -175,7 +175,7 @@ You MUST NOT do any of the following:
 
 1. Bind runtime context: `./.cowork-flow/run subagent bind <runtime_context_id> <host_context_key>`
 2. Read task directory from bound runtime context
-3. Read `<task>/prd.md`, `<task>/info.md`, `<task>/implement.jsonl`, and each JSONL `file` entry
+3. Read `<task>/decision-anchor.md`, `<task>/implement.jsonl`, and each JSONL `file` entry
 4. Read the plan file linked from this task (check `<task>/task.json` `relatedFiles` for a plan path, or search `.cowork-flow/plans/` for a plan file referencing this task directory). Follow the plan steps in order — each step has Files, Action, Verify, and Expected fields.
 5. Read pre-implementation checklist: `.cowork-flow/spec/guides/pre-implementation-checklist.md`
 6. Read relevant spec directory (backend or frontend) and ALL linked documents
@@ -190,7 +190,7 @@ You MUST NOT do any of the following:
 Rules:
 
 - Read the task directory from the bound runtime context.
-- Read `<task>/prd.md`, `<task>/info.md` if present, `<task>/implement.jsonl`,
+- Read `<task>/decision-anchor.md`, `<task>/implement.jsonl`,
   and each JSONL `file` entry.
 - Read the plan file linked from this task. Follow the plan steps in order.
 - Keep edits inside the assigned scope.

package/template/.opencode/agents/cowork-research.md

@@ -38,7 +38,7 @@ signal.
 Rules:
 
 - Read the task directory and assignment from the bound runtime context.
-- Read `<task>/prd.md`, `<task>/info.md` if present, and prompt-named context.
+- Read `<task>/decision-anchor.md`, and prompt-named context.
 - Write research only under `<task>/research/`.
 - Do not edit code, specs, task state, or git state.
 - Do not use the `task` tool or invoke subagents.

package/template/.zcode/.zcode-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "cowork-flow",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "description": "AI 协作工作流引擎：任务生命周期、子代理调度、门禁与状态注入。将 cowork-flow 的完整工作流带入 ZCode。",
   "author": {
     "name": "fisklikewater"

package/template/.zcode/hooks/runtime/scripts/__init__.py

@@ -0,0 +1 @@
+"""Cowork Flow zcode plugin runtime scripts."""