@zeyue0329/xiaoma-cli 1.0.49 → 1.0.66

package/docs/roadshow/05-/346/212/200/346/234/257/345/256/236/347/216/260/344/270/216/345/210/233/346/226/260/344/272/256/347/202/271.md

@@ -0,0 +1,205 @@
+# 技术实现与创新亮点
+
+## 1. Step-File 微架构 — 防上下文丢失机制
+
+**问题**: LLM 在长对话中容易丢失上下文，导致执行偏离
+**解决方案**: Step-File 微架构
+
+```mermaid
+flowchart TD
+    subgraph "传统方式"
+        T1[长提示词] --> T2[上下文膨胀] --> T3[执行偏离]
+    end
+
+    subgraph "Step-File 架构"
+        S1["workflow.md 入口"] --> S2["仅加载 step-01"]
+        S2 -->|完成后卸载| S3["仅加载 step-02"]
+        S3 -->|完成后卸载| S4["仅加载 step-03"]
+        S4 --> S5["..."]
+    end
+```
+
+**核心设计**:
+- 每次仅一个步骤文件在内存中
+- 步骤间通过状态变量传递信息
+- 前端元数据（frontmatter）跟踪进度
+- 阶段边界摘要防止信息丢失
+- 强制从磁盘重新读取（Fresh Reads）而非依赖记忆
+
+## 2. 配置驱动的 IDE 安装架构
+
+**问题**: 支持 25+ IDE 平台，每个平台有不同的目录结构和配置格式
+**解决方案**: 统一配置驱动
+
+```mermaid
+flowchart LR
+    PC["platform-codes.yaml\n平台注册表"] --> CDI["ConfigDrivenIdeSetup\n统一安装器"]
+    CDI --> C1[".claude/skills/"]
+    CDI --> C2[".cursor/skills/"]
+    CDI --> C3[".cline/skills/"]
+    CDI --> C4[".windsurf/skills/"]
+    CDI --> CN["... 25+ 平台"]
+```
+
+**设计优势**:
+- 零自定义代码：新增 IDE 只需在 YAML 中添加配置
+- 统一行为：所有平台使用相同安装逻辑
+- 灵活适配：支持不同目录结构、模板类型、技能格式
+- 遗留兼容：自动迁移旧版安装路径
+
+每个平台配置包含:
+```yaml
+platform_name:
+  name: "平台名称"
+  preferred: true/false
+  category: cli/ide
+  installer:
+    target_dir: .platform/skills
+    template_type: default
+    skill_format: true
+    ancestor_conflict_check: true
+```
+
+## 3. 占位符替换系统
+
+**问题**: 安装到不同项目需要动态配置
+**解决方案**: 安装时占位符替换
+
+支持的占位符:
+| 占位符 | 替换值 |
+|--------|--------|
+| `{_xiaoma}` | 实际 xiaoma 文件夹名 |
+| `{project-root}` | 项目根目录 |
+| `{module}` | 模块标识符 |
+| `{version}` | XiaoMa 版本号 |
+| `{date}` | 安装日期 |
+
+**嵌套变量引用**: 变量可以引用其他模块变量
+```
+output_folder: "_xiaoma-output"
+planning_artifacts: "{output_folder}/planning-artifacts"  # 解析为 _xiaoma-output/planning-artifacts
+```
+
+应用范围: Markdown、YAML、JSON、JS、TS、Shell 文件（二进制文件跳过）
+
+## 4. Manifest 驱动发现机制
+
+**问题**: IDE 需要知道安装了哪些智能体、工作流、技能
+**解决方案**: CSV 清单注册表
+
+生成的清单文件:
+| 清单 | 内容 | 用途 |
+|------|------|------|
+| agent-manifest.csv | 所有智能体元数据 | IDE 智能体发现 |
+| workflow-manifest.csv | 所有工作流元数据 | 工作流触发 |
+| task-manifest.csv | 所有任务元数据 | 任务执行 |
+| files-manifest.csv | 所有已安装文件 | 完整性校验 |
+
+**优势**: 无需运行时文件系统扫描，单一事实来源
+
+## 5. Zod Schema 验证体系
+
+**问题**: 智能体 YAML 定义需要严格的格式和语义校验
+**解决方案**: Zod 运行时类型验证
+
+验证规则:
+- 触发器格式: kebab-case 或复合格式 `XX or fuzzy match on trigger-name`
+- 描述前缀匹配: `[XX]` 必须与触发器快捷键一致
+- 触发器唯一性: 同一智能体内不允许重复
+- 模块作用域: 从文件路径推导并强制执行
+
+测试覆盖:
+- 50 个测试用例（18 个有效 + 32 个无效）
+- 目标 100% 分支覆盖率
+
+## 6. 质量门禁体系
+
+```mermaid
+flowchart LR
+    CODE[代码变更] --> LF["lint-staged\nHusky 钩子"]
+    LF --> L1["ESLint\nJS + YAML"]
+    LF --> L2["Prettier\n格式化"]
+
+    subgraph "npm run quality"
+        T1["test:schemas\nSchema验证测试"]
+        T2["test:refs\n交叉引用验证"]
+        T3["test:install\n安装组件测试"]
+        T4["validate:schemas\nSchema验证"]
+        T5["lint\nESLint零警告"]
+        T6["lint:md\nMarkdown检查"]
+        T7["format:check\nPrettier检查"]
+    end
+
+    L1 --> T1
+    L2 --> T1
+    T1 --> T2 --> T3 --> T4 --> T5 --> T6 --> T7
+    T7 --> PASS["质量通过"]
+```
+
+**零容忍策略**: `--max-warnings=0`，任何警告都会阻断
+
+## 7. 多智能体编排与状态管理
+
+### 批处理与重试循环
+
+```mermaid
+flowchart TD
+    INIT[流水线初始化] --> DISC[发现下一个故事]
+    DISC --> DEV[开发实现]
+    DEV --> REVIEW[代码评审]
+    REVIEW --> QA[QA测试]
+    QA -->|通过| CHECK{更多故事?}
+    QA -->|失败| FIX[Bug修复]
+    FIX -->|"迭代 <= 5"| QA
+    FIX -->|"迭代 > 5"| HALT["停止"]
+    CHECK -->|是| DISC
+    CHECK -->|否| DONE["全部完成"]
+```
+
+**状态持久化机制**:
+- `pipeline_status`: 流水线整体状态
+- `current_story_key`: 当前故事标识
+- `fix_iteration`: Bug 修复迭代计数
+- `stories_completed`: 完成故事计数
+- 批处理模式下循环重置 `current_story_path`
+
+### 角色切换协议
+流水线中智能体角色动态切换：
+- 每个步骤加载对应智能体的 persona
+- 角色切换时生成阶段摘要
+- 后续步骤从磁盘重新读取（而非依赖前序角色的记忆）
+
+## 8. Party 模式 — 多智能体群组讨论
+
+**创新点**: 在回顾等场景中，多个智能体以对话形式参与讨论
+
+格式示例:
+```
+xiaofen (业务分析师): 从需求角度看，这个Sprint...
+xiaojia (架构师): 架构决策方面...
+xiaokai (开发工程师): 实现过程中...
+```
+
+**设计原则**:
+- 心理安全：无指责文化
+- 聚焦系统和流程，而非个人
+- 结构化输出：史诗回顾 + 下一史诗准备
+
+## 9. 智能故事上下文引擎
+
+创建故事时，系统进行穷尽式信息收集:
+
+```mermaid
+flowchart TD
+    EPIC["epics.md"] --> SC[故事上下文引擎]
+    PRD["prd.md"] --> SC
+    ARCH["architecture.md"] --> SC
+    UX["ux-design.md"] --> SC
+    PREV["前序故事\n实现经验"] --> SC
+    GIT["Git 历史\n最近提交"] --> SC
+    WEB["Web 研究\n最新技术版本"] --> SC
+
+    SC --> STORY["story-file.md\n开发者不会犯错的\n完备上下文"]
+```
+
+**目标**: 提供足够完备的上下文，使开发智能体无需回溯任何历史即可正确实现

