goodvibes-codebase-review

Name: goodvibes-codebase-review
Author: mgd34msu

github.com/mgd34msu测试与质量637 次安装9 周前更新

代码仓库

关于 goodvibes-codebase-review

面向 Goodvives agents 的代码库审查与修复技能，涵盖分析、报告、计划和并行修复，并规定工具使用与文件修改边界。

主要功能

01结构化代码质量与安全审查
02架构与依赖分析
03生成审查和修复报告
04并行 Agent 修复与检查流程
05限定可追踪的文件修改

适用场景

01检查仓库中的代码与安全问题
02制定按优先级排序的修复计划
03协调并验证并行代码修复

MCP 相关

该技能要求 Agent 使用 Goodvibes MCP 工具进行代码分析、问题检测和编辑验证。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mgd34msu/goodvibes-plugin --skill goodvibes-codebase-review

安装后在 Claude Code 中输入/goodvibes-codebase-review确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/

review-checklist.md

tool-priority.md

scripts/

orchestrator.py

详细介绍

Goodvibes 代码库审查与修复

使用 goodvibes Agent 并行开展系统性代码库分析与修复。

重要：务必客观、完全诚实。绝不粉饰。

诚实审查：诚实的审查会带来更好的结果。评估时绝不考虑情绪或感受。

文件系统边界

重要：本地写入，全局读取。

写入/编辑/创建：仅限当前工作目录及其子目录。这是项目根目录。所有更改都必须可由 git 跟踪。
读取：可读取任何位置的文件以获取上下文（node_modules、全局配置、其他项目以供参考等）。
绝不写入：父目录、主目录、系统文件、其他项目以及项目根目录以外的任何位置。

启动时所在的工作目录就是项目根目录。所有修改都必须留在该目录中。

MCP 工具检查清单（必需）

停下。在做任何事情之前，先完成此检查清单。

**重要前提：**在调用任何 mcp-cli call <server>/<tool> 之前，必须先调用 mcp-cli info <server>/<tool>。这是一项强制要求。

任务开始

# ALWAYS check schema first
mcp-cli info plugin_goodvibes_analysis-engine/detect_stack
mcp-cli info plugin_goodvibes_registry-engine/recommend_skills
mcp-cli info plugin_goodvibes_project-engine/project_issues

# Then make the calls
mcp-cli call plugin_goodvibes_analysis-engine/detect_stack '{}'
mcp-cli call plugin_goodvibes_registry-engine/recommend_skills '{"task":"codebase review quality audit"}'
mcp-cli call plugin_goodvibes_project-engine/project_issues '{}'

审查阶段

# Check schemas first
mcp-cli info plugin_goodvibes_analysis-engine/find_circular_deps
mcp-cli info plugin_goodvibes_analysis-engine/scan_for_secrets
mcp-cli info plugin_goodvibes_project-engine/analyze_dependencies
mcp-cli info plugin_goodvibes_analysis-engine/find_dead_code
mcp-cli info plugin_goodvibes_project-engine/get_test_coverage

# Then execute
mcp-cli call plugin_goodvibes_analysis-engine/find_circular_deps '{}'
mcp-cli call plugin_goodvibes_analysis-engine/scan_for_secrets '{}'
mcp-cli call plugin_goodvibes_project-engine/analyze_dependencies '{}'
mcp-cli call plugin_goodvibes_analysis-engine/find_dead_code '{}'
mcp-cli call plugin_goodvibes_project-engine/get_test_coverage '{}'

每次编辑之前

# Check schemas
mcp-cli info plugin_goodvibes_analysis-engine/scan_patterns
mcp-cli info plugin_goodvibes_project-engine/find_tests_for_file
mcp-cli info plugin_goodvibes_analysis-engine/validate_edits_preview

# Execute
mcp-cli call plugin_goodvibes_analysis-engine/scan_patterns '{}'
mcp-cli call plugin_goodvibes_project-engine/find_tests_for_file '{"file":"path/to/file.ts"}'
mcp-cli call plugin_goodvibes_analysis-engine/validate_edits_preview '{}'

每次编辑之后

# Check schema
mcp-cli info plugin_goodvibes_project-engine/project_issues

# Execute
mcp-cli call plugin_goodvibes_project-engine/project_issues '{}'

铁律：只要 goodvibes MCP 工具能做到，就必须使用该工具。没有例外。

精准工具（必需）

重要：使用精准工具，而不是系统工具。

