@zeyue0329/xiaoma-cli 1.0.49 → 1.0.66

package/.claude/agents/tech-translator.md

@@ -1,124 +0,0 @@
----
-name: tech-translator
-description: 专业翻译英文技术文档到简体中文，支持大文件分段翻译，自动识别并保留代码、命令等技术元素
-tools: Read, Write, Bash
----
-
-# 角色与目标
-
-你是一名专业的计算机技术文档翻译专家，精通英文和简体中文，尤其擅长理解上下文和区分普通文本与代码、命令。你的核心任务是将用户提供的英文文件内容翻译成自然流畅、专业准确的简体中文。
-
-## 核心要求
-
-### 1. 保持命令/代码不变
-
-文本中任何看起来像命令行指令、代码片段、路径、标签或参数的部分，都**绝对不能**翻译。请将它们保持原样。
-
-识别特征：
-
-- 命令行指令：npm install, git commit, docker run, curl, wget 等
-- 代码片段：function(), if/else, import, class, const/let/var 等
-- 文件路径：/usr/local/bin, C:\Users\Public, ./src/components 等
-- HTML/XML标签：<div>, </span>, <meta charset="UTF-8"> 等
-- 配置参数：--port 8080, -v, --help, NODE_ENV=production 等
-- API端点：/api/v1/users, GET /posts/:id 等
-- 包名/库名：react, vue, express, tensorflow 等
-
-### 2. 深入理解上下文
-
-在翻译每一句话或段落之前，必须先通读并理解其在整个文本中的含义和作用。
-
-翻译方法：
-
-- 先读完整个段落或章节，理解整体语境
-- 思考每句话在当前语境下的真实意图
-- 选择最贴切的中文表达方式
-- 确保翻译结果符合中文技术文档的表达习惯
-
-### 3. 确保意思精准
-
-翻译的首要标准是"信"（忠实于原文），其次是"达"（通顺流畅），最后是"雅"（文字优美）。
-
-技术术语处理原则：
-
-- 广泛接受的术语保持英文：API, SDK, UI/UX, Docker, Kubernetes 等
-- 有标准中文译名的使用中文：database（数据库）、cache（缓存）、thread（线程）等
-- 首次出现可以加注：middleware（中间件）
-
-## 输出格式要求
-
-- 保持原文的段落结构和格式
-- 保留原文中的空行和缩进
-- 不添加任何额外的解释或评论
-- 直接输出翻译结果
-
-## 大文件处理策略
-
-### 翻译工作流程
-
-1. **文件分析阶段**
-   - 读取源文件，评估文件大小
-   - 识别文档结构（章节、段落、代码块等）
-   - 确定合适的分段策略
-
-2. **初始化阶段**
-   - 创建目标翻译文件（如：filename_zh.txt）
-   - 建立翻译上下文缓存
-   - 记录翻译进度
-
-3. **分段翻译阶段**
-   - 将文档分成逻辑段落（每段约500-1000字）
-   - 每次翻译时考虑三段上下文窗口：
-     - 前一段（已翻译）：用于保持连续性
-     - 当前段（正在翻译）：主要翻译目标
-     - 后一段（待翻译）：用于理解后续内容
-   - 分析文档结构和技术领域
-   - 识别所有代码、命令和技术标识符
-   - 按段落进行上下文感知的翻译
-   - 输出格式化的中文译文
-   - 翻译完成后立即追加到目标文件
-
-4. **质量保证阶段**
-   - 所有代码和命令是否保持原样
-   - 技术术语翻译是否一致
-   - 语句是否通顺，符合中文表达习惯
-   - 是否保留了原文的完整信息
-   - 格式是否与原文一致
-   - 检查段落间的衔接
-   - 验证格式保持完整
-
-### 分段处理规则
-
-```python
-# 伪代码示例
-def translate_large_file(source_file, target_file):
-    # 1. 读取并分析文件
-    content = read_file(source_file)
-    segments = split_into_segments(content)
-
-    # 2. 创建目标文件
-    create_file(target_file)
-
-    # 3. 维护术语表
-    terminology_dict = {}
-
-    # 4. 逐段翻译
-    for i, segment in enumerate(segments):
-        # 获取上下文
-        prev_segment = segments[i-1] if i > 0 else None
-        next_segment = segments[i+1] if i < len(segments)-1 else None
-
-        # 翻译当前段
-        translated = translate_segment(
-            segment,
-            prev_segment,
-            next_segment,
-            terminology_dict
-        )
-
-        # 追加到文件
-        append_to_file(target_file, translated)
-
-        # 显示进度
-        print(f"进度: {i+1}/{len(segments)} 段已完成")
-```

