npm - speccore - Versions diffs - 5.67.60 → 5.67.62 - Mend

speccore 5.67.60 → 5.67.62

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.en.md CHANGED Viewed

@@ -7,19 +7,24 @@
 ```
   init → doc2spec → analyze → split → plan → execute → pr → done
   🚀Setup   📝Import   🧠Analyze  📦Split  📋Plan  💻Build  🔀PR  ✅Archive
+  ✅ CLI    🔒 AI      🔒 AI      🔒 AI     🔒 AI    🔒 AI    🔒 AI  🔒 AI
 ```
 ## 🚀 5 Minutes to First Task
 ```bash
+# CLI usage (direct terminal commands)
 npm install -g speccore
 speccore init
-speccore doc2spec -f requirements.docx --iter=Q1   # Import PRD
-speccore analyze -I Q1                          # AI analysis + code health
-speccore iteration split -I Q1                  # Split into tasks
-speccore plan -I Q1                             # Generate plan
-speccore execute -t Task-001                    # AI-powered development
-speccore done --task=Task-001                       # Validate → archive
+speccore iteration create -n Q1     # Create iteration
+# 🔒 AI usage (in WorkBuddy/Cursor/Trae via @spec-ask)
+@spec-ask "import requirements.docx to Q1 iteration"
+@spec-ask "analyze Q1 requirements and code health"
+@spec-ask "split Q1 iteration into tasks"
+@spec-ask "generate execution plan for Q1"
+@spec-ask "execute Task-001 with AI"
+@spec-ask "archive Task-001 after validation"
 ```
 ## 🎯 What do you want to do?
@@ -27,17 +32,17 @@ speccore done --task=Task-001                       # Validate → archive
 | I want to... | Command |
 |:---|:---|
 | **Start a new project** | `speccore init --interactive` |
-| **Import a PRD document** | `speccore doc2spec -f PRD.docx -I Q1` |
-| **Analyze requirements + code health** | `speccore analyze -I Q1` |
+| **Import a PRD document** | `@spec-ask "import PRD.docx to Q1"` 🔒 |
+| **Analyze requirements + code health** | `@spec-ask "analyze Q1 requirements"` 🔒 |
 | **Split requirements into tasks** | `speccore iteration split -I Q1 --interactive` |
 | **Fix a bug** | `speccore task new -n "Login timeout" --type=bugfix` |
 | **Batch fix bugs** | `speccore task new --batch-file=bugs.xlsx --type=bugfix` |
 | **Schedule overnight execution** | `speccore schedule create --at "02:00" --all -I Q1` |
-| **AI auto-development** | `speccore execute -t Task-001` |
-| **Create a Pull Request** | `speccore pr --task=Task-001 --interactive` |
-| **Archive a completed task** | `speccore done --task=Task-001 --interactive` |
-| **Check project status** | `speccore` or `speccore status-panel` |
-| **Natural language queries** | `speccore ask "analyze current requirements"` |
+| **AI auto-development** | `@spec-ask "execute Task-001"` 🔒 |
+| **Create a Pull Request** | `@spec-ask "create PR for Task-001"` 🔒 |
+| **Archive a completed task** | `@spec-ask "archive Task-001"` 🔒 |
+| **Check project status** | `speccore` or `speccore dashboard` |
+| **Natural language queries** | `@spec-ask "analyze current requirements"` 🔒 |
 > 📋 Full command reference → [Command Reference](docs/commands.en.md) | 中文文档 → [README.zh.md](README.md)
@@ -53,9 +58,9 @@ speccore done --task=Task-001                       # Validate → archive
 ```bash
 speccore task new -n "Data migration" --schedule=night         # Queue for night
-speccore execute --all --scheduled                              # Run all queued
 speccore schedule create --at "2026-08-10 02:00" --all -I Q1   # Exact time
-speccore schedule daemon start                                   # Auto-execute on schedule
+speccore schedule daemon start                                  # Auto-execute on schedule
+# 🔒 AI: @spec-ask "run all scheduled tasks"
 ```
 ## 📚 Documentation

package/README.md CHANGED Viewed

@@ -3,7 +3,7 @@
 🖥️ 规范驱动开发 CLI · 23 简洁命令（59 全量）· 人机协同闭环 · 多层 AI 架构
 ```bash
-speccore ask "我想做一个登录功能，计划晚8点分批执行"
+@spec-ask "我想做一个登录功能，计划晚8点分批执行"
 ```
 ---