不要使用	请使用	原因
`Read`	`precision_read`	提取模式、行范围、概要/符号
`Grep`	`precision_grep`	输出模式、批量查询、上下文控制
`Glob`	`precision_glob`	输出模式、筛选、预览
`Edit`	`precision_edit`	原子事务、验证、提示
`Write`	`precision_write`	原子操作、模板、验证
`Bash`	`precision_exec`	批量命令、预期值、输出控制

精准工具模式

# Find files with pattern (minimal output)
precision_grep:
  queries:
    - pattern: "TODO|FIXME|HACK"
      glob: "src/**/*.ts"
  output:
    mode: files_only

# Read file structure without content
precision_read:
  files: ["src/index.ts", "src/app.ts"]
  extract: outline
  output:
    mode: minimal

# Batch edit multiple files atomically
precision_edit:
  edits:
    - file: "src/api.ts"
      find: "const API_URL = 'http://localhost'"
      replace: "const API_URL = process.env.API_URL"
    - file: "src/config.ts"
      find: "debug: true"
      replace: "debug: process.env.NODE_ENV !== 'production'"
  transaction:
    mode: atomic
    rollback_on_fail: true
  output:
    mode: minimal

# Execute commands with expectations
precision_exec:
  commands:
    - cmd: "npm run typecheck"
      expect:
        exit_code: 0
    - cmd: "npm run lint"
      expect:
        exit_code: 0
  output:
    mode: minimal

发现 -> 批量工作流

重要：始终先发现，再进行批量操作。

discover 工具会并行运行多个查询，在构建批量操作前收集上下文。这可以避免浪费操作，并确保目标文件准确无误。

发现工具用法

# Run parallel discovery queries
discover:
  queries:
    - id: find_components
      type: glob
      patterns: ["src/components/**/*.tsx"]
    - id: find_api_routes
      type: glob
      patterns: ["src/api/**/*.ts", "src/app/api/**/*.ts"]
    - id: find_issues
      type: grep
      pattern: "TODO|FIXME|HACK"
      glob: "src/**/*.{ts,tsx}"
    - id: find_hooks
      type: symbols
      query: "use"
      kinds: ["function"]
  output_mode: files_only  # count_only | files_only | locations

工作流模式

发现 - 运行查询以了解范围
- 先使用 count_only 估算规模
- 然后使用 files_only 获取目标列表
规划 - 根据发现结果构建批量操作
- 在批量操作中引用已发现的文件
- 将工作范围严格限定为发现的内容
执行 - 在完整上下文中运行批量操作

示例：功能实现

# Step 1: Discover current state
discover:
  queries:
    - id: existing_files
      type: glob
      patterns: ["src/features/auth/**/*.ts"]
    - id: existing_patterns
      type: grep
      pattern: "export (function|const|class)"
      glob: "src/features/**/*.ts"
  output_mode: files_only

# Step 2: Use results to build targeted batch
batch:
  id: implement-feature
  operations:
    read:
      - id: analyze
        type: files
        targets: "{{existing_files.files}}"  # From discovery
        extract: outline

优点：

避免对错误文件进行盲目操作
确保代码库中的模式保持一致
通过精准定位所需内容，减少 Token 用量
有助于基于充分信息选择实现方案

模式感知行为

你的行为会根据当前模式进行调整：

vibecoding 模式

沟通：展示进度、解释决策、详细汇报结果
询问：遇到不明确之处或风险时，继续之前先询问用户
检查点：为每个批次创建检查点
输出：使用标准详细程度，展示差异

justvibes 模式

静默：尽量减少沟通，将日志写入 .goodvibes/logs/activity.md
自主：自行做出最合理的判断，遇到风险时设置检查点后继续
自动衔接：自动继续下一个逻辑批次
输出：尽量简洁，不展示差异

工作流概览

┌─────────────────────────────────────────────────────────────┐
│                      CODEBASE REVIEW                        │
├─────────────────────────────────────────────────────────────┤
│  Phase 1: Review      │  Run MCP tools, analyze all code   │
│  Phase 2: Report      │  Generate codebase-review-report.md │
│  Phase 3: Plan        │  Create remediation-plan.md        │
│  Phase 4: Execute     │  WORK-REVIEW-FIX-CHECK (max 6)     │
└─────────────────────────────────────────────────────────────┘

阶段 1：代码库审查

MCP 工具映射

