@wnlen/agent-execution-template 0.8.22 → 0.8.23

package/bin/agent-execution-template.js

@@ -73,24 +73,31 @@ const TEXT = {
 `,
     unknown: "未知",
     sourceMissing: "找不到模板来源",
-    ready: "Agent Execution Template 协议已安装。项目上下文尚未初始化。",
-    initGuide: `下一步，把这句话发给你的 AI coding 工具:
+    ready: "Agent Execution Template 已安装。",
+    initGuide: `你现在可以这样用:
 
-  开始初始化这个项目
+1. 第一次整理项目上下文
+   【发给 AI】
 
-如果你已经有确定资料:
-  1. 放到 ai/project/inbox/
-  2. 对 AI 说: 开始初始化这个项目，并吸收 ai/project/inbox/ 里的资料
+     开始初始化这个项目
 
-资料路径:
-  - 已确定资料: ai/project/inbox/
-  - 未决定的新想法: ai/project/inbox/ideas/
+2. 已有 README、PRD、架构文档或业务规则
+   先放到 ai/project/inbox/
+   【发给 AI】
 
-忘了下一步时运行:
-  npx -y @wnlen/agent-execution-template next
+     开始初始化这个项目，并吸收 ai/project/inbox/ 里的资料
 
-已完成:
-  - 根目录 AI 入口: AGENTS.md / CLAUDE.md`,
+3. 后续有新资料要合并
+   放到 ai/project/inbox/
+   【发给 AI】
+
+     整合 ai/project/inbox/ 里的新资料
+
+4. 有还没确定的新想法、产品方向或架构调整
+   放到 ai/project/inbox/ideas/
+   【发给 AI】
+
+     把 ai/project/inbox/ideas/ 里的新灵感生成方向修订提案`,
     start: "开始:",
     startPrompt: "开始初始化这个项目",
     then: "然后:",
@@ -178,24 +185,31 @@ Usage:
 `,
     unknown: "unknown",
     sourceMissing: "Template source not found",
-    ready: "Agent Execution Template protocol installed. Project context is not initialized yet.",
-    initGuide: `Next, send this to your AI coding tool:
+    ready: "Agent Execution Template installed.",
+    initGuide: `You can use it like this:
+
+1. Set up project context for the first time
+   [Send to AI]
+
+     Start initializing this project
+
+2. You already have a README, PRD, architecture doc, or business rules
+   Put them in ai/project/inbox/
+   [Send to AI]
 
-  Start initializing this project
+     Start initializing this project and absorb the material in ai/project/inbox/
 
-If you already have confirmed material:
-  1. Put it in ai/project/inbox/
-  2. Tell the AI: Start initializing this project and absorb the material in ai/project/inbox/
+3. Later, you have new material to merge
+   Put it in ai/project/inbox/
+   [Send to AI]
 
-Material paths:
-  - Confirmed material: ai/project/inbox/
-  - Undecided ideas: ai/project/inbox/ideas/
+     Reconcile the new material in ai/project/inbox/
 
-If you forget the next step, run:
-  npx -y @wnlen/agent-execution-template next
+4. You have an undecided idea, product direction, or architecture change
+   Put it in ai/project/inbox/ideas/
+   [Send to AI]
 
-Completed:
-  - Root AI entrypoints: AGENTS.md / CLAUDE.md`,
+     Generate a direction amendment proposal from ai/project/inbox/ideas/`,
     start: "Start:",
     startPrompt: "Start initializing this project",
     then: "Then:",
@@ -587,11 +601,11 @@ function init({ lang = DEFAULT_LANG, verbose = false, quiet = false, manageEntry
 
 ${text.initGuide}${sourceNotice}
 
-${text.files}: ${summarizeChanges(changes, lang)}
 ${text.check}: ${commandHint("doctor")}
 `);
 
     if (verbose) {
+      console.log(`${text.files}: ${summarizeChanges(changes, lang)}`);
       printChanges(text.details, changes, lang);
     }
   }

package/docs/SPEC.md

@@ -24,7 +24,7 @@ npx 安装协议 -> AI 整理项目上下文 -> 人类确认 -> AI 生成任务
 
 ```text
 Protocol: v0.8
-Package: @wnlen/agent-execution-template@0.8.22
+Package: @wnlen/agent-execution-template@0.8.23
 中文安装: npx -y @wnlen/agent-execution-template init
 英文安装: npx -y @wnlen/agent-execution-template init --lang en
 ```
@@ -420,7 +420,7 @@ npx -y @wnlen/agent-execution-template doctor
 ```text
 Agent Execution Template 检查
 
-模板版本: 0.8.22
+模板版本: 0.8.23
 模板语言: zh
 
 [通过] ai/template/LANG

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wnlen/agent-execution-template",
-  "version": "0.8.22",
+  "version": "0.8.23",
   "description": "Low-friction AI execution protocol template for coding agents.",
   "bin": {
     "agent-execution-template": "bin/agent-execution-template.js"

package/template/en/ai/template/VERSION

@@ -1 +1 @@
-0.8.22
+0.8.23

package/template/zh/ai/template/VERSION

@@ -1 +1 @@
-0.8.22
+0.8.23

package/test/selftest.js

@@ -154,22 +154,33 @@ function testInitUpdateDoctor() {
   assert(read(cwd, "ai/template/rules/core.md").includes("ai/project/refs/final-shape.md"), "core rules should route direction refs");
   assert(read(cwd, "ai/project/proposals/final-shape-updates/_template.md").includes("`accepted`"), "proposal template should describe accepted status");
   const initOutput = run(["init"], cwd);
-  assert(initOutput.includes("开始初始化这个项目"), "init output should provide compact natural bootstrap prompt");
-  assert(initOutput.includes("根目录 AI 入口: AGENTS.md / CLAUDE.md"), "init output should mention root AI compatibility entrypoints");
-  assert(initOutput.includes("协议已安装。项目上下文尚未初始化"), "init output should distinguish protocol install from project context bootstrap");
-  assert(initOutput.includes("下一步，把这句话发给你的 AI coding 工具"), "init output should guide the AI bootstrap as the next step");
+  assert(initOutput.includes("Agent Execution Template 已安装。"), "init output should confirm installation");
+  assert(initOutput.includes("你现在可以这样用:"), "init output should introduce scenario-based usage");
+  assert(initOutput.includes("1. 第一次整理项目上下文"), "init output should cover first-time project context setup");
+  assert(initOutput.includes("【发给 AI】\n\n     开始初始化这个项目"), "init output should make the bootstrap prompt visually prominent");
+  assert(initOutput.includes("2. 已有 README、PRD、架构文档或业务规则"), "init output should cover initialization with existing material");
   assert(initOutput.includes("开始初始化这个项目，并吸收 ai/project/inbox/ 里的资料"), "init output should explain bootstrap with existing material");
-  assert(initOutput.includes("已确定资料: ai/project/inbox/"), "init output should explain confirmed material path");
-  assert(initOutput.includes("未决定的新想法: ai/project/inbox/ideas/"), "init output should explain idea inbox path");
-  assert(initOutput.includes("agent-execution-template next"), "init output should tell users how to recover the next step");
-  assert(initOutput.includes("文件已就绪:"), "init output should summarize file changes");
+  assert(initOutput.includes("3. 后续有新资料要合并"), "init output should cover later material reconciliation");
+  assert(initOutput.includes("整合 ai/project/inbox/ 里的新资料"), "init output should show the reconcile prompt");
+  assert(initOutput.includes("4. 有还没确定的新想法、产品方向或架构调整"), "init output should cover undecided ideas");
+  assert(initOutput.includes("把 ai/project/inbox/ideas/ 里的新灵感生成方向修订提案"), "init output should show the strategy proposal prompt");
+  assert(!initOutput.includes("项目上下文尚未初始化"), "init output should not state the obvious uninitialized context");
+  assert(!initOutput.includes("忘了下一步时运行"), "init output should not show next as the default fallback");
+  assert(!initOutput.includes("根目录 AI 入口"), "init output should not mention root AI entrypoint implementation details");
+  assert(!initOutput.includes("资料路径:"), "init output should not show abstract material path categories");
+  assert(!initOutput.includes("已确定资料:"), "init output should not show abstract confirmed material path categories");
+  assert(!initOutput.includes("未决定的新想法:"), "init output should not show abstract idea path categories");
+  assert(!initOutput.includes("agent-execution-template next"), "init output should not tell users to remember the next command");
+  assert(!initOutput.includes("文件已就绪:"), "init output should hide file change summaries by default");
   assert(initOutput.includes("检查安装:"), "init output should show install check command");
   assert(!initOutput.includes("维护者提示"), "init output should not show source checkout guidance in user projects");
   assert(!initOutput.includes("[已更新]"), "init output should hide detailed file changes by default");
   assert(!initOutput.includes("Read ai/template/bootstrap.md"), "init output should not use weak Read bootstrap command");
   assert(countOccurrences(read(cwd, "AGENTS.md"), "agent-execution-template:start") === 1, "init should not duplicate AGENTS.md managed blocks");
   assert(countOccurrences(read(cwd, "CLAUDE.md"), "agent-execution-template:start") === 1, "init should not duplicate CLAUDE.md managed blocks");
-  assert(run(["init", "--verbose"], cwd).includes("[已更新] ai/template/VERSION"), "init --verbose should show detailed file changes");
+  const verboseInitOutput = run(["init", "--verbose"], cwd);
+  assert(verboseInitOutput.includes("文件已就绪:"), "init --verbose should summarize file changes");
+  assert(verboseInitOutput.includes("[已更新] ai/template/VERSION"), "init --verbose should show detailed file changes");
   assert(countOccurrences(read(cwd, "AGENTS.md"), "agent-execution-template:start") === 1, "re-running init should keep one AGENTS.md managed block");
   assert(countOccurrences(read(cwd, "CLAUDE.md"), "agent-execution-template:start") === 1, "re-running init should keep one CLAUDE.md managed block");
   const reconcileOutput = run(["reconcile"], cwd);
@@ -273,15 +284,24 @@ function testEnglishInitUpdateDoctor() {
   assert(read(cwd, "ai/template/reconcile.md").includes("ai/project/inbox/processed/raw/file.md"), "English reconcile prompt should archive absorbed raw inbox material");
   assert(read(cwd, "ai/template/reconcile.md").includes("Unabsorbed material"), "English reconcile handoff should audit unabsorbed material");
   assert(read(cwd, "ai/template/reconcile.md").includes("Conflict handling"), "English reconcile handoff should audit conflict handling");
-  assert(initOutput.includes("Start initializing this project"), "English init output should provide English bootstrap prompt");
-  assert(initOutput.includes("Root AI entrypoints: AGENTS.md / CLAUDE.md"), "English init output should mention root AI compatibility entrypoints");
-  assert(initOutput.includes("protocol installed. Project context is not initialized yet"), "English init output should distinguish protocol install from project context bootstrap");
-  assert(initOutput.includes("Next, send this to your AI coding tool"), "English init output should guide the AI bootstrap as the next step");
+  assert(initOutput.includes("Agent Execution Template installed."), "English init output should confirm installation");
+  assert(initOutput.includes("You can use it like this:"), "English init output should introduce scenario-based usage");
+  assert(initOutput.includes("1. Set up project context for the first time"), "English init output should cover first-time project context setup");
+  assert(initOutput.includes("[Send to AI]\n\n     Start initializing this project"), "English init output should make the bootstrap prompt visually prominent");
+  assert(initOutput.includes("2. You already have a README, PRD, architecture doc, or business rules"), "English init output should cover initialization with existing material");
   assert(initOutput.includes("Start initializing this project and absorb the material in ai/project/inbox/"), "English init output should explain bootstrap with existing material");
-  assert(initOutput.includes("Confirmed material: ai/project/inbox/"), "English init output should explain confirmed material path");
-  assert(initOutput.includes("Undecided ideas: ai/project/inbox/ideas/"), "English init output should explain idea inbox path");
-  assert(initOutput.includes("agent-execution-template next"), "English init output should tell users how to recover the next step");
-  assert(initOutput.includes("Files ready:"), "English init output should summarize file changes");
+  assert(initOutput.includes("3. Later, you have new material to merge"), "English init output should cover later material reconciliation");
+  assert(initOutput.includes("Reconcile the new material in ai/project/inbox/"), "English init output should show the reconcile prompt");
+  assert(initOutput.includes("4. You have an undecided idea, product direction, or architecture change"), "English init output should cover undecided ideas");
+  assert(initOutput.includes("Generate a direction amendment proposal from ai/project/inbox/ideas/"), "English init output should show the strategy proposal prompt");
+  assert(!initOutput.includes("Project context is not initialized yet"), "English init output should not state the obvious uninitialized context");
+  assert(!initOutput.includes("If you forget the next step"), "English init output should not show next as the default fallback");
+  assert(!initOutput.includes("Root AI entrypoints"), "English init output should not mention root AI entrypoint implementation details");
+  assert(!initOutput.includes("Material paths:"), "English init output should not show abstract material path categories");
+  assert(!initOutput.includes("Confirmed material:"), "English init output should not show abstract confirmed material path categories");
+  assert(!initOutput.includes("Undecided ideas:"), "English init output should not show abstract idea path categories");
+  assert(!initOutput.includes("agent-execution-template next"), "English init output should not tell users to remember the next command");
+  assert(!initOutput.includes("Files ready:"), "English init output should hide file change summaries by default");
   assert(initOutput.includes("Check install:"), "English init output should show install check command");
   assert(!initOutput.includes("Maintainer note"), "English init output should not show source checkout guidance in user projects");
   assert(!initOutput.includes("[UPDATED]"), "English init output should hide detailed file changes by default");