From c3fd09a22aed33143b1cbe76437cfa69ba1e5bc1 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 23 May 2026 13:04:10 +0000 Subject: [PATCH] =?UTF-8?q?README:=20=E4=BF=AE=E6=AD=A3=20spec-writer=20?= =?UTF-8?q?=E5=B7=B2=E5=88=A0=E9=99=A4=E7=9A=84=E8=BF=87=E6=97=B6=E6=8F=8F?= =?UTF-8?q?=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit spec-writer subagent 在 0.10.11 已删除（subagent 拿不到主代理 SKILL 上下文 / 用户原始需求 / 流程状态，容易 hallucinate 通用模板内容）； README 重写时把这条过时 highlight 从旧版照搬了。 - highlights 改为「主代理直接写 spec 文档」，括号里说明 spec-writer 历史与移除理由 - 项目结构里 agents/ 行去掉 spec-writer - 中英两份保持镜像 https://claude.ai/code/session_01DBzK7KGfF9toaBnZH77j3t --- README.md | 11 ++++++++--- README.zh-CN.md | 8 +++++--- 2 files changed, 13 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 0981670..a683301 100644 --- a/README.md +++ b/README.md @@ -60,8 +60,13 @@ windows, or merge unreviewed code, specode is the rails. - **Per-session JSONL logs** for "why did the agent go off-script" forensics, with automatic secret redaction and 500-char string truncation. -- **Isolated `spec-writer` agent** for document authoring - (Read / Write / Edit / Grep / Glob — deliberately no Bash). +- **Main agent writes spec docs directly.** No subagent fork — the + main agent reads template skeletons from `assets/templates/.md` + and fills them against your original requirement text, keeping + context and conversational state intact (a previous `spec-writer` + subagent was removed in 0.10.11 precisely because it couldn't + see the main agent's context and tended to hallucinate generic + template content). ## Installation @@ -224,7 +229,7 @@ plugins/specode/ commands/ /specode:spec, :continue, :end, :status, :task-swarm agents/ task-swarm-{planner,coder, - reviewer,validator}, spec-writer + reviewer,validator} scripts/ spec_vault / spec_init / spec_session / spec_lint / spec_status / task_swarm* diff --git a/README.zh-CN.md b/README.zh-CN.md index efd90aa..3815192 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -45,8 +45,10 @@ specode 就是给它套的轨道。 ``` - **每个 session 的 JSONL 日志**：用来排查「代理为什么走偏」，默认 屏蔽敏感字段、字符串自动截断到 500 字符。 -- **物理隔离的 `spec-writer` agent**：只给 Read / Write / Edit / Grep - / Glob，**故意不给 Bash**，专心写文档。 +- **主代理直接写 spec 文档**：不 fork subagent —— 主代理读 + `assets/templates/.md` 模板骨架、按用户原始需求填空，全程 + 保留上下文与对话状态（0.10.11 之前用过 `spec-writer` subagent， + 因为拿不到主代理上下文容易 hallucinate 通用模板内容，故移除）。 ## 安装 @@ -200,7 +202,7 @@ plugins/specode/ commands/ /specode:spec, :continue, :end, :status, :task-swarm agents/ task-swarm-{planner,coder, - reviewer,validator}, spec-writer + reviewer,validator} scripts/ spec_vault / spec_init / spec_session / spec_lint / spec_status / task_swarm*