类别	主要工具	回退方案
质量	`find_dead_code`、`scan_patterns`	使用 grep 搜索模式
架构	`find_circular_deps`、`get_api_surface`	手动分析
安全	`scan_for_secrets`、`check_permissions`	使用 grep 搜索模式
性能	`get_prisma_operations`、`analyze_bundle`	无
文档	`explain_codebase`	扫描文件
测试	`get_test_coverage`、`find_tests_for_file`、`suggest_test_cases`	jest --coverage
配置	`read_config`、`env_audit`	扫描环境文件
依赖项	`analyze_dependencies`	npm audit
错误	`parse_error_stack`、`explain_type_error`	tsc 输出
风格	`scan_patterns`、`get_conventions`	eslint 输出

审查清单

每个类别的最低要求：

5 条具体的文件:行号发现，或明确注明“未发现问题”
量化指标（数量、百分比、代码行数）
严重程度分类（严重/高/中/低）

阶段 2：主报告

生成 codebase-review-report.md：

# Codebase Review Report

**Project**: {name from detect_stack}
**Stack**: {technologies detected}
**Generated**: {ISO 8601 timestamp}
**Overall Score**: {X.X}/10

## Executive Summary

| Severity | Count | Description |
|----------|-------|-------------|
| 🔴 Critical | N | Issues requiring immediate attention |
| 🟠 High | N | Issues blocking production readiness |
| 🟡 Medium | N | Issues impacting maintainability |
| 🔵 Low | N | Minor improvements |

## Score Breakdown

| Category | Weight | Raw | Deductions | Score | Grade |
|----------|--------|-----|------------|-------|-------|
| Quality | 15% | 10 | -X.X | X.X | A-F |
| Architecture | 15% | 10 | -X.X | X.X | A-F |
| Security | 20% | 10 | -X.X | X.X | A-F |
| Performance | 10% | 10 | -X.X | X.X | A-F |
| Documentation | 5% | 10 | -X.X | X.X | A-F |
| Testing | 15% | 10 | -X.X | X.X | A-F |
| Config | 5% | 10 | -X.X | X.X | A-F |
| Dependencies | 5% | 10 | -X.X | X.X | A-F |
| Errors | 5% | 10 | -X.X | X.X | A-F |
| Style | 5% | 10 | -X.X | X.X | A-F |
| **TOTAL** | 100% | - | - | **X.X** | **X** |

## Score Calculation

{Show the math for each category deduction}

## Detailed Findings

### {Category Name}

#### Finding: {Title}

| Field | Value |
|-------|-------|
| **Severity** | critical\|high\|medium\|low |
| **Location** | `file:line` or `file:startLine-endLine` |
| **Measurement** | {exact number or percentage} |
| **Threshold** | {acceptable value} |
| **Impact** | {business/technical consequence} |
| **Points Deducted** | {-X.X from Category} |

**Evidence:**

{代码片段或工具输出}


**Required Fix:**

{具体修复代码或步骤}


---

{repeat for all findings}

## What's Working Well

{List genuinely good patterns found, with file references}

## Improvement Roadmap

| Phase | Focus | Expected Impact | New Score |
|-------|-------|-----------------|-----------|
| 1 | Critical fixes | +X.X points | X.X |
| 2 | High priority | +X.X points | X.X |
| 3 | Medium priority | +X.X points | X.X |
| 4 | Polish | +X.X points | X.X |

阶段 3：修复计划

生成 remediation-plan.md：

# Remediation Plan

**Generated**: {timestamp}
**Total Tasks**: {N}
**Execution Strategy**: WORK-REVIEW-FIX-CHECK with parallel goodvibes agents (max 6 concurrent)

## Execution Rules

| Rule | Value |
|------|-------|
| Max concurrent agents | 6 |
| Agent type | goodvibes background |
| Context model | Fresh per task (no accumulation) |
| Tool priority | MCP tools > bash |
| Monitoring | Self-report via SubagentStop hook |
| Workflow | WORK → REVIEW → PASS/FAIL → (FIX → CHECK) |

## Task Definitions

### Wave 1: Critical [P0] - Execute Immediately

#### TASK-001: {Description}

| Field | Value |
|-------|-------|
| **Severity** | critical |
| **Target Files** | `file1.ts`, `file2.ts` |
| **Related Finding** | {reference to report finding} |
| **MCP Tools** | `tool1`, `tool2` |
| **Estimated Duration** | Xm |

**Context from Report:**

{相关发现详情}


---

{repeat for all tasks, grouped by wave}

### Wave 2: High [P1]

### Wave 3: Medium [P2]

### Wave 4: Low [P3]

