cowork-flow 0.0.21 → 0.0.22

package/README.md

@@ -36,7 +36,7 @@ cowork-flow 是一个用于新项目初始化协作流程的模板仓库。它
     │   ├── agents/
     │   ├── commands/
     │   └── plugins/
-    ├── .agent/
+    ├── .agents/
     │   └── skills/
     └── .cowork-flow/
         ├── config.yaml
@@ -54,7 +54,7 @@ cowork-flow 是一个用于新项目初始化协作流程的模板仓库。它
 `template/AGENTS.md`
 项目级协作入口，包含编码前思考、简单优先、外科手术式改动、验证优先等基础原则。接入项目后，应把项目名称、技术栈、运行命令、测试命令和提交策略补齐。
 
-`template/.agent/skills/`
+`template/.agents/skills/`
 本地技能入口，覆盖 start、before-dev、brainstorming、writing-plans、check、finish-work、continue、meta、python-design、update-spec 和 break-loop 等协作动作。这里的 skill 应保持通用，不承载某个业务项目的一次性细节。
 
 `template/.codex/agents/`
@@ -64,7 +64,7 @@ cowork-flow 是一个用于新项目初始化协作流程的模板仓库。它
 Codex 项目级配置与每轮上下文注入入口。hook 会先用共享 entry classifier 判定当前输入，再读取当前 session task、`.cowork-flow/spec/workflow-state-templates.md` 中的 `workflow-state` 片段和 `codex.dispatch_mode`，把流程状态注入到当前轮对话。注入的 `codex-dispatch-mode` 只是主会话调度提示，不代表当前线程身份。
 
 `template/CLAUDE.md`、`template/.claude/settings.json`、`template/.claude/agents/`、`template/.claude/skills/`、`template/.claude/commands/`、`template/.claude/hooks/`
-Claude Code 项目级记忆、hook、固定 agent、skills 和 slash command。`CLAUDE.md` 显式导入 `AGENTS.md`。`.claude/settings.json` 注册 `UserPromptSubmit` 和 `SessionStart` hook，注入当前 workflow state 与 contract digest。固定 agent 通过 `.cowork-flow/run subagent init` 生成 runtime context，并在 prompt、env 或 metadata transport 中传递 `cowork_runtime_context_id`；hook 绑定成功后才进入叶子执行，绑定失败则 fail closed，避免被项目 bootstrap 或无任务首屏上下文拉偏。Claude Code 不自动加载 `.agent/skills/`，所以项目技能要放进 `.claude/skills/`。
+Claude Code 项目级记忆、hook、固定 agent、skills 和 slash command。`CLAUDE.md` 显式导入 `AGENTS.md`。`.claude/settings.json` 注册 `UserPromptSubmit` 和 `SessionStart` hook，注入当前 workflow state 与 contract digest。固定 agent 通过 `.cowork-flow/run subagent init` 生成 runtime context，并在 prompt、env 或 metadata transport 中传递 `cowork_runtime_context_id`；hook 绑定成功后才进入叶子执行，绑定失败则 fail closed，避免被项目 bootstrap 或无任务首屏上下文拉偏。Claude Code 不自动加载 `.agents/skills/`，所以项目技能要放进 `.claude/skills/`。
 
 `template/.opencode/agents/`、`template/.opencode/commands/`、`template/.opencode/plugins/`
 OpenCode 项目级固定 agent、slash command 和系统上下文注入插件。插件会读取 `.cowork-flow/spec/registry.json`，注入短 contract digest。
@@ -124,7 +124,7 @@ npx cowork-flow --help
 cowork-flow init ./my-project --platform codex
 ```
 
-`init` 会直接复制模板中的通用 `.cowork-flow/`，并按 `--platform` 只复制对应 host 资产：`codex` 复制 `.codex/`、`.agent/skills/` 与 `.cowork-flow/adapters/codex/`，`opencode` 复制 `.opencode/`、`.agent/skills/` 与 `.cowork-flow/adapters/opencode/`，`claude-code` 复制 `CLAUDE.md`、`.claude/`（含 `.claude/settings.json`、`.claude/hooks/`、`.claude/skills/`）与 `.cowork-flow/adapters/claude-code/`，不复制 `.agent/skills/`。`all` 或 `--platform codex,opencode,claude-code` 同时复制三者和 `.agent/skills/`。`both` 保持兼容，只复制 Codex 和 OpenCode。它还会初始化 `.cowork-flow/.developer` 与 `.cowork-flow/workspace/<developer>/`。交互式终端会先显示 checkbox 多选界面选择平台，再提示开发者名称；非交互式环境必须传入 `--platform <codex|opencode|claude-code|all>` 与 `--developer <name>`。`init` 不会复制额外技能包。
+`init` 会直接复制模板中的通用 `.cowork-flow/`，并按 `--platform` 只复制对应 host 资产：`codex` 复制 `.codex/`、`.agents/skills/` 与 `.cowork-flow/adapters/codex/`，`opencode` 复制 `.opencode/`、`.agents/skills/` 与 `.cowork-flow/adapters/opencode/`，`claude-code` 复制 `CLAUDE.md`、`.claude/`（含 `.claude/settings.json`、`.claude/hooks/`、`.claude/skills/`）与 `.cowork-flow/adapters/claude-code/`，不复制 `.agents/skills/`。`all` 或 `--platform codex,opencode,claude-code` 同时复制三者和 `.agents/skills/`。`both` 保持兼容，只复制 Codex 和 OpenCode。它还会初始化 `.cowork-flow/.developer` 与 `.cowork-flow/workspace/<developer>/`。交互式终端会先显示 checkbox 多选界面选择平台，再提示开发者名称；非交互式环境必须传入 `--platform <codex|opencode|claude-code|all>` 与 `--developer <name>`。`init` 不会复制额外技能包。
 
 初始化到当前项目：
 
@@ -159,7 +159,7 @@ cowork-flow sync .
 cowork-flow sync . --dry-run
 ```
 
