docs(*): 用户文档全面优化——安装路径修正 + 双语完善 + 信息架构改进

Test User · claude · Test User · commit e8ce17dfa954 · 2026-02-25T18:24:12.000+08:00
- README: 前置条件明示 + 源码安装为主 + plugin install 降级为备选
- README: 动态版本 badge + 语言切换首行 + 重复标题修正
- README: 新增"What devpace is NOT"段 + 问题排查链接 + 中文文档标注
- CHANGELOG: 双语头部 + 英文版本摘要导航表
- Walkthrough: 新增前置条件段 + 具体路径示例
- CONTRIBUTING: git clone 占位符替换为实际 URL
- marketplace.json: description 去除 BizDevOps 术语，与 plugin.json 对齐
- CODE_OF_CONDUCT: 执行联系从公开 Issues 改为私密渠道
- Bug Report 模板: 新增 Claude 输出段
- GitHub Discussions 已启用

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -1,6 +1,6 @@
 {
   "name": "devpace",
-  "description": "BizDevOps development pace manager for Claude Code — structured workflow from business goals to code changes with cross-session continuity, quality gates, and change management",
+  "description": "AI-native development pace manager for Claude Code — change impact analysis, quality gates, goal-to-code traceability, and cross-session continuity",
   "owner": {
     "name": "paceforge"
   },
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -23,6 +23,14 @@ labels: bug
 
 <!-- What actually happened / 实际发生了什么 -->
 
+## Claude Output / Claude 输出
+
+<!-- Paste the relevant Claude output or error message / 粘贴相关的 Claude 输出或错误信息 -->
+
+```
+(paste here)
+```
+
 ## Environment / 环境信息
 
 - OS:
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,8 +1,27 @@
 # Changelog
 
-本文件记录 devpace 的所有重要变更。
-
-格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)。
+All notable changes to devpace are documented here. For English release summaries, see [GitHub Releases](https://github.com/arch-team/devpace/releases).
+
+本文件记录 devpace 的所有重要变更。格式基于 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)。
+
+## Version Overview
+
+| Version | Date | Highlights |
+|---------|------|-----------|
+| [1.4.0](#140---2026-02-25) | 2026-02-25 | Risk Fabric — pre-flight risk scan + runtime monitoring + graduated response |
+| [1.3.0](#130---2026-02-24) | 2026-02-24 | DORA proxy metrics + cross-project insights + CI/CD auto-detection |
+| [1.2.0](#120---2026-02-24) | 2026-02-24 | Test management (/pace-test) + global navigation (/pace-next) |
+| [1.1.0](#110---2026-02-22) | 2026-02-22 | Release orchestration — changelog, version bump, git tag, GitHub Release |
+| [1.0.0](#100---2026-02-22) | 2026-02-22 | Stable release — 26 scenarios, 48 features, 148 static tests |
+| [0.9.1](#091---2026-02-22) | 2026-02-22 | Skill description CSO audit + migration path fix |
+| [0.9.0](#090---2026-02-22) | 2026-02-22 | BMAD-METHOD deep study — adversarial review, complexity-adaptive paths |
+| [0.8.0](#080---2026-02-22) | 2026-02-22 | ECC deep study — cross-platform hooks, smart checks, model tiering |
+| [0.7.0](#070---2026-02-22) | 2026-02-22 | Open-source ecology study — state machine, execution quality, review quality |
+| [0.6.0](#060---2026-02-22) | 2026-02-22 | Linear AI study — source tracing, progressive autonomy, correction-as-learning |
+| [0.5.0](#050---2026-02-21) | 2026-02-21 | Progressive teaching, value visibility, friction reduction |
+| [0.4.0](#040---2026-02-21) | 2026-02-21 | UX optimization — gradual init, advance mode opt-in, throttling |
+| [0.3.0](#030---2026-02-21) | 2026-02-21 | Full BizDevOps lifecycle — release, feedback, roles, DORA metrics |
+| [0.1.0](#010---2026-02-20) | 2026-02-20 | Initial public release |
 
 ## [Unreleased]
 
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
@@ -61,8 +61,9 @@ representative at an online or offline event.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-**GitHub Issues at https://github.com/arch-team/devpace/issues**.
+reported to the community leaders responsible for enforcement via
+[GitHub Private Vulnerability Reporting](https://github.com/arch-team/devpace/security/advisories/new)
+or by emailing **devpace-conduct@proton.me**.
 
 All complaints will be reviewed and investigated promptly and fairly.
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -38,7 +38,7 @@ Thank you for your interest in contributing to devpace! This guide covers everyt
 
 ```bash
 # Clone the repository
-git clone <repo-url>
+git clone https://github.com/arch-team/devpace.git
 cd devpace
 
 # Install test dependencies
diff --git a/CONTRIBUTING_zh.md b/CONTRIBUTING_zh.md
@@ -38,7 +38,7 @@
 
 ```bash
 # 克隆仓库
-git clone <repo-url>
+git clone https://github.com/arch-team/devpace.git
 cd devpace
 
 # 安装测试依赖
diff --git a/README.md b/README.md
@@ -1,10 +1,10 @@
+🌐 [中文版](README_zh.md) | English
+
 # devpace
 
 Give your Claude Code projects a steady development pace — requirements change, rhythm stays.
 
-![version](https://img.shields.io/badge/version-1.4.0-blue) ![license](https://img.shields.io/badge/license-MIT-green) ![type](https://img.shields.io/badge/Claude%20Code-Plugin-purple)
-
-🌐 [中文版](README_zh.md) | English
+![version](https://img.shields.io/github/v/release/arch-team/devpace?label=version) ![license](https://img.shields.io/badge/license-MIT-green) ![type](https://img.shields.io/badge/Claude%20Code-Plugin-purple)
 
 ## Why devpace
 
@@ -17,7 +17,7 @@ When using Claude Code for product development:
 | Work drifts from goals | Technical work disconnects from business goals, lots done but unclear value | Goal-to-code traceability at all times |
 | Re-explain everything each session | Manual approach needs **8** user corrections (3 interruption test) | Auto-restores context, **0** corrections |
 
-→ [See full walkthrough: from init to done](examples/todo-app-walkthrough.md)
+> [See full walkthrough: from init to done](examples/todo-app-walkthrough.md)
 
 ## 30-Second Experience
 
@@ -43,22 +43,27 @@ All state is stored in `.devpace/` folder at project root, pure Markdown, human-
 
 ## Installation
 
-### Quick Install
+> **Prerequisite**: [Claude Code CLI](https://claude.ai/code) must be installed.
+
+### From Source (Recommended)
 
 ```bash
-/plugin install devpace
+git clone https://github.com/arch-team/devpace.git
+claude --plugin-dir /path/to/devpace
 ```
 
-### Verify Installation
-
-Run `/pace-theory` in Claude Code to confirm the plugin is loaded.
-
-### Manual Install
+### Plugin Registry
 
 ```bash
-claude --plugin-dir /path/to/devpace
+/plugin install devpace
 ```
 
+> If `/plugin install` is not available yet, use the "From Source" method above.
+
+### Verify Installation
+
+After installing, type `/pace-` in Claude Code. If devpace is loaded, you'll see auto-complete suggestions for `/pace-init`, `/pace-dev`, `/pace-status`, etc.
+
 ## Commands
 
 ### Daily Use
@@ -122,7 +127,7 @@ Most of the time you don't need commands — saying "help me implement X" equals
 | Risk fabric | Pre-flight 5-dimension risk scan + Runtime monitoring + Graduated autonomous response (High requires human confirmation) |
 | Cross-project insights | High-confidence insights exportable/importable to other projects, reducing redundant learning |
 
-## How It Works
+## Workflow
 
 ### Two Modes
 
@@ -151,13 +156,19 @@ Pause anytime, resume from where you left off
 | Byproducts not prerequisites | Structured data is auto-produced from work, not a required input |
 | Interruption tolerance | Interrupt at any point, seamless resume next time |
 
+## What devpace is NOT
+
+- **Not a CI/CD pipeline** — it works alongside your existing tools (GitHub Actions, Jenkins, etc.)
+- **Not a project management platform** — no web dashboard, no team features, pure CLI
+- **Not a replacement for git** — it creates Markdown state files in `.devpace/`, your code stays in git
+
 ## Learn More
 
-- [User Guide](docs/user-guide.md) — Full command reference, modes, state machine details
-- [Walkthrough](examples/todo-app-walkthrough.md) — Complete example from init to finish
-- [Contributing (English)](CONTRIBUTING.md) — Dev environment, testing, PR process
-- [Contributing (中文)](CONTRIBUTING_zh.md) — 开发环境、测试、PR 规范
-- [Changelog](CHANGELOG.md) — Version history
+- [User Guide](docs/user-guide.md) (Chinese) — Full command reference, modes, state machine details
+- [Walkthrough](examples/todo-app-walkthrough.md) (Chinese) — Complete example from init to finish
+- [Contributing](CONTRIBUTING.md) — Dev environment, testing, PR process
+- [Changelog](CHANGELOG.md) — Version history ([English summaries on GitHub Releases](https://github.com/arch-team/devpace/releases))
+- [Troubleshooting](https://github.com/arch-team/devpace/issues?q=label%3Abug) — Search known issues or open a new one
 
 ---
 MIT
diff --git a/README_zh.md b/README_zh.md
@@ -4,7 +4,7 @@
 
 给 Claude Code 项目一个稳定的研发节奏——需求在变，节奏不乱。
 
-![version](https://img.shields.io/badge/version-1.4.0-blue) ![license](https://img.shields.io/badge/license-MIT-green) ![type](https://img.shields.io/badge/Claude%20Code-Plugin-purple)
+![version](https://img.shields.io/github/v/release/arch-team/devpace?label=version) ![license](https://img.shields.io/badge/license-MIT-green) ![type](https://img.shields.io/badge/Claude%20Code-Plugin-purple)
 
 ## 为什么需要 devpace
 
@@ -43,22 +43,27 @@ devpace 是一个 Claude Code Plugin，通过三种机制扩展 Claude 的能力
 
 ## 安装
 
-### 快速安装
+> **前置条件**：需先安装 [Claude Code CLI](https://claude.ai/code)。
+
+### 从源码安装（推荐）
 
 ```bash
-/plugin install devpace
+git clone https://github.com/arch-team/devpace.git
+claude --plugin-dir /path/to/devpace
 ```
 
-### 验证安装
-
-安装后在 Claude Code 中运行 `/pace-theory`，确认插件已加载。
-
-### 手动安装
+### 插件注册表
 
 ```bash
-claude --plugin-dir /path/to/devpace
+/plugin install devpace
 ```
 
+> 如果 `/plugin install` 尚不可用，请使用上方"从源码安装"方式。
+
+### 验证安装
+
+安装后在 Claude Code 中输入 `/pace-`，如果 devpace 加载成功，会看到 `/pace-init`、`/pace-dev`、`/pace-status` 等自动补全建议。
+
 ## 命令
 
 ### 日常使用
@@ -122,7 +127,7 @@ claude --plugin-dir /path/to/devpace
 | <nobr>风险织网</nobr> | Pre-flight 5 维风险扫描 + Runtime 实时监控 + 分级自主响应（High 必须人类确认） |
 | <nobr>跨项目经验</nobr> | 高置信度经验可导出/导入到其他项目，减少重复学习 |
 
-## 工作方式
+## 工作流程
 
 ### 两种模式
 
@@ -151,12 +156,19 @@ claude --plugin-dir /path/to/devpace
 | <nobr>副产物非前置</nobr> | 结构化数据是工作的自动产出，不是前置要求 |
 | <nobr>中断容错</nobr> | 任意时刻中断，下次无缝恢复 |
 
+## devpace 不是什么
+
+- **不是 CI/CD 流水线** —— 它与你现有的工具（GitHub Actions、Jenkins 等）并行工作
+- **不是项目管理平台** —— 没有 Web 界面、没有团队功能，纯 CLI
+- **不是 git 的替代品** —— 它在 `.devpace/` 中创建 Markdown 状态文件，你的代码仍在 git 中管理
+
 ## 了解更多
 
 - [用户指南](docs/user-guide.md) — 完整命令参考、工作模式、状态机细节
 - [端到端演示](examples/todo-app-walkthrough.md) — 从初始化到完成的完整示例
 - [贡献指南](CONTRIBUTING_zh.md) — 开发环境、测试、PR 规范
-- [更新日志](CHANGELOG.md) — 版本历史
+- [更新日志](CHANGELOG.md) — 版本历史（[英文摘要见 GitHub Releases](https://github.com/arch-team/devpace/releases)）
+- [问题排查](https://github.com/arch-team/devpace/issues?q=label%3Abug) — 搜索已知问题或提交新 Issue
 
 ---
 MIT
diff --git a/examples/todo-app-walkthrough.md b/examples/todo-app-walkthrough.md
@@ -2,12 +2,17 @@
 
 本演示展示 devpace 管理一个完整的开发周期——从项目初始化到任务合并，包括一次中途需求变更。
 
+## 前置条件 / Prerequisites
+
+- 已安装 [Claude Code CLI](https://claude.ai/code)
+- 已获取 devpace：`git clone https://github.com/arch-team/devpace.git`
+
 ## 准备
 
 ```bash
 # 在你的项目目录中加载 devpace 插件
 cd ~/projects/my-todo-app
-claude --plugin-dir /path/to/devpace
+claude --plugin-dir ~/devpace    # 替换为你克隆 devpace 的实际路径
 ```
 
 ## 阶段 1：初始化

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "devpace",`
`3`		`- "description": "BizDevOps development pace manager for Claude Code — structured workflow from business goals to code changes with cross-session continuity, quality gates, and change management",`
	`3`	`+ "description": "AI-native development pace manager for Claude Code — change impact analysis, quality gates, goal-to-code traceability, and cross-session continuity",`
`4`	`4`	`"owner": {`
`5`	`5`	`"name": "paceforge"`
`6`	`6`	`},`