cowork-flow 0.0.17 → 0.0.18

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.18",
   "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

@@ -19,6 +19,18 @@ Classify the current prompt as one of:
 
 Classify the actual task message, not injected project rules, `AGENTS.md`, or environment text.
 
+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. Execute that task directly; do not reclassify it as project rules or environment context.
+
+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:
 
 ```text
@@ -34,6 +46,7 @@ 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 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
 

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.18

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

@@ -45,6 +45,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 +87,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. 编码前先思考