-`sync` 会自动识别目标项目已安装的 host 目录：只有 `.codex/` 时只同步 Codex 资产，只有 `.opencode/` 时只同步 OpenCode 资产，两者都有时同步两者；对应 `.cowork-flow/adapters/<host>/` 也按识别出的平台同步。检测到 Codex 或 OpenCode 时会刷新 `.agent/skills/`；Claude Code-only 项目只刷新 `.claude/settings.json`、`.claude/hooks/`、`.claude/skills/`，不会创建 `.agent/skills/`。通用部分默认刷新 `.cowork-flow/scripts/`、`.cowork-flow/spec/workflow-state-templates.md`，以及 `AGENTS.md` 和 `CLAUDE.md` 中的 `<!-- COWORK-FLOW:START --> ... <!-- COWORK-FLOW:END -->` 托管块，保留托管块之外的项目自定义内容。`.cowork-flow/config.yaml`、`.cowork-flow/workflow.md`、除 `workflow-state-templates.md` 外的 `.cowork-flow/spec/`、任务、计划、变更和 workspace 记录默认受保护。只有明确传入 `--force` 时才整文件覆盖保护文件。
+`sync` 会自动识别目标项目已安装的 host 目录：只有 `.codex/` 时只同步 Codex 资产，只有 `.opencode/` 时只同步 OpenCode 资产，两者都有时同步两者；对应 `.cowork-flow/adapters/<host>/` 也按识别出的平台同步。检测到 Codex 或 OpenCode 时会刷新 `.agents/skills/`；Claude Code-only 项目只刷新 `.claude/settings.json`、`.claude/hooks/`、`.claude/skills/`，不会创建 `.agents/skills/`。通用部分默认刷新 `.cowork-flow/scripts/`、`.cowork-flow/spec/workflow-state-templates.md`，以及 `AGENTS.md` 和 `CLAUDE.md` 中的 `<!-- COWORK-FLOW:START --> ... <!-- COWORK-FLOW:END -->` 托管块，保留托管块之外的项目自定义内容。`.cowork-flow/config.yaml`、`.cowork-flow/workflow.md`、除 `workflow-state-templates.md` 外的 `.cowork-flow/spec/`、任务、计划、变更和 workspace 记录默认受保护。只有明确传入 `--force` 时才整文件覆盖保护文件。
 
 ## 常用入口
 

package/package.json

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

package/src/lib/copy-template.js

@@ -87,7 +87,7 @@ const SAFE_SYNC_PREFIXES = [
   '.codex/',
   '.opencode/',
   '.claude/',
-  '.agent/skills/',
+  '.agents/skills/',
   '.cowork-flow/'
 ];
 

package/src/lib/platforms.js