@@ -11,7 +11,7 @@ speccore ask "我想做一个登录功能，计划晚8点分批执行"
 ## 架构概览
 ```
-speccore ask ←── AI 万能入口 ──→ speccore dev (智能级联)
+@spec-ask "..."  ← AI 入口 →  @spec-ask "全自动执行"
     │                                     │
     ├─ 📖 命令解释 "dashboard 怎么用"      ├─ 🏗️ 初始化
     ├─ 🗺️ 任务指引 "我想做登录"           ├─ 📝 导入需求
@@ -30,13 +30,16 @@ speccore ask ←── AI 万能入口 ──→ speccore dev (智能级联)
 ```bash
 npm install -g speccore
-speccore init                    # 初始化项目
-speccore welcome                 # 查看项目名片
-speccore ask "查看进度"          # AI 万能入口
-speccore dev --auto              # 智能级联一键推进
+speccore init                               # 初始化项目
+speccore iteration create -n Q1 --topic my-project --owner luzhaosheng  # 创建迭代
+speccore task new -n "用户登录" --topic user-login -i my-project         # 创建任务
+speccore context --set --iteration Iteration-001-my-project              # 切换上下文
+speccore dashboard                                                        # 查看仪表盘
 ```
-## 核心流水线
+> 💡 **AI 命令**（在 WorkBuddy/Trae/Qcoder 中通过 `@spec-ask` 或 `/spec-ask` 使用）：分析需求、制定计划、执行开发。详见 [AGENTS.md](./AGENTS.md)。
+## 核心流水线 🔒 AI 命令
 ```
 init → doc2spec → analyze → split → plan → execute → pr → done → spec2doc
@@ -48,11 +51,13 @@ init → doc2spec → analyze → split → plan → execute → pr → done →
 | 分类 | 命令 |
 |------|------|
-| 入口 | `ask` `welcome` `init` `help` |
-| 流水线 | `doc2spec` `analyze` `split` `plan` `execute` `pr` `done` `spec2doc` |
-| 智能 | `dev` |
-| 管理 | `iteration` `task` `change` `task-create` `iteration-create` |
-| 查看 | `dashboard` `search` `validate` `retro` `ops` |
+| CLI 入口 | `init` `welcome` `help` |
+| CLI 管理 | `iteration` `task` `context` ✅ |
+| CLI 查看 | `dashboard` `validate` `about` `config` `archive` |
+| 🔒 AI 入口 | `ask` |
+| 🔒 AI 流水线 | `doc2spec` `analyze` `split` `plan` `execute` `pr` `done` `spec2doc` |
+| 🔒 AI 智能 | `dev` |
+| 🔒 AI 变更 | `change` `retro` |
 ## 目录结构（全英文）
@@ -74,28 +79,31 @@ Iteration-001-meeting/
 │   └── Task-001-*/              ← 含 .issues.md .needs-retry
 ```
-## 断点重试
+## 断点重试 🔒 AI 命令
 ```bash
-speccore execute --all          # 全量执行
+# 在 AI IDE 中通过 @spec-ask 使用：
+@spec-ask "全量执行"           # 全量执行
 # 部分任务失败 → 写入 .issues.md + .needs-retry
-speccore execute --resume       # 扫描 .needs-retry 续跑
+@spec-ask "断点续传"           # 扫描 .needs-retry 续跑
 ```
-## 批量回顾
+## 批量回顾 🔒 AI 命令
 ```bash