package/docs/roadshow/06-/350/267/257/346/274/224/346/200/273/347/273/223/344/270/216/346/274/224/347/244/272/345/273/272/350/256/256.md

@@ -0,0 +1,167 @@
+# 路演总结与演示建议
+
+## 1. 产品价值总结（面向管理层）
+
+### 核心价值主张
+
+XiaoMa-CLI 实现了 **AI 驱动的全流程敏捷开发**，将传统需要多人协作数周完成的软件开发流程，通过 9 个 AI 智能体的协同自动化，显著提升交付效率。
+
+### 业务价值
+
+- **效率提升**: 从需求到交付的全流程自动化，减少人工干预
+- **质量保障**: 多层质量门禁（PRD 验证、实施就绪检查、代码评审、QA 测试）
+- **标准化**: 统一的开发流程和文档标准
+- **可扩展**: 支持 25+ AI IDE 平台，适应不同团队工具偏好
+- **低门槛**: 一键安装，无需复杂配置
+
+### 适用场景
+
+- 新项目从零到一的快速启动
+- 棕地项目（已有代码库）的 AI 增强开发
+- 团队敏捷流程的标准化和自动化
+- AI 辅助代码评审和质量保障
+
+## 2. 技术创新总结（面向技术负责人）
+
+### 架构创新
+
+| 创新点               | 解决的问题           | 技术方案                          |
+| -------------------- | -------------------- | --------------------------------- |
+| Step-File 微架构     | LLM 长对话上下文丢失 | 步骤文件隔离 + 状态持久化         |
+| 配置驱动 IDE 安装    | 多平台适配复杂度     | 统一 YAML 配置 + 零代码扩展      |
+| 多智能体编排         | 复杂流程协调         | 流水线状态机 + 角色切换           |
+| 穷尽式上下文引擎     | 开发偏离需求         | 多源信息聚合到 Story 文件         |
+| Manifest 驱动发现    | IDE 集成发现机制     | CSV 清单 + 运行时零扫描           |
+| Zod Schema 验证      | 智能体定义一致性     | 运行时类型校验 + 100%覆盖         |
+
+### 技术指标
+
+- **零警告策略**: ESLint --max-warnings=0
+- **50 个 Schema 测试用例**: 18 有效 + 32 无效
+- **占位符系统**: 支持嵌套变量引用
+- **批处理重试**: Bug 修复最多 5 次迭代
+- **Fresh Reads 机制**: 始终从磁盘读取最新状态
+
+## 3. 核心数据指标
+
+```mermaid
+mindmap
+  root((XiaoMa-CLI))
+    智能体系统
+      9 个专业智能体
+      完整敏捷团队模拟
+      动态角色切换
+    工作流引擎
+      26 个结构化工作流
+      5 个开发阶段
+      3 条自动化流水线
+    技能库
+      12 个核心技能
+      50+ 工作流技能
+    平台支持
+      25+ AI IDE 平台
+      配置驱动零代码
+    质量体系
+      7 层质量门禁
+      50 个验证用例
+```
+
+## 4. 建议演示路径
+
+### 路径一：快速概览（15 分钟）
+
+适用于高管汇报、跨部门沟通等需要快速传递核心信息的场景。
+
+1. **开场**（2 分钟）: 项目定位和价值主张
+2. **架构总览**（3 分钟）: 两层架构 + 模块系统
+3. **智能体展示**（5 分钟）: 9 个智能体角色介绍 + 协作关系图
+4. **流水线演示**（3 分钟）: 自动全流程流水线的三阶段编排
+5. **总结**（2 分钟）: 核心数据指标 + 未来方向
+
+### 路径二：深度汇报（30 分钟）
+
+适用于技术委员会评审、项目立项答辩等需要深入了解技术方案的场景。
+
+1. **开场与背景**（3 分钟）: 问题域 + 产品定位
+2. **架构设计**（5 分钟）: 两层架构 + 模块系统 + CLI 安装流程
+3. **智能体系统**（7 分钟）: 9 个智能体详解 + Schema 验证 + Sidecar 记忆
+4. **工作流引擎**（7 分钟）: 5 阶段 26 工作流 + Step-File 微架构
+5. **自动化流水线**（5 分钟）: AR + ASP + AFP 三条流水线
+6. **技术创新**（3 分钟）: 核心创新亮点
+
+### 路径三：技术深潜（45 分钟）
+
+适用于技术团队内部分享、开发者大会等需要深入技术细节和现场演示的场景。
+
+在路径二基础上增加：
+
+- 现场安装演示（`npx @zeyue0329/xiaoma-cli install`）
+- 单故事开发全流程 Live Demo
+- 代码评审流程演示
+- 多 IDE 平台适配展示
+
+## 5. 演示建议
+
+### 关键演示要点
+
+1. **智能体人格化**: 展示每个智能体的角色定位和沟通风格差异，让观众感受到"团队协作"的真实感
+2. **流水线编排**: 重点展示 AFP（全流程流水线）如何自动编排多个智能体完成从需求到交付的全过程
+3. **质量门禁链**: 展示从 PRD 验证到代码评审的完整质量保障链，强调"AI 不仅写代码，更保障代码质量"
+4. **一键安装**: 演示 `npx xiaoma-cli install` 的交互式安装流程，突出"即插即用"的低门槛优势
+5. **多 IDE 支持**: 展示同一套智能体在 Claude Code 和 Cursor 中的无缝使用
+
+### 视觉建议
+
+- 使用本系列文档中的 Mermaid 图表作为 PPT 信息图基础
+- 智能体关系图适合作为核心展示页，能直观传递"AI 敏捷团队"的概念
+- 三大流水线流程图适合分页展示，每页聚焦一条流水线的价值
+- 状态机图适合解释 Story 生命周期，帮助观众理解开发全流程
+
+### 演示环境准备
+
+- 提前在演示机上安装好 Node.js v20+ 和目标 AI IDE
+- 准备一个干净的示例项目用于现场安装演示
+- 确保网络环境稳定（需要 npm 包下载）
+- 准备离线备份方案（提前录制演示视频）
+
+## 6. Q&A 预备问题
+
+### 管理层可能的提问
+
+| 问题                         | 建议回答方向                                                       |
+| ---------------------------- | ------------------------------------------------------------------ |
+| 与现有开发流程如何兼容？     | 支持棕地项目，渐进式采用，不强制替换现有流程                       |
+| 成本和 ROI？                 | 一键安装零额外成本，通过自动化减少重复工作，提升开发者产能         |
+| 数据安全？                   | 所有处理在本地完成，不上传代码到第三方服务，数据不出开发环境       |
+| 团队学习曲线？               | 交互式安装 + 帮助技能 + 技能等级适配（初级/中级/专家）            |
+| 支持的编程语言？             | 语言无关，支持任何编程语言的项目                                   |
+| 如何衡量引入后的效果？       | 可从需求到交付周期、代码评审通过率、文档完整度等维度进行对比       |
+
+### 技术负责人可能的提问
+
+| 问题                           | 建议回答方向                                                         |
+| ------------------------------ | -------------------------------------------------------------------- |
+| 如何保证 LLM 输出质量？       | Step-File 防偏离 + 多层验证 + 穷尽式上下文 + 重试机制               |
+| 如何扩展新的智能体？           | YAML 定义 + Zod Schema 验证 + 标准化菜单系统                        |
+| 如何集成到 CI/CD？             | 提供 CLI 命令行接口，可集成到任何自动化流程                          |
+| 与其他 AI 开发工具的区别？     | 全流程覆盖（不仅仅是代码生成），多智能体协作，结构化工作流          |
+| 自定义工作流？                 | 支持自定义模块（--custom-content），可扩展智能体和工作流             |
+| 对 LLM 提供商有锁定吗？       | 框架本身与 LLM 无关，通过 AI IDE 间接调用，支持任何 IDE 背后的模型  |
+
+## 7. 路演核心信息
+
+> **一句话定位**: XiaoMa-CLI 是业界首个实现从需求到交付全流程 AI 智能体协同的敏捷开发框架
+>
+> **三个关键词**: 多智能体协同 · 全流程自动化 · 即插即用
+>
+> **核心差异化**: 不是简单的代码生成工具，而是模拟完整敏捷团队的 AI 开发框架
+
+### 核心信息传递优先级
+
+1. **第一优先级 — 价值定位**: XiaoMa-CLI 用 AI 智能体模拟完整敏捷团队，覆盖从需求分析到代码交付的全生命周期
+2. **第二优先级 — 技术创新**: Step-File 微架构、穷尽式上下文引擎、配置驱动多平台适配等核心技术突破
+3. **第三优先级 — 落地能力**: 一键安装、25+ IDE 支持、语言无关、零额外成本
+
+### 结束语建议
+
+> XiaoMa-CLI 代表了 AI 辅助软件开发的下一个方向：不是让 AI 替代开发者，而是让每个开发者都拥有一支完整的 AI 敏捷团队。通过结构化的工作流编排和多智能体协同，我们将"AI 写代码"升级为"AI 做工程"。