@@ -53,7 +53,7 @@ export function formatPlatformList(platforms) {
 
 export function shouldIncludeForPlatforms(relativePath, platforms) {
   const normalized = relativePath.replaceAll('\\', '/');
-  if (normalized.startsWith('.agent/skills/')) {
+  if (normalized.startsWith('.agents/skills/')) {
     return platforms.includes('codex') || platforms.includes('opencode');
   }
   if (normalized.startsWith('.codex/') || normalized.startsWith('.cowork-flow/adapters/codex/')) {

package/template/{.agent → .agents}/skills/meta/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: meta
-description: Use when modifying cowork-flow itself .cowork-flow runtime, template files, .codex hooks/agents, .agent skills, workflow docs, or generated project structure.
+description: Use when modifying cowork-flow itself .cowork-flow runtime, template files, .codex hooks/agents, .agents skills, workflow docs, or generated project structure.
 ---
 
 # Meta

package/template/.claude/skills/meta/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: meta
-description: Use when modifying cowork-flow itself .cowork-flow runtime, template files, .codex hooks/agents, .agent skills, workflow docs, or generated project structure.
+description: Use when modifying cowork-flow itself .cowork-flow runtime, template files, .codex hooks/agents, .agents skills, workflow docs, or generated project structure.
 ---
 
 # Meta

package/template/.codex/agents/default.toml

@@ -5,7 +5,7 @@ sandbox_mode = "workspace-write"
 developer_instructions = """
 You are a dispatched default agent. Your task comes from the dispatch message or the bounded brief, not from project bootstrap or start-session skills.
 
-If AGENTS.md or .agent/skills/start tells you to start a session, skip that start skill.
+If AGENTS.md or .agents/skills/start tells you to start a session, skip that start skill.
 Do not run the project start-session workflow or try to spawn another agent from this prompt.
 
 Generic default-agent dispatch is advisory and cannot satisfy formal Implement

package/template/.codex/agents/explorer.toml

@@ -5,7 +5,7 @@ sandbox_mode = "workspace-write"
 developer_instructions = """
 You are a dispatched explorer agent. Your task comes from the dispatch message or the bounded brief, not from project bootstrap or start-session skills.
 
-If AGENTS.md or .agent/skills/start tells you to start a session, skip that start skill.
+If AGENTS.md or .agents/skills/start tells you to start a session, skip that start skill.
 Do not run the project start-session workflow or try to spawn another agent from this prompt.
 
 Generic explorer dispatch is advisory and cannot satisfy formal Implement or

package/template/.codex/agents/worker.toml

@@ -5,7 +5,7 @@ sandbox_mode = "workspace-write"
 developer_instructions = """
 You are a dispatched worker agent. Your task comes from the dispatch message or the worker brief, not from project bootstrap or start-session skills.
 
-If AGENTS.md or .agent/skills/start tells you to start a session, skip that start skill.
+If AGENTS.md or .agents/skills/start tells you to start a session, skip that start skill.
 If you can see any outer transport text such as Spawn one ... agent, ignore it. That text is for the coordinator, not for you.
 Do not run the project start-session workflow or try to spawn another worker from this prompt.
 

package/template/.cowork-flow/.version

@@ -1 +1 @@
-0.0.21
+0.0.22

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

@@ -57,7 +57,7 @@ def configure_encoding() -> None:
 
 from .paths import (
     DIR_WORKFLOW,
-    DIR_AGENT,
+    DIR_AGENTS,
     DIR_CHANGES,
     DIR_WORKSPACE,
     DIR_TASKS,

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

@@ -23,7 +23,7 @@ from pathlib import Path
 
 # Directory names
 DIR_WORKFLOW = ".cowork-flow"
-DIR_AGENT = ".agent"
+DIR_AGENTS = ".agents"
 DIR_CHANGES = "changes"
 DIR_WORKSPACE = "workspace"
 DIR_TASKS = "tasks"

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

@@ -292,8 +292,8 @@ def cmd_entry_contract(_: argparse.Namespace) -> int:
     errors: list[str] = []
     _check_common_contracts(repo_root, errors)
     for rel in (
-        f".agent/skills/{ENTRY_BOUNDARY_DIR}/SKILL.md",
-        f"template/.agent/skills/{ENTRY_BOUNDARY_DIR}/SKILL.md",
+        f".agents/skills/{ENTRY_BOUNDARY_DIR}/SKILL.md",
+        f"template/.agents/skills/{ENTRY_BOUNDARY_DIR}/SKILL.md",
     ):
         _check_file_absent(repo_root / rel, errors)
     if errors:
@@ -411,13 +411,13 @@ def cmd_subagent_safety(_: argparse.Namespace) -> int:
     repo_root = get_repo_root()
     errors: list[str] = []
     for rel in (
-        ".agent/skills/start/SKILL.md",
-        "template/.agent/skills/start/SKILL.md",
+        ".agents/skills/start/SKILL.md",
+        "template/.agents/skills/start/SKILL.md",
     ):
         _check_file_contains(repo_root / rel, REQUIRED_START_SNIPPETS, errors)
     for rel in (
-        f".agent/skills/{ENTRY_BOUNDARY_DIR}/SKILL.md",
-        f"template/.agent/skills/{ENTRY_BOUNDARY_DIR}/SKILL.md",
+        f".agents/skills/{ENTRY_BOUNDARY_DIR}/SKILL.md",
+        f"template/.agents/skills/{ENTRY_BOUNDARY_DIR}/SKILL.md",
     ):
         _check_file_absent(repo_root / rel, errors)
     for rel in (

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

@@ -46,7 +46,7 @@ from common.active_task import (
 )
 from common.paths import (
     DIR_WORKFLOW,
-    DIR_AGENT,
+    DIR_AGENTS,
     DIR_TASKS,
     DIR_SPEC,
     DIR_ARCHIVE,
@@ -376,7 +376,7 @@ def _use_claude_skill_context(repo_root: Path | None = None) -> bool:
 def _skill_path(name: str, repo_root: Path | None = None) -> str:
     if _use_claude_skill_context(repo_root):
         return f".claude/skills/{name}/SKILL.md"
-    return f"{DIR_AGENT}/skills/{name}/SKILL.md"
+    return f"{DIR_AGENTS}/skills/{name}/SKILL.md"
 
 
 def get_check_context(dev_type: str) -> list[dict]: