mcpField
S
Steadfast Repository Governance

Steadfast Repository Governance

本地服务
github.com开发工具21 天前更新
代码仓库访问官网

关于 Steadfast Repository Governance

Steadfast 是面向开发者和编码 Agent 的本地优先命令行工具，用于检查代码库状态并执行治理规则。它结合只读验证、审计报告和可选 MCP 接入，不会将代码库内容发送到 Steadfast 托管服务。

主要功能

  1. 01检查变更范围和证据
  2. 02检测文档与代码漂移
  3. 03验证目标和发布就绪状态
  4. 04配置 Agent 指引与集成
  5. 05生成易读的审计报告

适用场景

  1. 01评审前验证代码库变更
  2. 02审计证据与文档一致性
  3. 03为编码 Agent 配置治理规则

MCP 相关

Steadfast 可启动只读 MCP 服务，供兼容的 Agent 使用，并提供代码库治理与验证能力。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "rllibo833-sudo-steadfast-governance": {
      "command": "uvx",
      "args": [
        "steadfast-governance"
      ]
    }
  }
}
启动命令uvx steadfast-governance

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypisteadfast-governance0.4.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Steadfast

面向编码 Agent 的代码库检查与防护措施。

Steadfast 是一款本地优先的命令行工具，可帮助开发者和 AI Agent 检查代码库健康状况、约束变更范围、验证证据并发现文档偏差。它不会生成代码，不要求 AI API 密钥，也不会将代码库内容发送到 Steadfast 托管的服务。

快速开始

需要 Python 3.10+ 和 Git。

python -m pip install --upgrade steadfast-governance
cd /path/to/your/repository
steadfast onboard --agent codex
steadfast verify

将 codex 替换为 claude、cursor 或 all，即可配置其他受支持的 Agent。请先检查生成的文件，再信任代码库。默认情况下会保留现有文件。

如需获取最新的未发布源码，请改为从 Git 安装：

python -m pip install --upgrade "git+https://github.com/rllibo833-sudo/Steadfast.git"

大多数人需要的命令

命令用途
steadfast onboard设置代码库指南并集成选定的 Agent。
steadfast verify运行统一的只读治理检查。
steadfast report生成便于阅读的审计报告。
steadfast audit检查变更文件、证据、契约和文档偏差。
steadfast discover打印供工具和 Agent 使用的机器可读能力映射。
steadfast mcp-server为兼容的 Agent 启动只读 MCP 服务。

请参阅快速入门指南了解简要操作流程，参阅 MCP 客户端设置指南连接兼容的 AI 客户端，并参阅命令参考查看完整的 CLI 命令列表。如需可直接复制的拉取请求工作流和采用检查清单，请参阅 在 GitHub Actions 中采用。

检查内容——以及无法检查的内容

  • 范围： 将变更路径与代码库策略进行比较。
  • 证据： 检查必需的证明文件和证据包完整性。
  • 安全信号： 标记选定的高风险源码模式和工作流信任边界问题。
  • 文档与代码一致性： 检测过时的命令示例和软件包入口点偏差。
  • 目标与发布： 验证目标依赖关系并评估发布就绪情况。
  • Agent 支持： 发现技能、检查 MCP 配置并安装代码库本地指南。

这些检查是防护措施，不是沙箱，也不能证明语义正确性。结果取决于代码库策略和配置；在将检查结果视为发布决策依据之前，请先审查发现的问题。Steadfast 不会在 verify 过程中悄悄改写计划或执行已配置的流水线。只有在审查清单后，才单独运行 steadfast pipeline。

配置

运行 steadfast init 可创建治理文件模板。代码库策略位于 .steadfast/policy.json；流水线步骤配置在 .steadfast/pipeline.json 中。请将流水线清单视为可执行配置，并在运行前审查其中的命令。

项目链接

开发

python -m pip install -e .
python -m unittest discover -s tests -v
steadfast docs-check
steadfast code-truth

采用 MIT 许可证。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。