feat: 增强文档系统与工作流的集成

[LouisHors]

概述

增强文档系统与当前工作流的结合程度，改进用户体验。

修改内容

using-horspowers 技能

• 新增 Document System Initialization Check 章节
• 配置创建/迁移/更新后自动检查文档系统状态
• 已启用但未初始化时：询问用户是否创建 docs/ 目录
• 未启用时：提示文档系统功能价值，询问是否启用
• 提供手动初始化的备选方案（/docs init）

document-management 技能

• 重构 Prerequisites 为 System Readiness Check
• 统一的检测流程：
  1. 检测 docs/ 目录存在性
  2. 检测配置文件启用状态
  3. 根据状态提供不同操作指引

用户体验

场景	行为
首次使用 horspowers	先配置开发模式，再询问文档系统
已有配置，未启用文档	提示功能价值，询问是否启用
已启用但未初始化	显示目录结构，询问是否创建
完全就绪	静默通过，不打扰用户

测试验证

• 技能文件格式验证通过
• 文档系统状态检测逻辑正常
• UnifiedDocsManager 目录创建功能正常

Summary by CodeRabbit

• New Features

  • Added unified document management system with docs, plans, and archive directories
  • Introduced configuration system (.horspowers-config.yaml) for project settings
  • New automated workflow commands: daily-workflow, quick-commit, merge-branch, sync-branch, and upgrade
  • Session-based document tracking and checkpoint functionality
  • Windows platform compatibility improvements for session hooks

• Documentation

  • Comprehensive installation guides and migration documentation
  • Chinese language support throughout the platform
  • New skill documentation for document management

• Chores

  • Project rebranding updates

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This comprehensive pull request rebrands the project from "superpowers" to "horspowers" while introducing substantial architectural enhancements: a new configuration management system, a unified document system with persistence and migration tooling, enhanced session hooks with documentation tracking, Windows CI testing infrastructure, new automation workflows, and extensive Chinese localization support across documentation and user interfaces.

Changes

Cohort / File(s)	Summary
Metadata & Branding .claude-plugin/marketplace.json, .claude-plugin/plugin.json, NOTICE, RELEASE-NOTES.md, README.md	Project rebranding from superpowers to horspowers; version bump to 4.3.2; owner/author metadata updates; Chinese-enhanced descriptions added; marketplace and plugin configuration aligned
Configuration System lib/config-manager.js, .horspowers-config.template.yaml, docs/archive/2026-01-21-task-config-file-system-improvements.md	New configuration manager module with YAML parsing, validation, migration from legacy configs, upward directory traversal; template-driven initialization; supports personal/team modes
Unified Documentation System lib/docs-core.js, docs/plans/2026-01-19-design-unified-document-system.md, docs/plans/2026-01-21-doc-system-unification-summary.md, docs/tasks/unified-document-system.md	New UnifiedDocsManager class providing document creation, lifecycle management (draft→active→archive), searching, statistics, migration planning/execution; index metadata tracking; templates for design/plan/task/bug documents
Session Hooks & Automation hooks/session-start.sh, hooks/session-end.sh, hooks/run-hook.cmd, hooks/hooks.json	Extended session-start hook with upgrade detection, config validation, documentation context building; new session-end hook for auto-archiving and metadata persistence; Windows bash discovery in run-hook.cmd; SessionEnd event support
Skills: Automated Development skills/automated-development-workflow/SKILL.md, commands/daily-workflow.md, commands/quick-commit.md, commands/merge-branch.md, commands/sync-branch.md	New skill for single-branch automation with quality checks, commit message generation, merge/sync workflows; config-driven behavior; conflict resolution strategies
Skills: Document Management skills/document-management/SKILL.md, commands/docs-*.md (docs-init, docs-migrate, docs-analyze, docs-search, docs-stats, docs-status)	New skill for document initialization, migration, analysis, and search; commands for unified document system operations
Skill Modifications skills/brainstorming/SKILL.md, skills/executing-plans/SKILL.md, skills/finishing-a-development-branch/SKILL.md, skills/dispatching-parallel-agents/SKILL.md, skills/receiving-code-review/SKILL.md	Enhanced with Chinese triggers; conditional documentation integration; config-driven decision flows; document context loading and checkpointing
Installation & Setup .codex/INSTALL.md, .opencode/INSTALL.md, .opencode/plugin/superpowers.js	Updated paths and references from superpowers to horspowers; new OpenCode plugin scaffold with tool implementations for skill discovery/execution; dynamic config directory handling
Version & Migration Tools lib/version-upgrade.js, scripts/migrate-docs.js, bin/upgrade, docs/migration-guide.md, docs/document-migration-guide.md	New version upgrader class detecting old document-driven-ai-workflow and orchestrating migration; doc migration script handling format conversions and link updates; upgrade command wrapper
Testing Infrastructure .github/workflows/test-windows-hooks.yml	New GitHub Actions workflow for comprehensive Windows hook testing with bash detection, JSON output validation, error-handling tests, cross-directory execution, macOS regression checks
Documentation & Planning CLAUDE.md, docs/active/2026-01-21-analysis-document-flow-gaps.md, multiple docs/archive/ and docs/plans/ files	Extensive design documents analyzing document flow gaps, task orchestrator architecture, test feature design, Windows CI testing; implementation task guides for features; user guides for unified document system
Configuration & Ignores .gitignore	New entries for .horspowers-config.yaml and .horspowers-version files

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant SessionStart as session-start.sh
    participant ConfigMgr as config-manager.js
    participant DocsCore as docs-core.js
    participant Skill as Using-Horspowers Skill

    User->>SessionStart: New session starts
    SessionStart->>ConfigMgr: Check config status
    ConfigMgr-->>SessionStart: Config state (needs-init/valid/outdated)
    SessionStart->>DocsCore: Load docs context if enabled
    DocsCore-->>SessionStart: Recent docs, active tasks, metadata
    SessionStart->>SessionStart: Build additionalContext with config+docs
    SessionStart-->>User: Pass context to Skill via JSON
    User->>Skill: Receives enriched context
    Skill-->>User: Config-driven workflow options