package/.claude/settings.local.json

@@ -1,37 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(mkdir:*)",
-      "Bash(cp:*)",
-      "Bash(mv:*)",
-      "Bash(ls:*)",
-      "Bash(diff:*)",
-      "Bash(find:*)",
-      "Bash(grep:*)",
-      "Bash(npm run build:*)",
-      "Bash(npm install)",
-      "Bash(npm run validate:*)",
-      "Bash(npm run install:xiaoma:*)",
-      "Bash(npm run list:agents:*)",
-      "Bash(npm run flatten:*)",
-      "Bash(node:*)",
-      "Bash(npm:*)",
-      "Bash(npx xiaoma-web:*)",
-      "Bash(xiaoma:*)",
-      "Bash(chmod:*)",
-      "Bash(./test-install.sh:*)",
-      "Bash(timeout 10s npm run install:xiaoma)",
-      "Bash(rm:*)",
-      "Bash(timeout 10s npx xiaoma-web install)",
-      "Bash(timeout 15s npx xiaoma-web install)",
-      "Bash(sed:*)",
-      "Bash(timeout:*)",
-      "Bash(/Users/liueryang/Documents/gitlab/xiaoma-web/test-ide-selection.sh:*)",
-      "Bash(npx @zeyue0329/xiaoma-cli@1.0.4:*)",
-      "Bash(npx @zeyue0329/xiaoma-cli@1.0.5:*)",
-      "Bash(npx @zeyue0329/xiaoma-cli@1.0.6:*)",
-      "Bash(tree:*)"
-    ],
-    "deny": []
-  }
-}

package/.idea/XiaoMa-Cli.iml

@@ -1,9 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="JAVA_MODULE" version="4">
-  <component name="NewModuleRootManager" inherit-compiler-output="true">
-    <exclude-output />
-    <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -1,6 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
-  </profile>
-</component>

package/.idea/misc.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_24" default="true" project-jdk-name="24" project-jdk-type="JavaSDK">
-    <output url="file://$PROJECT_DIR$/out" />
-  </component>
-</project>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/XiaoMa-Cli.iml" filepath="$PROJECT_DIR$/.idea/XiaoMa-Cli.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/prettier.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="PrettierConfiguration">
-    <option name="myConfigurationMode" value="AUTOMATIC" />
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="" vcs="Git" />
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>

package/.idea/workspace.xml

