@zeyue0329/xiaoma-cli 1.0.37 → 1.0.38

package/.idea/workspace.xml

@@ -13,18 +13,18 @@
   <component name="Git.Settings">
     <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
   </component>
-  <component name="GitHubPullRequestSearchHistory"><![CDATA[{
-  "lastFilter": {
-    "state": "OPEN",
-    "assignee": "zqyl-xiaoma"
+  <component name="GitHubPullRequestSearchHistory">{
+  &quot;lastFilter&quot;: {
+    &quot;state&quot;: &quot;OPEN&quot;,
+    &quot;assignee&quot;: &quot;zqyl-xiaoma&quot;
   }
-}]]></component>
-  <component name="GithubPullRequestsUISettings"><![CDATA[{
-  "selectedUrlAndAccountId": {
-    "url": "https://github.com/zqyl-xiaoma/xiaoma-cli-release.git",
-    "accountId": "546cd128-11fc-43f0-8e6a-11f7d5bf6c09"
+}</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>
   <component name="ProjectColorInfo">{
   &quot;associatedIndex&quot;: 4
 }</component>
@@ -33,22 +33,22 @@
     <option name="hideEmptyMiddlePackages" value="true" />
     <option name="showLibraryContents" value="true" />
   </component>
-  <component name="PropertiesComponent"><![CDATA[{
-  "keyToString": {
-    "ModuleVcsDetector.initialDetectionPerformed": "true",
-    "RunOnceActivity.ShowReadmeOnStart": "true",
-    "RunOnceActivity.git.unshallow": "true",
-    "git-widget-placeholder": "main",
-    "last_opened_file_path": "/Users/liueryang/Documents/gitlab/XiaoMa-Cli",
-    "node.js.detected.package.eslint": "true",
-    "node.js.detected.package.tslint": "true",
-    "node.js.selected.package.eslint": "(autodetect)",
-    "node.js.selected.package.tslint": "(autodetect)",
-    "nodejs_package_manager_path": "npm",
-    "prettierjs.PrettierConfiguration.Package": "/Users/liueryang/Documents/gitlab/XiaoMa-Cli/node_modules/prettier",
-    "vue.rearranger.settings.migration": "true"
+  <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>
   <component name="SharedIndexes">
     <attachedChunks>
       <set>
@@ -65,7 +65,8 @@
       <option name="presentableId" value="Default" />
       <updated>1762494962173</updated>
       <workItem from="1762494963355" duration="2769000" />
-      <workItem from="1762781553645" duration="2079000" />
+      <workItem from="1762781553645" duration="3390000" />
+      <workItem from="1762933631198" duration="16000" />
     </task>
     <task id="LOCAL-00001" summary="drop unchecked message">
       <option name="closed" value="true" />

package/JAVA-BACKEND-COMMANDS-REFERENCE.md

@@ -7,12 +7,15 @@
 ## 🎯 命令使用的三种情况
 
 ### ✅ **情况 1：必须使用专用命令**
+
 Agent 有明确的专用命令，**必须**在 Prompt 结尾明确指出要执行的命令。
 
 ### 📝 **情况 2：无需专用命令**
+
 Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理解任务并执行。
 
 ### 🔧 **情况 3：加载配置文件**
+
 特殊的 Agent（如 xiaoma-master）需要加载 YAML 配置文件来执行复杂任务。
 
 ---
@@ -21,65 +24,65 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 
 ### **阶段 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 结尾明确执行此命令 |
+| 步骤                    | 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 自我评审 |
+| 步骤                 | 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 描述修改要求 |
+| 步骤                     | 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 提供自检清单 |
+| 步骤               | 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 结尾明确执行此命令，带文件路径参数 |
+| 步骤             | 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 | 是否需要命令 | 命令 | 说明 |
-|-----|-------|------------|------|------|
+| 步骤               | Agent         | 是否需要命令    | 命令                                      | 说明                                       |
+| ------------------ | ------------- | --------------- | ----------------------------------------- | ------------------------------------------ |
 | 6.1 需求覆盖度审计 | XiaoMa Master | 🔧 **加载配置** | 加载 `requirements-coverage-auditor.yaml` | 在 Prompt 中说明要加载此配置文件并执行审计 |
-| 6.2 全局质量验证 | XiaoMa Master | 🔧 **加载配置** | 加载 `automated-quality-validator.yaml` | 在 Prompt 中说明要加载此配置文件并执行验证 |
+| 6.2 全局质量验证   | XiaoMa Master | 🔧 **加载配置** | 加载 `automated-quality-validator.yaml`   | 在 Prompt 中说明要加载此配置文件并执行验证 |
 
 **说明**：对于加载配置文件的情况，目前文档中的做法是正确的：在 Prompt 中明确说"请加载 xxx.yaml 配置"。具体的加载方式可能因 Agent 实现而异。
 
@@ -87,13 +90,13 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 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 描述验收清单和决策标准 |
+| 步骤                 | 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 描述验收清单和决策标准 |
 
 ---
 
@@ -112,6 +115,7 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 ```
 
 **关键点**：
+
 - ✅ 在 Prompt 最后明确写出命令
 - ✅ 命令前加粗标注"**请执行命令**："
 - ✅ Agent 会执行此命令并生成 PRD 文档
@@ -128,6 +132,7 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 ```
 
 **关键点**：
+
 - ✅ 不需要在 Prompt 结尾加命令
 - ✅ 通过详细描述让 Agent 理解任务
 - ✅ Agent 会根据 Prompt 执行分析并生成报告
@@ -149,6 +154,7 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 ```
 
 **关键点**：
+
 - ✅ 命令需要带文件路径参数
 - ✅ 参数是用户故事文件的完整路径
 - ✅ Agent 会读取该文件并执行开发
@@ -168,6 +174,7 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 ```
 
 **关键点**：
+
 - ✅ 明确说明要加载哪个配置文件
 - ✅ 说明加载后要执行什么任务
 - ✅ 具体加载方式可能因实现而异
@@ -191,7 +198,7 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 
 3. **命令执行确认**：
    - 发送 Prompt 后，观察 Agent 的响应
-   - Agent 应该明确说"正在执行 *xxx 命令"
+   - Agent 应该明确说"正在执行 \*xxx 命令"
    - 如果没有执行，需要重新发送 Prompt 并明确命令
 
 ### ❌ **不要做的**
@@ -228,19 +235,20 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 
 ### **判断依据 2：任务类型**
 
-| 任务类型 | 是否需要命令 | 示例 |
-|---------|------------|------|
-| 创建正式文档（PRD、史诗、故事） | ✅ 需要 | `*create-epic`, `*draft-enhanced` |
-| 开发/测试代码 | ✅ 需要 | `*develop-story`, `*run-tests` |
-| 质量审查和决策 | ✅ 需要 | `*review`, `*gate` |
-| 探索性分析 | ❌ 不需要 | 分析架构、识别故事列表 |
-| 自检和评审 | ❌ 不需要 | 代码自检、架构评审 |
-| 文档生成（非正式） | ❌ 不需要 | 汇总文档、API文档 |
-| 验收决策 | ❌ 不需要 | 最终验收 |
+| 任务类型                        | 是否需要命令 | 示例                              |
+| ------------------------------- | ------------ | --------------------------------- |
+| 创建正式文档（PRD、史诗、故事） | ✅ 需要      | `*create-epic`, `*draft-enhanced` |
+| 开发/测试代码                   | ✅ 需要      | `*develop-story`, `*run-tests`    |
+| 质量审查和决策                  | ✅ 需要      | `*review`, `*gate`                |
+| 探索性分析                      | ❌ 不需要    | 分析架构、识别故事列表            |
+| 自检和评审                      | ❌ 不需要    | 代码自检、架构评审                |
+| 文档生成（非正式）              | ❌ 不需要    | 汇总文档、API文档                 |
+| 验收决策                        | ❌ 不需要    | 最终验收                          |
 
 ### **判断依据 3：查看原始操作手册**
 
 在《JAVA-BACKEND-ITERATION-GUIDE.md》中：
+
 - 如果 Prompt 底部有 `*command-name` 格式的内容 → **需要命令**
 - 如果只有详细描述，没有 `*` 开头的命令 → **不需要命令**
 
@@ -255,7 +263,8 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 ### **建议 2：观察 Agent 响应**
 
 发送 Prompt 后，观察 Agent 的响应：
-- 如果 Agent 说"正在执行 *xxx 命令" → 命令已识别 ✅
+
+- 如果 Agent 说"正在执行 \*xxx 命令" → 命令已识别 ✅
 - 如果 Agent 开始描述任务而不是执行 → 可能需要补充命令
 - 如果 Agent 说"我没有此命令" → 检查命令是否正确
 
@@ -273,9 +282,10 @@ Agent 没有对应的专用命令，通过详细的 Prompt 描述让 Agent 理
 ### **建议 4：命令执行确认**
 
 对于关键步骤（如开发、QA），确认 Agent 执行了命令：
+
 - 查看 Agent 的回复是否包含命令执行的确认
 - 查看输出文件是否生成
-- 如有疑问，询问 Agent："你刚才执行了 *xxx 命令吗？"
+- 如有疑问，询问 Agent："你刚才执行了 \*xxx 命令吗？"
 
 ---