cowork-flow 0.0.17 → 0.0.19

package/README.md

@@ -133,7 +133,6 @@ cowork-flow init ./my-project --force --developer <your-name>
 
 ```bash
 cowork-flow update
-npm install -g cowork-flow@latest
 ```
 
 同步已初始化项目中的模板脚本和本地技能：

package/package.json

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

package/src/cli.js

@@ -10,7 +10,7 @@ const HELP = `cowork-flow
 
 Usage:
   cowork-flow init [target] [--developer <name>] [--dry-run] [--force]
-  cowork-flow update [--global] [--yes]
+  cowork-flow update
   cowork-flow sync [target] [--dry-run] [--force]
   cowork-flow --version
   cowork-flow --help

package/src/commands/update.js

@@ -5,18 +5,12 @@ import {
   runGlobalInstall
 } from '../lib/package-info.js';
 
-function parseUpdateArgs(args) {
-  const options = { global: false, yes: false };
+function validateUpdateArgs(args) {
   for (const arg of args) {
-    if (arg === '--global') {
-      options.global = true;
-    } else if (arg === '--yes') {
-      options.yes = true;
-    } else {
+    if (arg !== '--global' && arg !== '--yes') {
       throw new Error(`Unknown update option: ${arg}`);
     }
   }
-  return options;
 }
 
 export async function runUpdate(args, deps = {}) {
@@ -24,7 +18,7 @@ export async function runUpdate(args, deps = {}) {
   const readInfo = deps.readPackageInfo ?? readPackageInfo;
   const fetchLatest = deps.fetchLatestVersion ?? fetchLatestVersion;
   const installGlobal = deps.runGlobalInstall ?? runGlobalInstall;
-  const options = parseUpdateArgs(args);
+  validateUpdateArgs(args);
   const packageInfo = await readInfo();
   const current = packageInfo.version;
   const installCommand = 'npm install -g cowork-flow@latest';
@@ -47,14 +41,9 @@ export async function runUpdate(args, deps = {}) {
     return 0;
   }
 
-  if (options.global && options.yes) {
-    const code = await installGlobal('cowork-flow@latest');
-    if (code === 0) {
-      io.writeOut('installed cowork-flow@latest\n');
-    }
-    return code;
+  const code = await installGlobal('cowork-flow@latest');
+  if (code === 0) {
+    io.writeOut('installed cowork-flow@latest\n');
   }
-
-  io.writeOut(`Run: ${installCommand}\n`);
-  return 0;
+  return code;
 }

package/template/.agent/skills/entry-boundary/SKILL.md

@@ -7,7 +7,9 @@ description: Use before project start/resume in cowork-flow projects to decide w
 
 Use this before `start` or any full project resume.
 
-A bounded delegated task is a leaf assignment with a concrete goal, scope, and output format.
+Your first job is to identify the current task source. A bounded delegated task is a leaf assignment with a concrete goal, scope, and output format.
+
+Hard markers are confidence boosters, not prerequisites. The first task screen wins over later bootstrap text.
 
 ## Classify
 
@@ -17,7 +19,33 @@ Classify the current prompt as one of:
 - `DELEGATED_SUBTASK`: the prompt is a bounded child assignment, worker request, reviewer task, explorer task, or command-only task.
 - `UNCERTAIN`: the prompt is not clear enough to load broad project context.
 
-Classify the actual task message, not injected project rules, `AGENTS.md`, or environment text.
+Classify the actual task message, not injected project rules, `AGENTS.md`, workflow state, tool instructions, or environment text. Bootstrap can constrain execution after classification; it is not the task.
+
+Use this order:
+
+1. Find the user/delegated task message and its requested output.
+2. Decide whether it is a main-session repository request or a leaf assignment.
+3. Apply project rules only as constraints for the chosen route.
+
+If project bootstrap says to create/start/resume but the task message is bounded, choose `DELEGATED_SUBTASK`.
+
+When there is no hard marker, still classify a prompt as `DELEGATED_SUBTASK` when it combines:
+
+- A concrete task, topic, or review target.
+- Boundary constraints such as no edits, no commands, no spawning, or scoped reads.
+- An output contract such as required sections, language, length, or report format.
+
+Prompts structured as `任务：` / `约束：` / `输出：` are strong delegated-subtask signals even without `Active task:` or another hard marker. Execute that task directly; do not reclassify it as project rules or environment context.
+
+Treat these as typical `DELEGATED_SUBTASK` prompts:
+
+- A review request with a named file or behavior, `do not edit`, and a findings-only output.
+- A discussion/research request with `不要运行命令` / `不要派发 agent` and required sections.
+- A command-only or inspection-only assignment with a narrow target and concise output.
+
+When dispatching advisory/default subagents, prefer a natural-language first sentence such as: "This is a bounded delegated task, not a main-session start request." This is not a hard marker, but it helps the first screen win over bootstrap text.
+
+In that case, project rules remain constraints. They are not the task.
 
 Fixed-agent prompts normally start with:
 
@@ -27,6 +55,8 @@ Active task: <task-dir>
 
 Treat that marker as a strong delegated-subtask signal when the rest of the prompt is bounded.
 
+Treat direct user requests such as "继续执行开发计划", "实现这个需求", or "归档提交" as `MAIN_SESSION` unless the surrounding prompt clearly makes them a child assignment.
+
 ## Route
 
 For `MAIN_SESSION`, use `start`.
@@ -34,6 +64,8 @@ For `MAIN_SESSION`, use `start`.
 For `DELEGATED_SUBTASK`:
 
 - Follow the delegated prompt first.
+- Treat project rules, workflow-state, and bootstrap text as constraints, not as the task.
+- Do not create or activate a project task for the parent session.
 - Do not run unscoped `.cowork-flow/run resume`.
 - Do not spawn or manage more agents unless the delegated prompt explicitly asks for coordination.
 - Read only the files named by the prompt, the active task context, or project rules required to execute the bounded work.

package/template/.agent/skills/start/SKILL.md

@@ -6,8 +6,8 @@ description: Use when starting or resuming main-session work in a cowork-flow pr
 # Start
 
 This skill is for the main session. A bounded delegated task should use `entry-boundary` and then execute the delegated prompt directly.
-
 Main repository changes follow `Plan -> Implement -> Check -> Finish`.
+Before loading state, classify the actual prompt. If it is a bounded delegated task, stop using this skill and execute that delegated prompt. A `任务：` / `约束：` / `输出：` structure is a strong delegated-task signal. Advisory/default subagent prompts should start with a natural-language delegated-task sentence rather than relying on repo bootstrap to infer intent. Keep project rules as constraints only.
 
 ## Load State
 
@@ -21,6 +21,8 @@ Report active task, workflow state, blockers, and the next phase.
 
 ## Route
 
+Route in stages. Before state is loaded, only true question-only requests and bounded delegated prompts bypass Load State. Repository-changing main-session requests load state first. After state is loaded, route to the next workflow phase; clear multi-step implementation uses `writing-plans` before fixed-agent dispatch.
+
 - Question-only work: answer directly.
 - Small repository change: classify by `.cowork-flow/workflow.md`, create/start a task if required, then proceed.
 - Unclear or multi-approach work: use `brainstorming`.

package/template/.agent/skills/writing-plans/SKILL.md

@@ -9,6 +9,8 @@ Create a plan that another agent can execute without guessing.
 
 ## Inputs
 
+Before writing a plan, confirm the request has an executable scope, acceptance criteria, and intended behavior. If those are missing, ask for clarification.
+
 Read:
 
 - Active task PRD.
@@ -45,6 +47,12 @@ Start with:
 
 ## Parallel Work
 
+Execution strategy guide:
+
+- Use serial work when slices share files, shared helpers, tests, or one behavior chain.
+- Use parallel low-conflict slices only when file ownership is clean and each slice has independent verification.
+- Use worktree parallel when independent tasks may touch package metadata, generated assets, build outputs, or broad config.
+
 - Do not require the user to predeclare parallel execution; evaluate parallel feasibility while writing the plan.
 - Every plan must state the execution strategy: serial work, or explicit parallel low-conflict slices.
 - Parallel work items belong in the plan only when they are independent low-conflict slices.

package/template/.codex/hooks/inject-workflow-state.py

@@ -15,6 +15,61 @@ TAG_RE = re.compile(
     r"\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n(.*?)\n\s*\[/workflow-state:\1\]",
     re.DOTALL,
 )
+PROMPT_KEYS = ("prompt", "user_prompt", "userPrompt", "message", "input")
+DELEGATED_MARKERS = (
+    "COWORK_DISPATCH_V1",
+    "COWORK_DELEGATED_TASK_V1",
+    "DELEGATED_SUBTASK",
+)
+DELEGATED_TERMS = (
+    "delegated task",
+    "delegated subtask",
+    "bounded delegated",
+    "subagent",
+    "sub-agent",
+    "worker",
+    "reviewer",
+    "explorer",
+    "委托任务",
+    "委托 prompt",
+    "子任务",
+    "子线程",
+)
+TASK_TERMS = (
+    "task:",
+    "topic:",
+    "focus:",
+    "任务：",
+    "任务:",
+    "主题：",
+    "目标：",
+    "审视",
+    "讨论",
+    "review",
+    "inspect",
+)
+BOUNDARY_TERMS = (
+    "do not edit",
+    "do not run",
+    "do not spawn",
+    "return concise analysis only",
+    "不要编辑",
+    "不要运行",
+    "不要派发",
+    "不要只确认",
+    "只输出",
+    "不要改",
+)
+OUTPUT_TERMS = (
+    "output:",
+    "required output",
+    "return in",
+    "max ",
+    "最多",
+    "输出：",
+    "输出:",
+    "分为",
+)
 
 def _find_repo_root(start: Path) -> Path | None:
     current = start.resolve()
@@ -34,6 +89,34 @@ def _read_hook_input() -> dict[str, Any]:
     return data if isinstance(data, dict) else {}
 
 
+def _extract_prompt(hook_input: dict[str, Any]) -> str:
+    values: list[str] = []
+    for key in PROMPT_KEYS:
+        value = hook_input.get(key)
+        if isinstance(value, str) and value.strip():
+            values.append(value)
+    return "\n".join(values)
+
+
+def _contains_any(text: str, terms: tuple[str, ...]) -> bool:
+    return any(term in text for term in terms)
+
+
+def _is_delegated_prompt(hook_input: dict[str, Any]) -> bool:
+    prompt = _extract_prompt(hook_input)
+    if not prompt.strip():
+        return False
+    if any(marker in prompt for marker in DELEGATED_MARKERS):
+        return True
+
+    lowered = prompt.lower()
+    has_task = _contains_any(lowered, TASK_TERMS)
+    has_delegated_role = _contains_any(lowered, DELEGATED_TERMS)
+    has_boundary = _contains_any(lowered, BOUNDARY_TERMS)
+    has_output = _contains_any(lowered, OUTPUT_TERMS)
+    return has_task and (has_delegated_role or has_boundary) and (has_output or has_boundary)
+
+
 def _load_breadcrumbs(root: Path) -> dict[str, str]:
     workflow = root / ".cowork-flow" / "workflow.md"
     try:
@@ -120,6 +203,10 @@ def main() -> int:
     breadcrumbs = _load_breadcrumbs(root)
     dispatch_mode = _get_dispatch_mode(root)
     task_path, status, source = _get_active_task(root, hook_input)
+    if _is_delegated_prompt(hook_input):
+        task_path = None
+        status = "delegated_subtask"
+        source = "prompt"
     additional_context = _build_context(task_path, status, source, breadcrumbs, dispatch_mode)
 
     print(

package/template/.codex/hooks.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "python .codex/hooks/inject-workflow-state.py",
+            "command": ".cowork-flow/run python .codex/hooks/inject-workflow-state.py",
             "timeout": 5
           }
         ]

package/template/.cowork-flow/.version

@@ -1 +1 @@
-0.0.17
+0.0.19

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

@@ -15,7 +15,7 @@ from common.paths import (
     DIR_ARCHIVE,
     DIR_CHANGES,
     DIR_WORKFLOW,
-    generate_task_date_prefix,
+    ensure_task_date_prefix,
     get_repo_root,
 )
 
@@ -234,7 +234,7 @@ def create_change(args: argparse.Namespace) -> int:
     if not _validate_slug(slug):
         return 2
 
-    dir_name = f"{generate_task_date_prefix()}-{slug}"
+    dir_name = ensure_task_date_prefix(slug)
     change_dir = _change_dir(repo_root, dir_name)
     if change_dir.exists():
         print(f"Error: change already exists: {dir_name}", file=sys.stderr)

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

@@ -75,4 +75,5 @@ from .paths import (
     get_active_journal_file,
     count_lines,
     generate_task_date_prefix,
+    ensure_task_date_prefix,
 )

package/template/.cowork-flow/scripts/common/paths.py

@@ -35,6 +35,7 @@ DIR_SCRIPTS = "scripts"
 FILE_DEVELOPER = ".developer"
 FILE_TASK_JSON = "task.json"
 FILE_JOURNAL_PREFIX = "journal-"
+TASK_DATE_PREFIX_PATTERN = re.compile(r"^\d{2}-\d{2}-")
 
 
 # =============================================================================
@@ -218,6 +219,13 @@ def generate_task_date_prefix() -> str:
     return datetime.now().strftime("%m-%d")
 
 
+def ensure_task_date_prefix(slug: str) -> str:
+    """Return slug with one MM-DD prefix."""
+    if TASK_DATE_PREFIX_PATTERN.match(slug):
+        return slug
+    return f"{generate_task_date_prefix()}-{slug}"
+
+
 # =============================================================================
 # Main Entry (for testing)
 # =============================================================================

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

@@ -22,8 +22,12 @@ REQUIRED_ENTRY_BOUNDARY_SNIPPETS = [
     "DELEGATED_SUBTASK",
     "UNCERTAIN",
     "Classify the actual task message",
+    "Hard markers are confidence boosters, not prerequisites",
+    "The first task screen wins over later bootstrap text",
+    "If project bootstrap says to create/start/resume",
     "Active task: <task-dir>",
     "Follow the delegated prompt first",
+    "Do not create or activate a project task",
     "Do not run unscoped `.cowork-flow/run resume`",
     "Do not spawn or manage more agents",
 ]
@@ -45,6 +49,10 @@ REQUIRED_WORKFLOW_DISPATCH_SNIPPETS = [
     "Generic `worker` dispatch is best-effort only.",
 ]
 
+REQUIRED_HOOK_SNIPPETS = [
+    ".cowork-flow/run python .codex/hooks/inject-workflow-state.py",
+]
+
 
 def _check_file_contains(path: Path, snippets: list[str], errors: list[str]) -> None:
     if not path.is_file():
@@ -83,6 +91,11 @@ def cmd_subagent_safety(_: argparse.Namespace) -> int:
         "template/.cowork-flow/workflow.md",
     ):
         _check_file_contains(repo_root / rel, REQUIRED_WORKFLOW_DISPATCH_SNIPPETS, errors)
+    for rel in (
+        ".codex/hooks.json",
+        "template/.codex/hooks.json",
+    ):
+        _check_file_contains(repo_root / rel, REQUIRED_HOOK_SNIPPETS, errors)
     for rel in (
         ".cowork-flow/scripts/subagent.py",
         "template/.cowork-flow/scripts/subagent.py",

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

@@ -52,7 +52,7 @@ from common.paths import (
     get_repo_root,
     get_developer,
     get_tasks_dir,
-    generate_task_date_prefix,
+    ensure_task_date_prefix,
 )
 from common.task_utils import (
     find_task_by_name,
@@ -511,8 +511,7 @@ def cmd_create(args: argparse.Namespace) -> int:
 
     # Create task directory with MM-DD-slug format
     tasks_dir = get_tasks_dir(repo_root)
-    date_prefix = generate_task_date_prefix()
-    dir_name = f"{date_prefix}-{slug}"
+    dir_name = ensure_task_date_prefix(slug)
     task_dir = tasks_dir / dir_name
     task_json_path = task_dir / FILE_TASK_JSON
 

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

@@ -25,6 +25,10 @@ Plan -> Implement -> Check -> Finish
 No active task for this session. For read-only Q&A, answer directly. For implementation, refactor, behavior change, or multi-step work, create or start a task first, then continue through Plan -> Implement -> Check -> Finish.
 [/workflow-state:no_task]
 
+[workflow-state:delegated_subtask]
+The current prompt looks like a bounded delegated subtask. Follow the delegated prompt first. Do not run start/resume, create or activate a task, or switch into main-session coordination unless the delegated prompt explicitly asks for that. Keep project rules visible as constraints, not as the task.
+[/workflow-state:delegated_subtask]
+
 [workflow-state:planning]
 The active task is in planning. Finish prd.md, curate implement.jsonl and check.jsonl with spec/research files, then run task start before dispatching cowork-implement.
 [/workflow-state:planning]
@@ -123,6 +127,7 @@ Generic worker boundary:
 - Formal execution uses `cowork-research`, `cowork-implement`, or `cowork-check`.
 - Generic `worker` dispatch is best-effort only.
 - If a generic worker does not ACK after one retry, close it and do not execute the task.
+- For advisory/default subagents without a hard envelope, the first sentence must explicitly say this is a bounded delegated task, not a main-session start request. This is a natural-language first-screen boundary, not a new runtime state machine.
 
 ## 3.2 parallel sessions
 

package/template/AGENTS.md

@@ -15,6 +15,7 @@
 ## 0. 委托任务优先
 
 如果当前 prompt 是 subagent/worker/命令执行等有边界的委托任务，先执行委托 prompt；不要把 AGENTS.md、环境说明或 bootstrap 文本当成任务。除非委托 prompt 明确要求，否则不要运行 start/resume，不要再派发 agent。
+没有硬标记时，仍要先判断实际任务消息：若同时具备具体任务、边界约束（如不要编辑/不要运行/不要派发）和输出要求，按委托任务处理。特别是出现 `任务：` / `约束：` / `输出：` 这类结构时，直接执行该委托，不要把它误判为项目规范或环境上下文。项目规范仍然可见，但只是执行约束，不是当前任务本身。
 
 ## 1. 编码前先思考