prime-radiant-inc/greenfield

# Greenfield **从任何代码库逆向工程出纯净的行为规范。** Greenfield 会读取源代码、文档、SDK、运行时行为和二进制文件，然后生成行为规范、测试向量、验收标准和完整的溯源追踪。其输出描述的是软件*做了什么*，而不是某个特定代码库*怎么做的*，这样全新的实施团队就可以根据规范进行构建，而无需继承原有项目的内部结构。 Greenfield 是一个 [Claude Code](https://claude.com/claude-code) 插件。它在 `claude` CLI 内部运行，并使用 Claude agents 作为 worker 来读取代码、编写规范和审计输出。 ## 安装说明 ``` /plugin marketplace add prime-radiant-inc/prime-radiant-marketplace /plugin install greenfield@prime-radiant-marketplace ``` 安装后请重启 Claude Code。 ## 使用说明 ### 提取规范 ``` claude > /analyze /path/to/target ``` `/analyze` 运行一个七层 pipeline。它会发现可用的情报来源（源代码、文档、SDK、社区、运行时、二进制文件、git 历史、测试、UI、contracts），从每个来源收集证据，综合生成带有溯源引用的行为规范，生成测试向量和验收标准，剔除规范中的实现细节，然后对结果进行第二轮审查。 目标的形态并不重要。Greenfield 已被用于单文件压缩的 JavaScript bundle 和源代码树项目；该 pipeline 还有一条用于反编译原生二进制文件的路径。该方法会根据现有内容自动调整。 Workspace 输出： ``` workspace/ ├── raw/ # Analysis artifacts with source references ├── output/ # Sanitized specs for the implementation team │ ├── specs/ │ ├── test-vectors/ │ └── validation/ └── provenance/ # Citation audit trail ``` ### 重新净化已有的 workspace ``` claude > /sanitize /path/to/workspace ``` 在已有的 workspace 上重新运行净化流程。当初始流程留下了被审计捕获的污染时，此功能非常有用。 ### 根据输出规范进行实现 Greenfield 在生成规范后停止。实施团队会读取 `workspace/output/`，并根据其中的行为规范、测试向量和验收标准进行构建。 ## 工作原理 该 pipeline 会在这七层中分发带有特定角色提示词的 agent。每次分发都会运行两种通用 agent 类型之一，这些 agent 加载了特定的技能： - **analyzer** —— 主力工具。读取证据并编写规范。在各层中以多种角色进行分发：`discovery-agent`、`bundle-splitter`、`chunk-analyzer`、`function-analyzer`、`doc-researcher`、`community-analyst`、`sdk-analyzer`、`cli-explorer`、`behavior-observer`、`feature-discoverer`、`architecture-analyst`、`api-extractor`、`synthesizer`、`module-mapper`、`deep-dive-analyzer`、`behavior-documenter`、`user-journey-analyzer`、`contract-extractor`、`spec-verifier`、`source-completeness-checker`、`test-vector-generator`、`test-generator`、`acceptance-criteria-writer`、`spec-reviewer`、`structural-leakage-reviewer`、`content-contamination-reviewer`、`behavioral-completeness-reviewer`、`deep-read-auditor`、`fidelity-validator`。 - **sanitizer** —— 将原始规范重写为不含实现细节的输出规范。在第 5 层以及第 6 层和第 7 层的修复期间进行分发。 ### Pipeline | 层级 | 角色 | 输出 | |-------|-------|--------| | L1: 情报 | bundle-splitter, chunk-analyzer, function-analyzer, doc-researcher, community-analyst, sdk-analyzer, cli-explorer, behavior-observer | 来自源代码、文档、SDK、社区、运行时、二进制文件的原始证据 | | L2: 综合 | feature-discoverer, architecture-analyst, api-extractor, synthesizer, module-mapper | 功能清单、架构模型、模块映射图 | | L3: 深度文档 | deep-dive-analyzer, behavior-documenter, user-journey-analyzer, contract-extractor | 行为规范、用户旅程、contracts | | 关卡 1 | spec-verifier | 正确性、矛盾、缺漏 | | 关卡 1b | source-completeness-checker | 捕获所有面向用户的界面 | | L4: 验证 | test-vector-generator, test-generator, acceptance-criteria-writer | 测试向量、测试规范、验收标准 | | 关卡 2 | spec-reviewer | 实现泄漏、完整性、质量 | | L5: 净化 | sanitizer | 基于理解重写输出规范，而非照搬 | | L6: 审查 | structural, content, completeness reviewers + deep-read auditors | 第二轮污染审查 | | L7: 保真度 | fidelity-validators | 标记在净化过程中丢失或弱化的行为细节 | ## 许可证 Apache 2.0。版权所有 2026 Prime Radiant, Inc.

标签：AI编程助手, Claude插件, 云资产清单, 代码分析, 凭证管理, 数据管道, 文档结构分析, 软件工程, 逆向工程, 需求规格说明