Loading

sequenceDiagram
    participant User
    participant Brainstorming as brainstorming Skill
    participant DocsCore as UnifiedDocsManager
    participant GitOps as Git/Filesystem
    participant PlanSkill as writing-plans Skill

    User->>Brainstorming: Refine project idea
    alt docs enabled
        Brainstorming->>DocsCore: Has important decisions?
        alt Yes - Create Design Doc
            DocsCore->>GitOps: Write YYYY-MM-DD-design-topic.md
            GitOps-->>DocsCore: File created + indexed
            Brainstorming-->>User: Design saved, proceed to planning
        else No Important Decisions
            Brainstorming-->>User: Skip design, proceed directly to planning
        end
    else docs disabled
        Brainstorming-->>User: Use original fallback workflow
    end
    User->>PlanSkill: Create implementation plan
    PlanSkill->>DocsCore: Create plan + task documents

Loading

sequenceDiagram
    participant CLI as User/bin/upgrade
    participant VersionUpgrader as version-upgrade.js
    participant ConfigMgr as config-manager.js
    participant MigrationMgr as migrate-docs.js
    participant DocsCore as docs-core.js
    participant FileSystem as Filesystem

    CLI->>VersionUpgrader: run()
    VersionUpgrader->>VersionUpgrader: Check current version
    VersionUpgrader->>FileSystem: Detect old document-driven-ai-workflow/
    alt DDAW exists
        VersionUpgrader-->>CLI: Prompt: Remove old DDAW?
        alt User confirms
            VersionUpgrader->>FileSystem: Backup to .horspowers-trash
            VersionUpgrader->>MigrationMgr: Generate migration plan
            MigrationMgr-->>VersionUpgrader: Plan with renames/merges
            VersionUpgrader->>DocsCore: Execute migration
            DocsCore->>FileSystem: Move/reorganize docs
            VersionUpgrader->>FileSystem: Write .horspowers-version marker
        end
    else No old DDAW
        VersionUpgrader->>FileSystem: Write .horspowers-version marker
    end
    VersionUpgrader-->>CLI: Success/completion

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related PRs

• Add personal superpowers overlay system #2: Modifies SessionStart hook and personal skills discovery setup, adjusting skill resolution and discovery paths similarly to this PR's config-driven approach.
• Add Windows support for plugin hooks #134: Shares modifications to hook infrastructure (run-hook.cmd, session-start.sh, hooks.json) for Windows/polyglot compatibility and cross-platform hook execution.
• fix: respect OPENCODE_CONFIG_DIR for personal skills lookup #297: Overlaps in .opencode/plugin modifications for dynamic config directory handling and skill path resolution using environment variables.

Poem

🐰 Hoppy times in Horspowers land,
With docs unified, all carefully planned,
Config flows smoothly, hooks catch the night,
From brainstorms to PRs, each skill shines bright!
中文、自动化、文档如诗,
🎉 Horspowers 4.3.2 — welcome, my friend!

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[LouisHors]

commit pr to a wrong place by agent, sry for that