dev-playbooks-cn 2.1.1 → 2.2.1

package/CHANGELOG.md

@@ -0,0 +1,219 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.2.1] - 2025-01-20
+
+### 修复
+- 修复 update 命令的 changelog 显示功能
+  - 添加完整的版本变更记录
+  - 将 CHANGELOG.md 添加到 npm 发布文件列表
+- 优化 update 命令性能
+  - 添加版本检查缓存（10 分钟 TTL）
+  - 避免重复网络请求导致的卡顿
+
+---
+
+## [2.2.0] - 2025-01-20
+
+### 新增
+- 添加 Every Code (`@just-every/code`) 支持
+  - 完整 Skills 系统支持
+  - Skills 安装目录：`~/.code/skills/` 或 `.code/skills/`（项目级）
+  - 使用 `AGENTS.md` 指令文件
+- 安装脚本新增 `--code-only` 和 `--with-code` 选项
+- 版本检查缓存（10 分钟 TTL）加速重复 `update` 命令
+
+### 变更
+- 更新 README 工具支持表格
+
+---
+
+## [2.1.1] - 2025-01-19
+
+### 修复
+- 规范用语修正
+
+---
+
+## [2.1.0] - 2025-01-19
+
+### Added
+
+- **Version Changelog Display**: When running `dev-playbooks-cn update`, the CLI now displays a formatted changelog summary showing all changes between the current version and the latest version
+  - ✅ Automatic fetch from GitHub: Retrieves CHANGELOG.md from the repository
+  - 📋 Smart parsing: Extracts and displays only relevant version changes
+  - 🎨 Colorized output: Highlights different types of changes (features, warnings, etc.)
+  - 🔗 Graceful fallback: Shows GitHub release link if network fails
+  - 📊 Content limit: Displays first 10 lines per version to avoid information overload
+
+### Improved
+
+- **User Experience**: Users can now make informed decisions about updates by reviewing what's new before upgrading
+
+---
+
+## [2.0.0] - 2026-01-19
+
+### Added
+
+#### 🎯 Human-Friendly Document Templates
+
+- **结论先行（Bottom Line Up Front）**: Every document (proposal, design, tasks, verification) now has a 30-second executive summary at the top
+  - ✅ What will result: List changes in plain language
+  - ❌ What won't result: Clearly state what won't change
+  - 📝 One-sentence summary: Understandable even for non-technical people
+
+- **需求对齐（Alignment Check）**: Proposal phase now includes guided questions to uncover hidden requirements
+  - 👤 Role identification: Quick Starter / Platform Builder / Rapid Validator
+  - 🎯 Core requirements: Explicit + hidden requirements
+  - 💡 Multi-perspective recommendations: Different recommendations based on different roles
+
+- **默认批准机制（Default Approval Mechanism）**: Reduce decision fatigue with auto-approval
+  - ⏰ User silence = agreement: Auto-approve after timeout
+  - 🎛️ Configurable timeout: proposal 48h / design 24h / tasks 24h / verification 12h
+  - 🔒 Retain control: Users can reject or customize at any time
+
+- **项目级文档（Project-Level Documents）**: Knowledge retention and decision tracking
+  - 📋 User Profile (project-profile.md): Record role, requirements, constraints, preferences
+  - 📝 Decision Log (decision-log.md): Record all important decisions for retrospection
+
+#### New Document Templates
+
+- `skills/_shared/references/文档模板-proposal.md` (Chinese)
+- `skills/_shared/references/文档模板-design.md` (Chinese)
+- `skills/_shared/references/文档模板-tasks.md` (Chinese)
+- `skills/_shared/references/文档模板-verification.md` (Chinese)
+- `skills/_shared/references/文档模板-project-profile.md` (Chinese)
+- `skills/_shared/references/文档模板-decision-log.md` (Chinese)
+- `skills/_shared/references/批准配置说明.md` (Chinese)
+- `skills/_shared/references/document-template-proposal.md` (English)
+- `skills/_shared/references/document-template-design.md` (English)
+- `skills/_shared/references/document-template-tasks.md` (English)
+- `skills/_shared/references/document-template-verification.md` (English)
+- `skills/_shared/references/document-template-project-profile.md` (English)
+- `skills/_shared/references/document-template-decision-log.md` (English)
+- `skills/_shared/references/approval-configuration-guide.md` (English)
+
+#### Documentation
+
+- Added `docs/v2.0.0-修改总结.md`: Comprehensive summary of v2.0.0 changes
+- Updated README.md with v2.0.0 features section (both Chinese and English versions)
+
+### Changed
+
+- **proposal-author skill**: Updated to use new document templates
+  - Now generates documents with "Bottom Line Up Front" section
+  - Includes "Alignment Check" to uncover hidden requirements
+  - Provides multi-perspective recommendations based on user role
+  - References new template files in prompts
+
+### Breaking Changes
+
+⚠️ **Document Structure Changes**
+
+- Existing proposal.md files do not conform to the new structure
+- Migration may be required for existing projects
+- Old format is still supported but not recommended
+
+**Mitigation**:
+- Migration script will be provided in future releases
+- Backward compatibility maintained for reading old format
+- New projects will use new format by default
+
+⚠️ **Approval Mechanism Changes**
+
+- Introduces default approval mechanism which may not fit all team workflows
+- Default strategy is `auto_approve` but can be changed to `require_explicit`
+
+**Mitigation**:
+- Configurable approval strategy in `.devbooks/config.yaml`
+- Can disable auto-approval for high-risk projects
+- Timeout values are configurable
+
+### Design Philosophy
+
+This release is inspired by:
+- Cognitive Load Theory: Minimize extraneous load, maximize germane load
+- Dual Process Theory: Design for both System 1 (fast) and System 2 (slow) thinking
+- Nudge Theory: Use default options to guide better decisions
+- Inverted Pyramid Structure: Put conclusions first, details later
+
+**Core Principles**:
+- 🎯 Assume users are non-technical: Use plain language, avoid jargon
+- 🤔 Uncover hidden requirements: Guide users through questions
+- ⏰ Reduce decision fatigue: Default approval with configurable timeout
+- 📋 Knowledge retention: Project-level documents for long-term reference
+
+### Upgrade Guide
+
+#### For Existing Projects
+
+1. Update npm package:
+   ```bash
+   npm install -g dev-playbooks-cn@2.0.0
+   # or
+   npm install -g dev-playbooks@2.0.0
+   ```
+
+2. (Optional) Migrate existing documents:
+   ```bash
+   # Migration script will be provided in future releases
+   devbooks migrate --from 1.x --to 2.0.0
+   ```
+
+3. (Optional) Configure approval mechanism:
+   Create `.devbooks/config.yaml`:
+   ```yaml
+   approval:
+     default_strategy: auto_approve
+     timeout:
+       proposal: 48
+       design: 24
+       tasks: 24
+       verification: 12
+   ```
+
+4. (Optional) Create project-level documents:
+   ```bash
+   devbooks init-profile
+   devbooks init-decision-log
+   ```
+
+#### For New Projects
+
+New projects will automatically use the new document templates. No migration needed.
+
+### References
+
+- Report: "Protocol 2026: Cognitive Compatibility and Human-Computer Communication Standards in the AI-Native Era"
+- Cognitive Load Theory (CLT)
+- Dual Process Theory
+- Nudge Theory
+- Inverted Pyramid Structure
+
+---
+
+## [1.7.4] - 2026-01-18
+
+### Changed
+- Various bug fixes and improvements
+
+---
+
+## [1.7.0] - 2026-01-15
+
+### Added
+- Initial release with 18 skills
+- Support for Claude Code, Codex CLI, and other AI tools
+- Quality gates and role isolation
+- MCP integration support
+
+---
+
+[2.0.0]: https://github.com/Darkbluelr/dev-playbooks-cn/compare/v1.7.4...v2.0.0
+[1.7.4]: https://github.com/Darkbluelr/dev-playbooks-cn/compare/v1.7.0...v1.7.4
+[1.7.0]: https://github.com/Darkbluelr/dev-playbooks-cn/releases/tag/v1.7.0