-speccore retro --all                     # 所有任务
-speccore retro --all --owner 张三         # 按人
-speccore retro --all --type bugfix        # 按类型
+# 在 AI IDE 中通过 @spec-ask 使用：
+@spec-ask "生成所有任务的回顾"
+@spec-ask "生成张三的所有任务回顾"
+@spec-ask "生成所有 bugfix 类型任务的回顾"
 ```
-### 🧠 ask — AI 万能入口
-4 种模式自动识别，无需记忆命令：
-- **📖 命令解释**：`speccore ask "dashboard 怎么用"`
-- **🗺️ 任务指引**：`speccore ask "我想做一个支付功能"` → 8 步全流程
-- **🎯 意图匹配**：`speccore ask "查看进度"` → 自动匹配 dashboard
-- **⚡ 复杂编排**：`speccore ask "计划任务，晚8点分批执行"` → plan→schedule→execute
+### 🧠 AI 语义入口
+在 AI IDE 中使用 `@spec-ask` 或 `/spec-ask`，无需记忆命令：
+- **📖 命令解释**：`@spec-ask "dashboard 怎么用"`
+- **🗺️ 任务指引**：`@spec-ask "我想做一个支付功能"` → AI 自动编排全流程
+- **🎯 意图匹配**：`@spec-ask "查看进度"` → AI 自动匹配 dashboard
+- **⚡ 复杂编排**：`@spec-ask "分析+计划自动，执行前确认"` → analyze→plan 连续跑
 ### 📊 dashboard — 全局仪表盘
 `speccore dashboard --scope global` 生成 Jira 标准 7 维度 HTML 看板：
@@ -104,9 +112,9 @@ speccore retro --all --type bugfix        # 按类型
 - 9 套主题、中英文切换、字体/字号调节、F 键全屏、四边脉冲扫描线
 ### 🔄 dev — 智能级联
-自动检测项目阶段，一键推进：`speccore dev --auto`
+在 AI IDE 中智能推进：`@spec-ask "全自动执行"`
-### 🚀 全量流水线
+### 🚀 全量流水线 🔒 AI 命令（在 IDE 中使用）
 | 阶段 | 命令 | AI 模式 |
 |------|------|------|
 | 导入需求 | `doc2spec -f PRD.docx` | 📖 命令解释 |
@@ -128,26 +136,26 @@ speccore --version   # v5.27.0
 | 命令 | 别名 | 功能 |
 |------|------|------|
-| `ask` | — | 🧠 万能 AI 入口（4 模式） |
+| `ask` | — | 🧠 🔒 万能 AI 入口（4 模式） |
 | `welcome` | — | 🏷️ 项目名片 + 使用引导 |
 | `dashboard` | `db` | 📊 期次/全局仪表盘 |
-| `dev` | `d` | 🔄 智能级联流水线 |
+| `dev` | `d` | 🔄 🔒 智能级联流水线 |
 | `init` | `in` | 🏗️ 项目初始化 |
-| `doc2spec` | `d2s` | 📝 PRD→SpecCore MD |
-| `spec2doc` | `s2d` | 📤 SpecCore MD→Word/PDF/HTML |
-| `analyze` | `al` | 🧠 AI 需求分析 |
-| `split` | — | 📦 需求拆分 |
-| `plan` | `pl` | 📐 执行计划 |
-| `execute` | `ex` | ⚡ 执行开发 |
-| `pr` | `mr` | 🔀 Pull Request |
-| `done` | `dn` | ✅ 归档收尾 |
-| `change` | `ch` | 🔄 需求变更 |
-| `sync` | `sy` | 🔄 双向同步 |
+| `doc2spec` | `d2s` | 📝 🔒 PRD→SpecCore MD |
+| `spec2doc` | `s2d` | 📤 🔒 SpecCore MD→Word/PDF/HTML |
+| `analyze` | `al` | 🧠 🔒 AI 需求分析 |
+| `split` | — | 📦 🔒 需求拆分 |
+| `plan` | `pl` | 📐 🔒 执行计划 |
+| `execute` | `ex` | ⚡ 🔒 执行开发 |
+| `pr` | `mr` | 🔀 🔒 Pull Request |
+| `done` | `dn` | ✅ 🔒 归档收尾 |
+| `change` | `ch` | 🔄 🔒 需求变更 |
+| `sync` | `sy` | 🔄 🔒 双向同步 |
 | `validate` | `vl` | ✅ 合规验证 |
-| `track` | `trk` | 🔗 REQ→Task→Code 全链路 |
+| `track` | `trk` | 🔗 🔒 REQ→Task→Code 全链路 |
 | `search` | `sh` | 🔍 跨 Spec 全文搜索 |
-| `retro` | `rt` | 📝 任务回顾复盘 + 评分 |
-| `rename` | `rn` | ✏️ 重命名 |
+| `retro` | `rt` | 📝 🔒 任务回顾复盘 + 评分 |
+| `rename` | `rn` | ✏️ 🔒 重命名 |
 | `ops` | `op` | 📜 操作历史 |
 ## TTY 智能适配
@@ -159,7 +167,7 @@ speccore --version   # v5.27.0
 ## 🤖 三层 AI 架构
 ```
-speccore ask "..." / speccore dev
+@spec-ask "..."  (AI IDE 入口)
   ├─ 🧠 自有 LLM   → OpenAI / Ollama（SPECCORE_LLM_KEY 环境变量）
   ├─ 🤖 宿主 AI    → WorkBuddy / TRAE / Qoder（自动检测）
   └─ 📐 规则引擎   → 18 条命令 KB + 4 预定义工作流（永远可用）

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "5.67.60",
+  "version": "5.67.62",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",