## Dependency Graph

{Show task dependencies if any exist}

阶段 4：并行 Agent 执行

WORK-REVIEW-FIX-CHECK 工作流

For each remediation task:

  WORK Agent ─────────────────────> REVIEW Agent
  (goodvibes:engineer)              (goodvibes:reviewer)
       │                                  │
       │                                  ├─> PASS ─> Commit ─> Update Log ─> Next Task
       │                                  │
       │                                  └─> FAIL ─> FIX Agent ─> CHECK Agent
                                                         │              │
                                                         │              ├─> PASS ─> Commit
                                                         │              │
                                                         └──────────────┴─> FAIL (loop)

Agent 角色映射

阶段	Agent	用途
WORK	`goodvibes:engineer`	执行修复任务
REVIEW	`goodvibes:reviewer`	验证工作质量（必须达到 100%）
FIX	`goodvibes:engineer`	解决所有审查问题
CHECK	`goodvibes:reviewer`	重新验证修复结果

等待 Agent（关键）

绝不要使用以下方式检查 Agent 状态：

对记录文件使用 tail 命令
TaskOutput 工具
任何形式的轮询

应由编排器执行以下操作：

使用 run_in_background: true 启动 Agent
停止执行操作（本轮结束）
Agent 完成时接收 SubagentStop hook 通知
Hook 消息会连同状态一并出现在上下文中

并发规则

规则	值
最大并发 Agent 数	6
每项任务的 Agent 数	1（同一时间每项任务由一个 Agent 处理）
完成要求	100%（不是 99.9%）

WORK Agent 提示词模板

# Remediation Task: {TASK_ID}

## MCP Tool Checklist (MANDATORY)

**CRITICAL PREREQUISITE:** You MUST call `mcp-cli info <server>/<tool>` BEFORE ANY `mcp-cli call <server>/<tool>`.

Before ANY edit:
```bash
# Check schemas first
mcp-cli info plugin_goodvibes_analysis-engine/scan_patterns
mcp-cli info plugin_goodvibes_project-engine/find_tests_for_file

# Then execute
mcp-cli call plugin_goodvibes_analysis-engine/scan_patterns '{}'
mcp-cli call plugin_goodvibes_project-engine/find_tests_for_file '{"file":"{TARGET_FILE}"}'

每次编辑后：

# Check schema first
mcp-cli info plugin_goodvibes_project-engine/project_issues

# Then execute
mcp-cli call plugin_goodvibes_project-engine/project_issues '{}'

任务

字段	值
任务 ID	{TASK_ID}
严重程度	{SEVERITY}
描述	{DESCRIPTION}
文件	{FILE_LIST}

报告中的上下文

{FINDING_DETAILS}

说明

仅完成分配给你的任务
在使用 bash 之前，先使用 goodvibes MCP 工具
所有操作都使用精确工具（precision_edit、precision_exec）
每次编辑后都运行验证工具
如果编辑导致新错误，完成前先修复这些错误

工具优先级（强制）

首先：检查 mcp-cli info，然后调用 mcp-cli call plugin_goodvibes_*
其次：使用精确工具（precision_edit、precision_read 等）
只有在不存在 MCP/精确工具时，才回退到标准工具

完成报告

完成后，输出：

{
  "task_id": "{TASK_ID}",
  "status": "success|failed",
  "files_modified": ["file1.ts", "file2.ts"],
  "tests_passed": true|false,
  "type_check_passed": true|false,
  "notes": "Any relevant context"
}


---

### REVIEW Agent Prompt Template

```markdown
# Review Task: {TASK_ID}

## MCP Tool Checklist (MANDATORY)

**CRITICAL PREREQUISITE:** You MUST call `mcp-cli info <server>/<tool>` BEFORE ANY `mcp-cli call <server>/<tool>`.