package/package.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@zeyue0329/xiaoma-cli",
-  "version": "1.0.49",
-  "description": "XiaoMa Cli: Universal AI Agent Framework",
+  "version": "1.0.66",
+  "description": "XiaoMa Universal AI Agent Framework",
   "keywords": [
     "agile",
     "ai",
@@ -17,97 +17,87 @@
     "url": "git+https://github.com/zqyl-xiaoma/xiaoma-cli-release.git"
   },
   "license": "MIT",
-  "author": "zeyue0329 <zeyue0329@gmail.com>",
-  "main": "tools/cli.js",
+  "author": "Zeyue",
+  "main": "tools/cli/xiaoma-cli.js",
   "bin": {
     "xiaoma": "tools/xiaoma-npx-wrapper.js",
     "xiaoma-cli": "tools/xiaoma-npx-wrapper.js"
   },
   "scripts": {
-    "api:start": "node tools/api-server.js",
-    "api:dev": "nodemon tools/api-server.js",
-    "build": "node tools/cli.js build --no-expansions",
-    "build:agents": "node tools/cli.js build --agents-only",
-    "build:teams": "node tools/cli.js build --teams-only",
-    "fix": "npm run format && npm run lint:fix",
     "flatten": "node tools/flattener/main.js",
-    "format": "prettier --write \"**/*.{js,cjs,mjs,json,md,yaml}\"",
-    "format:check": "prettier --check \"**/*.{js,cjs,mjs,json,md,yaml}\"",
-    "install:xiaoma": "node tools/installer/bin/xiaoma.js install",
+    "format:check": "prettier --check \"**/*.{js,cjs,mjs,json,yaml}\"",
+    "format:fix": "prettier --write \"**/*.{js,cjs,mjs,json,yaml}\"",
+    "format:fix:staged": "prettier --write",
+    "install:xiaoma": "node tools/cli/xiaoma-cli.js install",
     "lint": "eslint . --ext .js,.cjs,.mjs,.yaml --max-warnings=0",
     "lint:fix": "eslint . --ext .js,.cjs,.mjs,.yaml --fix",
-    "list:agents": "node tools/cli.js list:agents",
-    "pre-release": "npm run validate && npm run format:check && npm run lint",
-    "prepare": "husky",
-    "preview:release": "node tools/preview-release-notes.js",
-    "release:major": "gh workflow run \"Manual Release\" -f version_bump=major",
-    "release:minor": "gh workflow run \"Manual Release\" -f version_bump=minor",
-    "release:patch": "gh workflow run \"Manual Release\" -f version_bump=patch",
-    "release:watch": "gh run watch",
-    "setup:hooks": "chmod +x tools/setup-hooks.sh && ./tools/setup-hooks.sh",
-    "validate": "node tools/cli.js validate",
-    "version:all": "node tools/bump-all-versions.js",
-    "version:all:major": "node tools/bump-all-versions.js major",
-    "version:all:minor": "node tools/bump-all-versions.js minor",
-    "version:all:patch": "node tools/bump-all-versions.js patch",
-    "version:expansion": "node tools/bump-expansion-version.js",
-    "version:expansion:all": "node tools/bump-all-versions.js",
-    "version:expansion:all:major": "node tools/bump-all-versions.js major",
-    "version:expansion:all:minor": "node tools/bump-all-versions.js minor",
-    "version:expansion:all:patch": "node tools/bump-all-versions.js patch",
-    "version:expansion:set": "node tools/update-expansion-version.js",
-    "version:major": "node tools/version-bump.js major",
-    "version:minor": "node tools/version-bump.js minor",
-    "version:patch": "node tools/version-bump.js patch"
+    "lint:md": "markdownlint-cli2 \"**/*.md\"",
+    "prepare": "command -v husky >/dev/null 2>&1 && husky || exit 0",
+    "quality": "npm run format:check && npm run lint && npm run lint:md && npm run validate:schemas && npm run test:schemas && npm run test:install && npm run validate:refs",
+    "rebundle": "node tools/cli/bundlers/bundle-web.js rebundle",
+    "test": "npm run test:schemas && npm run test:refs && npm run test:install && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
+    "test:coverage": "c8 --reporter=text --reporter=html npm run test:schemas",
+    "test:install": "node test/test-installation-components.js",
+    "test:refs": "node test/test-file-refs-csv.js",
+    "test:schemas": "node test/test-agent-schema.js",
+    "validate:refs": "node tools/validate-file-refs.js --strict",
+    "validate:schemas": "node tools/validate-agent-schema.js",
+    "xiaoma:install": "node tools/cli/xiaoma-cli.js install",
+    "xiaoma:uninstall": "node tools/cli/xiaoma-cli.js uninstall"
   },
   "lint-staged": {
-    "**/*.{js,cjs,mjs}": [
-      "eslint --fix --max-warnings=0",
-      "prettier --write"
+    "*.{js,cjs,mjs}": [
+      "npm run lint:fix",
+      "npm run format:fix:staged"
     ],
-    "**/*.yaml": [
+    "*.yaml": [
       "eslint --fix",
-      "prettier --write"
+      "npm run format:fix:staged"
     ],
-    "**/*.{json,md}": [
-      "prettier --write"
+    "*.json": [
+      "npm run format:fix:staged"
+    ],
+    "*.md": [
+      "markdownlint-cli2"
     ]
   },
   "dependencies": {
+    "@clack/core": "^1.0.0",
+    "@clack/prompts": "^1.0.0",
     "@kayvan/markdown-tree-parser": "^1.6.1",
-    "body-parser": "^2.2.0",
     "chalk": "^4.1.2",
     "commander": "^14.0.0",
-    "cors": "^2.8.5",
-    "express": "^5.1.0",
-    "fs-extra": "^11.3.1",
+    "csv-parse": "^6.1.0",
+    "fs-extra": "^11.3.0",
     "glob": "^11.0.3",
     "ignore": "^7.0.5",
-    "inquirer": "^8.2.6",
     "js-yaml": "^4.1.0",
-    "ora": "^5.4.1",
-    "semver": "^7.7.2"
+    "ora": "^9.3.0",
+    "picocolors": "^1.1.1",
+    "semver": "^7.6.3",
+    "xml2js": "^0.6.2",
+    "yaml": "^2.7.0",
+    "zod": "^3.23.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.34.0",
-    "@semantic-release/changelog": "6.0.3",
-    "@semantic-release/git": "^10.0.1",
-    "eslint": "^9.34.0",
+    "@eslint/js": "^9.33.0",
+    "c8": "^10.1.3",
+    "eslint": "^9.33.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-n": "^17.21.3",
     "eslint-plugin-unicorn": "^60.0.0",
     "eslint-plugin-yml": "^1.18.0",
     "husky": "^9.1.7",
-    "jest": "^30.0.5",
-    "lint-staged": "^16.1.5",
-    "prettier": "^3.6.2",
+    "jest": "^30.2.0",
+    "lint-staged": "^16.1.1",
+    "markdownlint-cli2": "^0.19.1",
+    "prettier": "^3.7.4",
     "prettier-plugin-packagejson": "^2.5.19",
-    "semantic-release": "24.2.7",
-    "yaml-eslint-parser": "^1.3.0",
+    "yaml-eslint-parser": "^1.2.3",
     "yaml-lint": "^1.7.0"
   },
   "engines": {
-    "node": ">=20.10.0"
+    "node": ">=20.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/core/module-help.csv

@@ -0,0 +1,11 @@
+module,phase,name,code,sequence,workflow-file,command,required,agent,options,description,output-location,outputs
+core,anytime,Brainstorming,BSP,,skill:xiaoma-brainstorming,xiaoma-brainstorming,false,analyst,,"Generate diverse ideas through interactive techniques. Use early in ideation phase or when stuck generating ideas.",{output_folder}/brainstorming/brainstorming-session-{{date}}.md,,
+core,anytime,Party Mode,PM,,skill:xiaoma-party-mode,xiaoma-party-mode,false,party-mode facilitator,,"Orchestrate multi-agent discussions. Use when you need multiple agent perspectives or want agents to collaborate.",,
+core,anytime,xiaoma-help,BH,,skill:xiaoma-help,xiaoma-help,false,,,"Get unstuck by showing what workflow steps come next or answering XiaoMa Method questions.",,
+core,anytime,Index Docs,ID,,skill:xiaoma-index-docs,xiaoma-index-docs,false,,,"Create lightweight index for quick LLM scanning. Use when LLM needs to understand available docs without loading everything.",,
+core,anytime,Shard Document,SD,,skill:xiaoma-shard-doc,xiaoma-shard-doc,false,,,"Split large documents into smaller files by sections. Use when doc becomes too large (>500 lines) to manage effectively.",,
+core,anytime,Editorial Review - Prose,EP,,skill:xiaoma-editorial-review-prose,xiaoma-editorial-review-prose,false,,,"Review prose for clarity, tone, and communication issues. Use after drafting to polish written content.",report located with target document,"three-column markdown table with suggested fixes",
+core,anytime,Editorial Review - Structure,ES,,skill:xiaoma-editorial-review-structure,xiaoma-editorial-review-structure,false,,,"Propose cuts, reorganization, and simplification while preserving comprehension. Use when doc produced from multiple subprocesses or needs structural improvement.",report located with target document,
+core,anytime,Adversarial Review (General),AR,,skill:xiaoma-review-adversarial-general,xiaoma-review-adversarial-general,false,,,"Review content critically to find issues and weaknesses. Use for quality assurance or before finalizing deliverables. Code Review in other modules run this automatically, but its useful also for document reviews",,
+core,anytime,Edge Case Hunter Review,ECH,,skill:xiaoma-review-edge-case-hunter,xiaoma-review-edge-case-hunter,false,,,"Walk every branching path and boundary condition in code, report only unhandled edge cases. Use alongside adversarial review for orthogonal coverage - method-driven not attitude-driven.",,
+core,anytime,Distillator,DG,,skill:xiaoma-distillator,xiaoma-distillator,false,,,"Lossless LLM-optimized compression of source documents. Use when you need token-efficient distillates that preserve all information for downstream LLM consumption.",adjacent to source document or specified output_path,distillate markdown file(s)

package/src/core/module.yaml

@@ -0,0 +1,25 @@
+code: core
+name: "XiaoMa Core Module"
+
+header: "XiaoMa Core Configuration"
+subheader: "Configure the core settings for your XiaoMa installation.\nThese settings will be used across all installed xiaoma skills, workflows, and agents."
+
+user_name:
+  prompt: "What should agents call you? (Use your name or a team name)"
+  default: "XiaoMa"
+  result: "{value}"
+
+communication_language:
+  prompt: "What language should agents use when chatting with you?"
+  default: "English"
+  result: "{value}"
+
+document_output_language:
+  prompt: "Preferred document output language?"
+  default: "English"
+  result: "{value}"
+
+output_folder:
+  prompt: "Where should output files be saved?"
+  default: "_xiaoma-output"
+  result: "{project-root}/{value}"

package/src/core/skills/xiaoma-advanced-elicitation/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: xiaoma-advanced-elicitation
+description: 'Push the LLM to reconsider, refine, and improve its recent output.'
+---
+
+Follow the instructions in ./workflow.md.