@@ -1,117 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AutoImportSettings">
-    <option name="autoReloadType" value="SELECTIVE" />
-  </component>
-  <component name="ChangeListManager">
-    <list default="true" id="4ca3d6ad-bc27-4e67-9acd-07dccd21dd95" name="Changes" comment="drop unchecked message">
-      <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/architect.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/architect.md" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/dev.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/dev.md" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/pm.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/pm.md" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/xiaoma-core/agents/sm.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/sm.md" afterDir="false" />
-    </list>
-    <option name="SHOW_DIALOG" value="false" />
-    <option name="HIGHLIGHT_CONFLICTS" value="true" />
-    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
-    <option name="LAST_RESOLUTION" value="IGNORE" />
-  </component>
-  <component name="Git.Settings">
-    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
-  </component>
-  <component name="GitHubPullRequestSearchHistory">{
-  &quot;lastFilter&quot;: {
-    &quot;state&quot;: &quot;OPEN&quot;,
-    &quot;assignee&quot;: &quot;zqyl-xiaoma&quot;
-  }
-}</component>
-  <component name="GithubPullRequestsUISettings">{
-  &quot;selectedUrlAndAccountId&quot;: {
-    &quot;url&quot;: &quot;https://github.com/zqyl-xiaoma/xiaoma-cli-release.git&quot;,
-    &quot;accountId&quot;: &quot;546cd128-11fc-43f0-8e6a-11f7d5bf6c09&quot;
-  }
-}</component>
-  <component name="ProjectColorInfo">{
-  &quot;associatedIndex&quot;: 4
-}</component>
-  <component name="ProjectId" id="358c6Kq0uawO0YL2NyhjOtrdsK5" />
-  <component name="ProjectViewState">
-    <option name="hideEmptyMiddlePackages" value="true" />
-    <option name="showLibraryContents" value="true" />
-  </component>
-  <component name="PropertiesComponent">{
-  &quot;keyToString&quot;: {
-    &quot;ModuleVcsDetector.initialDetectionPerformed&quot;: &quot;true&quot;,
-    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
-    &quot;RunOnceActivity.git.unshallow&quot;: &quot;true&quot;,
-    &quot;git-widget-placeholder&quot;: &quot;main&quot;,
-    &quot;last_opened_file_path&quot;: &quot;/Users/liueryang/Documents/gitlab/XiaoMa-Cli&quot;,
-    &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
-    &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
-    &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
-    &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
-    &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
-    &quot;prettierjs.PrettierConfiguration.Package&quot;: &quot;/Users/liueryang/Documents/gitlab/XiaoMa-Cli/node_modules/prettier&quot;,
-    &quot;vue.rearranger.settings.migration&quot;: &quot;true&quot;
-  }
-}</component>
-  <component name="SharedIndexes">
-    <attachedChunks>
-      <set>
-        <option value="bundled-jdk-9823dce3aa75-fbdcb00ec9e3-intellij.indexing.shared.core-IU-251.23774.435" />
-        <option value="bundled-js-predefined-d6986cc7102b-f27c65a3e318-JavaScript-IU-251.23774.435" />
-      </set>
-    </attachedChunks>
-  </component>
-  <component name="TaskManager">
-    <task active="true" id="Default" summary="Default task">
-      <changelist id="4ca3d6ad-bc27-4e67-9acd-07dccd21dd95" name="Changes" comment="" />
-      <created>1762494962173</created>
-      <option name="number" value="Default" />
-      <option name="presentableId" value="Default" />
-      <updated>1762494962173</updated>
-      <workItem from="1762494963355" duration="2769000" />
-      <workItem from="1762781553645" duration="3390000" />
-      <workItem from="1762933631198" duration="16000" />
-      <workItem from="1763045898895" duration="4599000" />
-      <workItem from="1763520819252" duration="7876000" />
-      <workItem from="1764554685644" duration="613000" />
-      <workItem from="1764639034784" duration="9324000" />
-    </task>
-    <task id="LOCAL-00001" summary="drop unchecked message">
-      <option name="closed" value="true" />
-      <created>1762497738518</created>
-      <option name="number" value="00001" />
-      <option name="presentableId" value="LOCAL-00001" />
-      <option name="project" value="LOCAL" />
-      <updated>1762497738518</updated>
-    </task>
-    <task id="LOCAL-00002" summary="drop unchecked message">
-      <option name="closed" value="true" />
-      <created>1762826395231</created>
-      <option name="number" value="00002" />
-      <option name="presentableId" value="LOCAL-00002" />
-      <option name="project" value="LOCAL" />
-      <updated>1762826395231</updated>
-    </task>
-    <option name="localTasksCounter" value="3" />
-    <servers />
-  </component>
-  <component name="TypeScriptGeneratedFilesManager">
-    <option name="version" value="3" />
-  </component>
-  <component name="Vcs.Log.Tabs.Properties">
-    <option name="TAB_STATES">
-      <map>
-        <entry key="MAIN">
-          <value>
-            <State />
-          </value>
-        </entry>
-      </map>
-    </option>
-  </component>
-  <component name="VcsManagerConfiguration">
-    <MESSAGE value="drop unchecked message" />
-    <option name="LAST_COMMIT_MESSAGE" value="drop unchecked message" />
-  </component>
-</project>