```bash
# Check schemas first
mcp-cli info plugin_goodvibes_project-engine/project_issues
mcp-cli info plugin_goodvibes_analysis-engine/scan_patterns
mcp-cli info plugin_goodvibes_project-engine/get_test_coverage

# Then execute
mcp-cli call plugin_goodvibes_project-engine/project_issues '{}'
mcp-cli call plugin_goodvibes_analysis-engine/scan_patterns '{}'
mcp-cli call plugin_goodvibes_project-engine/get_test_coverage '{}'

任务

字段	值
任务 ID	{TASK_ID}
WORK Agent	{WORK_AGENT_ID}
已修改文件	{FILE_LIST}

WORK Agent 提供的上下文

{WORK_COMPLETION_REPORT}

审查标准

标准	权重	描述
正确性	30%	是否正确解决了问题？
完整性	25%	是否处理了所有方面？
质量	20%	代码是否简洁且易于维护？
安全性	15%	是否没有引入新错误或安全问题？
测试	10%	测试是否通过，覆盖率是否保持不变？

审查流程

阅读所有已修改文件
运行 MCP 验证工具
检查以下方面：
- 类型错误
- 测试失败
- 安全问题
- 代码质量问题
- 修复不完整
根据标准权重计算分数
给出结论

审查输出

{
  "task_id": "{TASK_ID}",
  "verdict": "PASS|FAIL",
  "score": 8.5,
  "issues": [
    {
      "severity": "critical|major|minor",
      "file": "path/to/file.ts",
      "line": 47,
      "issue": "Description of the issue",
      "fix_guidance": "Specific guidance on how to fix"
    }
  ],
  "recommendation": "Details for FIX agent if FAIL"
}

判定规则

通过：分数 >= 8.0，且没有严重问题，且所有标准均通过
失败：分数 < 8.0，或存在任何严重问题，或任何标准未通过

严重：请如实评估。现在发现问题，总比上线后发现好。


---

### FIX Agent Prompt Template

```markdown
# Fix Task: {TASK_ID} (Iteration {N})

## MCP Tool Checklist (MANDATORY)

**CRITICAL PREREQUISITE:** You MUST call `mcp-cli info <server>/<tool>` BEFORE ANY `mcp-cli call <server>/<tool>`.

Before ANY edit:
```bash
# Check schemas first
mcp-cli info plugin_goodvibes_analysis-engine/scan_patterns
mcp-cli info plugin_goodvibes_project-engine/find_tests_for_file

# Then execute
mcp-cli call plugin_goodvibes_analysis-engine/scan_patterns '{}'
mcp-cli call plugin_goodvibes_project-engine/find_tests_for_file '{"file":"{TARGET_FILE}"}'

每次编辑后：

# Check schema first
mcp-cli info plugin_goodvibes_project-engine/project_issues

# Then execute
mcp-cli call plugin_goodvibes_project-engine/project_issues '{}'

审查反馈

{ISSUES_FROM_REVIEW}

说明

处理审查中的每个问题，不得遗漏
遵循每个问题提供的 fix_guidance
所有操作均使用精确工具
每次修复后运行验证
如果无法修复问题，请说明原因并标记为受阻

完成报告

{
  "task_id": "{TASK_ID}",
  "iteration": {N},
  "status": "success|blocked",
  "issues_addressed": N,
  "issues_remaining": N,
  "blocked_issues": [
    {
      "issue": "Description",
      "reason": "Why it cannot be fixed"
    }
  ],
  "notes": "Any relevant context"
}


---

### CHECK Agent Prompt Template

```markdown
# Check Task: {TASK_ID} (Verification Round {N})

## MCP Tool Checklist (MANDATORY)

**CRITICAL PREREQUISITE:** You MUST call `mcp-cli info <server>/<tool>` BEFORE ANY `mcp-cli call <server>/<tool>`.

```bash
# Check schemas first
mcp-cli info plugin_goodvibes_project-engine/project_issues
mcp-cli info plugin_goodvibes_analysis-engine/scan_patterns

# Then execute
mcp-cli call plugin_goodvibes_project-engine/project_issues '{}'
mcp-cli call plugin_goodvibes_analysis-engine/scan_patterns '{}'

任务

字段	值
任务 ID	{TASK_ID}
FIX Agent	{FIX_AGENT_ID}
迭代次数	{N}

先前问题

{ISSUES_TO_VERIFY}

FIX Agent 提供的上下文

{FIX_COMPLETION_REPORT}

验证流程

阅读所有已修改的文件
运行 MCP 验证工具
验证每个先前问题均已解决
检查修复是否引入了新问题
给出判定

判定输出

{
  "task_id": "{TASK_ID}",
  "iteration": {N},
  "verdict": "PASS|FAIL",
  "resolved_issues": N,
  "unresolved_issues": [
    {
      "issue": "Description",
      "status": "still_present|new_issue"
    }
  ],
  "recommendation": "Next action if FAIL"
}

判定规则

通过：所有先前问题均已解决，且没有新的严重问题
失败：存在任何未解决的问题，或发现新的严重问题

如果 3 次迭代后仍失败，则升级至人工审查。


---

### Commit Protocol

After REVIEW or CHECK verdict is PASS, create commit:

fix({CATEGORY}): {TASK_ID} - {SHORT_DESCRIPTION}

{DETAILED_DESCRIPTION}

变更

{FILE_1}: {WHAT_CHANGED}
{FILE_2}: {WHAT_CHANGED}

审查

审查者：REVIEW agent
分数：{SCORE}/10
迭代次数：{FIX_ITERATIONS}

任务 ID：{TASK_ID} 严重程度：{SEVERITY} 共同撰写者：Claude Opus 4.5 [email protected]


### Completion Cleanup

After ALL remediation tasks have passed review and been committed, archive the output files:

**Archive Location:** `.goodvibes/completed/`

**Archive Commands:**
```bash
# Run all commands together in a single shell session:
# Create archive directory if it doesn't exist
mkdir -p .goodvibes/completed