package/README.md

@@ -80,6 +80,7 @@ AI 编码助手很强大，但往往**不可预测**：
 | **Codex CLI** | 完整 Skills | `AGENTS.md` |
 | **Qoder** | 完整 Skills | `AGENTS.md` |
 | **OpenCode** | 完整 Skills | `AGENTS.md` |
+| **Every Code** | 完整 Skills | `AGENTS.md` |
 | **Cursor** | Rules 系统 | `.cursor/rules/` |
 | **Windsurf** | Rules 系统 | `.windsurf/rules/` |
 | **Gemini CLI** | Rules 系统 | `GEMINI.md` |

package/bin/devbooks.js

@@ -34,6 +34,10 @@ const __dirname = path.dirname(__filename);
 const CLI_COMMAND = 'dev-playbooks-cn';
 const XDG_CONFIG_HOME = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
 
+// 版本检查缓存配置
+const VERSION_CACHE_FILE = path.join(os.tmpdir(), `${CLI_COMMAND}-version-cache.json`);
+const VERSION_CACHE_TTL = 10 * 60 * 1000; // 10 分钟缓存
+
 // ============================================================================
 // Skills 支持级别定义
 // ============================================================================
@@ -172,6 +176,19 @@ const AI_TOOLS = [
     globalSlashDir: path.join(os.homedir(), '.codex', 'prompts'),
     instructionFile: 'AGENTS.md',
     available: true
+  },
+
+  // === Every Code / just-every/code（完整 Skills 支持）===
+  {
+    id: 'code',
+    name: 'Every Code',
+    description: 'Every Code CLI (@just-every/code)',
+    skillsSupport: SKILLS_SUPPORT.FULL,
+    slashDir: null,
+    skillsDir: path.join(os.homedir(), '.code', 'skills'),
+    globalSlashDir: null,
+    instructionFile: 'AGENTS.md',
+    available: true
   }
 ];
 