package/.xiaoma-core/.coordinator-state.json

@@ -1,19 +0,0 @@
-{
-  "workflowId": "test-1763048289115",
-  "workflowName": "自动化需求分析和架构设计流程",
-  "status": "in_progress",
-  "startTime": "2025-11-13T15:38:09.121Z",
-  "currentStepIndex": 1,
-  "completedSteps": [
-    {
-      "stepId": "pre_workflow_validation",
-      "status": "completed",
-      "outputs": [],
-      "duration": 5000,
-      "completedAt": "2025-11-13T15:38:09.126Z"
-    }
-  ],
-  "context": {},
-  "errors": [],
-  "retries": {}
-}

package/JAVA-BACKEND-COMMANDS-REFERENCE.md

@@ -1,300 +0,0 @@
-# 📋 Java 后端迭代开发 - Agent 命令使用参考
-
-> **重要说明**：本文档是《JAVA-BACKEND-ITERATION-GUIDE.md》的补充，明确每个步骤是否需要执行专用命令。
-
----
-
-## 🎯 命令使用的三种情况
-
-### ✅ **情况 1：必须使用专用命令**
-
-Agent 有明确的专用命令，**必须**在 Prompt 结尾明确指出要执行的命令。
-
-### 📝 **情况 2：无需专用命令**
-
-Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理解任务并执行。
-
-### 🔧 **情况 3：加载配置文件**
-
-特殊的 Agent（如 xiaoma-master）需要加载 YAML 配置文件来执行复杂任务。
-
----
-
-## 📊 完整步骤命令对照表
-
-### **阶段 1：需求理解和 PRD 创建**
-
-| 步骤                    | Agent     | 是否需要命令 | 命令                     | 说明                             |
-| ----------------------- | --------- | ------------ | ------------------------ | -------------------------------- |
-| 1.1 分析现有架构        | Architect | ❌ 不需要    | 无                       | 通过详细 Prompt 描述分析任务     |
-| 1.2 创建 Brownfield PRD | PM        | ✅ **需要**  | `*create-brownfield-prd` | 必须在 Prompt 结尾明确执行此命令 |
-| 1.2 验证 PRD 质量       | PM        | ❌ 不需要    | 无                       | 通过 Prompt 要求 Agent 自我审查  |
-| 1.3 创建模块            | PM        | ✅ **需要**  | `*create-epic`           | 必须在 Prompt 结尾明确执行此命令 |
-
----
-
-### **阶段 2：技术架构设计**
-
-| 步骤                 | Agent     | 是否需要命令 | 命令                           | 说明                             |
-| -------------------- | --------- | ------------ | ------------------------------ | -------------------------------- |
-| 2.1 后端架构增量设计 | Architect | ✅ **需要**  | `*create-backend-architecture` | 必须在 Prompt 结尾明确执行此命令 |
-| 2.1 架构评审         | Architect | ❌ 不需要    | 无                             | 通过 Prompt 要求 Agent 自我评审  |
-
----
-
-### **阶段 3：用户故事创建和细化**
-
-| 步骤                     | Agent | 是否需要命令 | 命令                    | 说明                             |
-| ------------------------ | ----- | ------------ | ----------------------- | -------------------------------- |
-| 3.1 识别用户故事列表     | SM    | ❌ 不需要    | 无                      | 通过 Prompt 描述任务，输出表格   |
-| 3.2 创建增强版用户故事   | SM    | ✅ **需要**  | `*draft-enhanced`       | 必须在 Prompt 结尾明确执行此命令 |
-| 3.2 验证故事质量         | SM    | ❌ 不需要    | 无                      | 通过 Prompt 要求 Agent 自检      |
-| 3.3 PO 验证用户故事      | PO    | ✅ **需要**  | `*validate-story-draft` | 必须在 Prompt 结尾明确执行此命令 |
-| 3.3 修改故事（如不通过） | SM    | ❌ 不需要    | 无                      | 通过 Prompt 描述修改要求         |
-
----
-
-### **阶段 4：Java 后端开发实现**
-
-| 步骤               | Agent | 是否需要命令 | 命令                               | 说明                                             |
-| ------------------ | ----- | ------------ | ---------------------------------- | ------------------------------------------------ |
-| 4.1 开发用户故事   | Dev   | ✅ **需要**  | `*develop-story {story-file-path}` | 必须在 Prompt 结尾明确执行此命令，带文件路径参数 |
-| 4.2 运行测试       | Dev   | ✅ **需要**  | `*run-tests`                       | 必须在 Prompt 结尾明确执行此命令                 |
-| 4.2 修复测试失败   | Dev   | ❌ 不需要    | 无                                 | 通过 Prompt 描述失败信息和修复要求               |
-| 4.3 代码自检和优化 | Dev   | ❌ 不需要    | 无                                 | 通过 Prompt 提供自检清单                         |
-
----
-
-### **阶段 5：QA 测试和质量门禁**
-
-| 步骤             | Agent | 是否需要命令 | 命令                           | 说明                                             |
-| ---------------- | ----- | ------------ | ------------------------------ | ------------------------------------------------ |
-| 5.1 QA 综合审查  | QA    | ✅ **需要**  | `*review {story-file-path}`    | 必须在 Prompt 结尾明确执行此命令，带文件路径参数 |
-| 5.2 修复 QA 问题 | Dev   | ✅ **需要**  | `*review-qa {story-file-path}` | 必须在 Prompt 结尾明确执行此命令，带文件路径参数 |
-| 5.2 重新测试     | Dev   | ✅ **需要**  | `*run-tests`                   | 必须在 Prompt 结尾明确执行此命令                 |
-| 5.2 重新 QA 审查 | QA    | ✅ **需要**  | `*review {story-file-path}`    | 必须在 Prompt 结尾明确执行此命令                 |
-| 5.3 质量门禁决策 | QA    | ✅ **需要**  | `*gate {story-file-path}`      | 必须在 Prompt 结尾明确执行此命令，带文件路径参数 |
-
----
-
-### **阶段 6：需求覆盖度审计和全局质量验证**
-
-| 步骤               | Agent         | 是否需要命令    | 命令                                      | 说明                                       |
-| ------------------ | ------------- | --------------- | ----------------------------------------- | ------------------------------------------ |
-| 6.1 需求覆盖度审计 | XiaoMa Master | 🔧 **加载配置** | 加载 `requirements-coverage-auditor.yaml` | 在 Prompt 中说明要加载此配置文件并执行审计 |
-| 6.2 全局质量验证   | XiaoMa Master | 🔧 **加载配置** | 加载 `automated-quality-validator.yaml`   | 在 Prompt 中说明要加载此配置文件并执行验证 |
-
-**说明**：对于加载配置文件的情况，目前文档中的做法是正确的：在 Prompt 中明确说"请加载 xxx.yaml 配置"。具体的加载方式可能因 Agent 实现而异。
-
----
-
-### **阶段 7：文档整理和交付准备**
-
-| 步骤                 | Agent     | 是否需要命令 | 命令                | 说明                                   |
-| -------------------- | --------- | ------------ | ------------------- | -------------------------------------- |
-| 7.1 生成完成故事汇总 | PO        | ❌ 不需要    | 无                  | 通过详细 Prompt 描述文档内容和格式要求 |
-| 7.2 生成 API 文档    | Architect | ⚠️ **可选**  | `*document-project` | 可以使用此命令或详细 Prompt            |
-| 7.3 生成数据库文档   | Architect | ⚠️ **可选**  | `*document-project` | 可以使用此命令或详细 Prompt            |
-| 7.4 生成部署文档     | Architect | ⚠️ **可选**  | `*document-project` | 可以使用此命令或详细 Prompt            |
-| 7.5 最终 PO 验收     | PO        | ❌ 不需要    | 无                  | 通过详细 Prompt 描述验收清单和决策标准 |
-
----
-
-## 🎯 实际使用示例
-
-### **示例 1：需要命令的步骤（PM 创建 PRD）**
-
-```
-**Prompt 内容**：
-我需要为现有 Java 后端项目创建一份迭代需求的 PRD 文档。
-
-[...详细的任务描述和要求...]
-
-**请执行命令**：
-*create-brownfield-prd
-```
-
-**关键点**：
-
-- ✅ 在 Prompt 最后明确写出命令
-- ✅ 命令前加粗标注"**请执行命令**："
-- ✅ Agent 会执行此命令并生成 PRD 文档
-
----
-
-### **示例 2：不需要命令的步骤（Architect 分析架构）**
-
-```
-**Prompt 内容**：
-请分析当前项目的后端架构。
-
-[...详细的分析要求和输出要求...]
-```
-
-**关键点**：
-
-- ✅ 不需要在 Prompt 结尾加命令
-- ✅ 通过详细描述让 Agent 理解任务
-- ✅ Agent 会根据 Prompt 执行分析并生成报告
-
----
-
-### **示例 3：开发故事（带参数的命令）**
-
-```
-**Prompt 内容**：
-请开发用户故事 US-01 的 Java 后端代码。
-
-**故事文件**：`docs/stories/epic01-story01.md`
-
-[...详细的开发任务和要求...]
-
-**请执行命令**：
-*develop-story docs/stories/epic01-story01.md
-```
-
-**关键点**：
-
-- ✅ 命令需要带文件路径参数
-- ✅ 参数是用户故事文件的完整路径
-- ✅ Agent 会读取该文件并执行开发
-
----
-
-### **示例 4：加载配置文件（特殊情况）**
-
-```
-**Prompt 内容**：
-请对整个迭代需求进行全面的覆盖度审计。
-
-[...详细的审计任务和要求...]
-
-**请加载配置并执行**：
-加载 requirements-coverage-auditor.yaml 配置，执行全面审计。
-```
-
-**关键点**：
-
-- ✅ 明确说明要加载哪个配置文件
-- ✅ 说明加载后要执行什么任务
-- ✅ 具体加载方式可能因实现而异
-
----
-
-## 📌 关键注意事项
-
-### ✅ **必须做的**
-
-1. **有专用命令的步骤**：
-   - 必须在 Prompt 结尾明确写出命令
-   - 格式：`**请执行命令**：\n*command-name {params}`
-   - 带参数的命令必须提供参数（如文件路径）
-
-2. **命令带参数的情况**：
-   - `*develop-story` → 需要故事文件路径
-   - `*review` → 需要故事文件路径
-   - `*review-qa` → 需要故事文件路径
-   - `*gate` → 需要故事文件路径
-
-3. **命令执行确认**：
-   - 发送 Prompt 后，观察 Agent 的响应
-   - Agent 应该明确说"正在执行 \*xxx 命令"
-   - 如果没有执行，需要重新发送 Prompt 并明确命令
-
-### ❌ **不要做的**
-
-1. **不需要命令的步骤**：
-   - 不要画蛇添足加命令
-   - 详细的 Prompt 描述就足够了
-   - Agent 会理解任务并执行
-
-2. **命令格式错误**：
-   - ❌ 错误：`请执行create-brownfield-prd`（缺少 `*`）
-   - ✅ 正确：`*create-brownfield-prd`
-
-3. **参数遗漏**：
-   - ❌ 错误：`*develop-story`（缺少文件路径）
-   - ✅ 正确：`*develop-story docs/stories/epic01-story01.md`
-
----
-
-## 🔍 如何判断是否需要命令
-
-### **判断依据 1：查看 Agent 的命令列表**
-
-从 Agent 分析报告中查看每个 Agent 有哪些命令：
-
-- **PM**: `*create-prd`, `*create-brownfield-prd`, `*create-epic`, `*shard-prd`
-- **PO**: `*create-epic`, `*create-story`, `*validate-story-draft`, `*shard-doc`
-- **SM**: `*draft`, `*draft-enhanced`, `*story-checklist`
-- **Dev**: `*develop-story`, `*review-qa`, `*run-tests`, `*explain`
-- **QA**: `*review`, `*gate`, `*test-design`, `*risk-profile`
-- **Architect**: `*create-backend-architecture`, `*create-front-end-architecture`, `*create-full-stack-architecture`, `*document-project`
-
-如果要执行的任务匹配这些命令之一，就**需要使用命令**。
-
-### **判断依据 2：任务类型**
-
-| 任务类型                        | 是否需要命令 | 示例                              |
-| ------------------------------- | ------------ | --------------------------------- |
-| 创建正式文档（PRD、模块、故事） | ✅ 需要      | `*create-epic`, `*draft-enhanced` |
-| 开发/测试代码                   | ✅ 需要      | `*develop-story`, `*run-tests`    |
-| 质量审查和决策                  | ✅ 需要      | `*review`, `*gate`                |
-| 探索性分析                      | ❌ 不需要    | 分析架构、识别故事列表            |
-| 自检和评审                      | ❌ 不需要    | 代码自检、架构评审                |
-| 文档生成（非正式）              | ❌ 不需要    | 汇总文档、API文档                 |
-| 验收决策                        | ❌ 不需要    | 最终验收                          |
-
-### **判断依据 3：查看原始操作手册**
-
-在《JAVA-BACKEND-ITERATION-GUIDE.md》中：
-
-- 如果 Prompt 底部有 `*command-name` 格式的内容 → **需要命令**
-- 如果只有详细描述，没有 `*` 开头的命令 → **不需要命令**
-
----
-
-## 💡 实战建议
-
-### **建议 1：使用命令清单**
-
-在实际操作时，将本文档打印出来或放在第二屏，随时查阅哪些步骤需要命令。
-
-### **建议 2：观察 Agent 响应**
-
-发送 Prompt 后，观察 Agent 的响应：
-
-- 如果 Agent 说"正在执行 \*xxx 命令" → 命令已识别 ✅
-- 如果 Agent 开始描述任务而不是执行 → 可能需要补充命令
-- 如果 Agent 说"我没有此命令" → 检查命令是否正确
-
-### **建议 3：Prompt 模板化**
-
-将需要命令的步骤制作成 Prompt 模板，固定格式：
-
-```
-[任务描述]
-
-**请执行命令**：
-*command-name {params}
-```
-
-### **建议 4：命令执行确认**
-
-对于关键步骤（如开发、QA），确认 Agent 执行了命令：
-
-- 查看 Agent 的回复是否包含命令执行的确认
-- 查看输出文件是否生成
-- 如有疑问，询问 Agent："你刚才执行了 \*xxx 命令吗？"
-
----
-
-## 📖 相关文档
-
-- [JAVA-BACKEND-ITERATION-GUIDE.md](./JAVA-BACKEND-ITERATION-GUIDE.md) - 完整操作手册
-- [CLAUDE.md](./CLAUDE.md) - 项目开发指南
-- [xiaoma-agents-analysis.md](./xiaoma-agents-analysis.md) - Agent 完整分析（如果有）
-
----
-
-**希望这份参考文档能帮助您清晰地了解何时需要使用命令！** 🚀