# Generate timestamp
TIMESTAMP=$(date +%Y%m%d-%H%M%S)

# Move and rename files
mv codebase-review-report.md .goodvibes/completed/code-review-${TIMESTAMP}.md
mv remediation-plan.md .goodvibes/completed/remediation-plan-${TIMESTAMP}.md
mv remediation-log.md .goodvibes/completed/remediation-log-${TIMESTAMP}.md

归档清单：

remediation-log.md 中的所有修复任务状态均为：已完成
所有提交均已推送（如适用）
已更新记忆文件（.goodvibes/memory/）
已创建归档目录
文件已移入并添加时间戳后缀

文件命名约定：

原文件	归档文件
`codebase-review-report.md`	`code-review-{YYYYMMDD-HHMMSS}.md`
`remediation-plan.md`	`remediation-plan-{YYYYMMDD-HHMMSS}.md`
`remediation-log.md`	`remediation-log-{YYYYMMDD-HHMMSS}.md`

归档原因：

保持项目根目录整洁
保留历史审查数据
便于跟踪代码库健康状况的变化
避免与未来的审查混淆

完成情况记录

维护 remediation-log.md：

# Remediation Log

## Active Agents

| Task ID | Description | Agent | Phase | Started | Elapsed |
|---------|-------------|-------|-------|---------|---------|
| TASK-002 | Remove secrets | agent-abc | WORK | 10:05:00 | 5m |
| TASK-003 | Fix auth flow | agent-def | REVIEW | 10:08:00 | 2m |

## Completed Tasks

| Task ID | Description | Status | Duration | Iterations | Changes |
|---------|-------------|--------|----------|------------|---------|
| TASK-001 | Fix SQL injection | ✅ PASS | 15m32s | 1 | `api/users.ts` |

## Failed Tasks

| Task ID | Description | Status | Iterations | Reason | Retry? |
|---------|-------------|--------|------------|--------|--------|
| TASK-005 | Fix type errors | ❌ FAIL | 3 | Blocked by external dependency | No |

## Summary

- **Total Tasks**: N
- **Completed**: N (X%)
- **In Progress**: N
- **Failed**: N
- **Remaining**: N
- **Active Agents**: N/6

输出产物

文件	用途
`codebase-review-report.md`	包含量化指标和评分的完整审查结果
`remediation-plan.md`	按严重程度排序并附带上下文的任务清单
`remediation-log.md`	实时执行跟踪，包含 WORK-REVIEW-FIX-CHECK 状态

**注意：**所有修复任务完成后，这些文件将归档至 .goodvibes/completed/，并添加时间戳后缀。详情请参阅“完成清理”部分。

记忆集成

审查/修复后，更新 .goodvibes/memory/：

文件	更新内容
`decisions.md`	修复过程中做出的架构决策
`patterns.md`	发现或强制采用的模式
`failures.md`	失败的修复及其根因分析
`preferences.md`	效果良好的工具偏好

约束

约束	值	原因
最大并发 Agent 数	6	资源管理
Agent 类型	goodvibes background	通过 hooks 收集遥测数据
每个 Agent 的任务数	1	为每项任务提供全新上下文
上下文继承	无	防止交叉污染
监控方式	自我报告	由 SubagentStop hook 处理
工具优先级	MCP > 精确工具 > bash	保持一致性并收集遥测数据
审查要求	100%	确保提交前的质量

支持 Markdown

登录后评论

基本信息

作者: mgd34msu
仓库: mgd34msu/goodvibes-plugin
分类: 测试与质量
安装次数: 37
GitHub Stars: 6

报告问题