@@ -317,11 +334,32 @@ function getCliVersion() {
 }
 
 /**
- * 检查 npm 上是否有新版本
+ * 检查 npm 上是否有新版本（带缓存）
  * @returns {Promise<{hasUpdate: boolean, latestVersion: string|null, currentVersion: string}>}
  */
 async function checkNpmUpdate() {
   const currentVersion = getCliVersion();
+
+  // 检查缓存
+  try {
+    if (fs.existsSync(VERSION_CACHE_FILE)) {
+      const cache = JSON.parse(fs.readFileSync(VERSION_CACHE_FILE, 'utf-8'));
+      const cacheAge = Date.now() - cache.timestamp;
+
+      // 如果缓存未过期且当前版本匹配缓存的最新版本，跳过网络请求
+      if (cacheAge < VERSION_CACHE_TTL && cache.currentVersion === currentVersion) {
+        // 如果缓存显示已是最新版本，直接返回
+        if (!cache.hasUpdate) {
+          return { hasUpdate: false, latestVersion: cache.latestVersion, currentVersion };
+        }
+        // 如果缓存显示有更新，仍返回缓存结果
+        return { hasUpdate: cache.hasUpdate, latestVersion: cache.latestVersion, currentVersion };
+      }
+    }
+  } catch {
+    // 缓存读取失败，继续网络请求
+  }
+
   try {
     const { execSync } = await import('child_process');
     const latestVersion = execSync(`npm view ${CLI_COMMAND} version`, {
@@ -330,16 +368,29 @@ async function checkNpmUpdate() {
       stdio: ['pipe', 'pipe', 'pipe']
     }).trim();
 
+    let hasUpdate = false;
     if (latestVersion && latestVersion !== currentVersion) {
       // 简单版本比较（假设语义化版本）
       const current = currentVersion.split('.').map(Number);
       const latest = latestVersion.split('.').map(Number);
-      const hasUpdate = latest[0] > current[0] ||
+      hasUpdate = latest[0] > current[0] ||
         (latest[0] === current[0] && latest[1] > current[1]) ||
         (latest[0] === current[0] && latest[1] === current[1] && latest[2] > current[2]);
-      return { hasUpdate, latestVersion, currentVersion };
     }
-    return { hasUpdate: false, latestVersion, currentVersion };
+
+    // 保存缓存
+    try {
+      fs.writeFileSync(VERSION_CACHE_FILE, JSON.stringify({
+        timestamp: Date.now(),
+        currentVersion,
+        latestVersion,
+        hasUpdate
+      }));
+    } catch {
+      // 缓存写入失败，忽略
+    }
+
+    return { hasUpdate, latestVersion, currentVersion };
   } catch {
     // 网络错误或超时，静默忽略
     return { hasUpdate: false, latestVersion: null, currentVersion };
@@ -643,6 +694,8 @@ function getNpmIgnoreEntries() {
     '.opencode/',
     '.continue/',
     '.qoder/',
+    '.code/',
+    '.codex/',
     '.github/instructions/',
     '.github/copilot-instructions.md',
     '',
@@ -737,7 +790,7 @@ function printSkillsSupportInfo() {
   console.log(chalk.gray('─'.repeat(50)));
   console.log();
 
-  console.log(chalk.green('★ 完整 Skills') + chalk.gray(' - Claude Code, Codex CLI, OpenCode, Qoder'));
+  console.log(chalk.green('★ 完整 Skills') + chalk.gray(' - Claude Code, Codex CLI, OpenCode, Qoder, Every Code'));
   console.log(chalk.gray('   └ 独立的 Skills/Agents 系统，可按需调用，有独立上下文'));
   console.log();
 
@@ -857,6 +910,8 @@ function getSkillsDestDir(tool, scope, projectDir) {
       return path.join(projectDir, '.codex', 'skills');
     } else if (tool.id === 'opencode') {
       return path.join(projectDir, '.opencode', 'skill');
+    } else if (tool.id === 'code') {
+      return path.join(projectDir, '.code', 'skills');
     }
   }
   // 全局安装：使用工具定义的全局目录
@@ -870,8 +925,8 @@ function installSkills(toolIds, projectDir, scope = INSTALL_SCOPE.GLOBAL, update
     const tool = AI_TOOLS.find(t => t.id === toolId);
     if (!tool || tool.skillsSupport !== SKILLS_SUPPORT.FULL) continue;
 
-    // Claude Code / Codex CLI / OpenCode 支持相同格式的 Skills
-    if ((toolId === 'claude' || toolId === 'codex' || toolId === 'opencode') && tool.skillsDir) {
+    // Claude Code / Codex CLI / OpenCode / Every Code 支持相同格式的 Skills
+    if ((toolId === 'claude' || toolId === 'codex' || toolId === 'opencode' || toolId === 'code') && tool.skillsDir) {
       const skillsSrcDir = path.join(__dirname, '..', 'skills');
       const skillsDestDir = getSkillsDestDir(tool, scope, projectDir);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-playbooks-cn",
-  "version": "2.1.1",
+  "version": "2.2.1",
   "description": "AI-driven spec-based development workflow",
   "keywords": [
     "devbooks",
@@ -27,6 +27,7 @@
   },
   "files": [
     "LICENSE",
+    "CHANGELOG.md",
     "bin/",
     "templates/",
     "skills/",

package/scripts/install-skills.sh

@@ -4,12 +4,13 @@ set -euo pipefail
 usage() {
   cat <<'EOF'
 Usage:
-  ./scripts/install-skills.sh [--claude-only|--codex-only|--opencode-only] [--with-opencode] [--with-codex-prompts] [--dry-run] [--no-prune]
+  ./scripts/install-skills.sh [--claude-only|--codex-only|--opencode-only|--code-only] [--with-opencode] [--with-code] [--with-codex-prompts] [--dry-run] [--no-prune]
 
 Installs DevBooks skills (skills/devbooks-*) to:
   - Claude Code: ~/.claude/skills/
   - Codex CLI:   $CODEX_HOME/skills (default: ~/.codex/skills/)
   - OpenCode:    $XDG_CONFIG_HOME/opencode/skill (default: ~/.config/opencode/skill/)
+  - Every Code:  $CODE_HOME/skills (default: ~/.code/skills/)
 
 Optionally installs Codex prompt entrypoints (templates/claude-commands/devbooks/*.md) to:
   - Codex CLI:   $CODEX_HOME/prompts (default: ~/.codex/prompts/)
@@ -22,6 +23,7 @@ EOF
 install_claude=true
 install_codex=true
 install_opencode=false
+install_code=false
 install_codex_prompts=false
 dry_run=false
 prune_removed=true
@@ -29,10 +31,12 @@ prune_removed=true
 while [[ $# -gt 0 ]]; do
   case "$1" in
     -h|--help) usage; exit 0 ;;
-    --claude-only) install_codex=false ;;
-    --codex-only) install_claude=false ;;
-    --opencode-only) install_claude=false; install_codex=false; install_opencode=true ;;
+    --claude-only) install_codex=false; install_code=false ;;
+    --codex-only) install_claude=false; install_code=false ;;
+    --opencode-only) install_claude=false; install_codex=false; install_opencode=true; install_code=false ;;
+    --code-only) install_claude=false; install_codex=false; install_code=true ;;
     --with-opencode) install_opencode=true ;;
+    --with-code) install_code=true ;;
     --with-codex-prompts) install_codex_prompts=true ;;
     --dry-run) dry_run=true ;;
     --no-prune) prune_removed=false ;;
@@ -229,6 +233,11 @@ if [[ "$install_opencode" == true ]]; then
   install_into "${xdg_config_home}/opencode/skill"
 fi
 
+if [[ "$install_code" == true ]]; then
+  code_home="${CODE_HOME:-${HOME}/.code}"
+  install_into "${code_home}/skills"
+fi
+
 if [[ "$dry_run" == true ]]; then
   echo "[dry-run] done"
 else