用途
agentic-os 是一个受治理、可移植的编码代理工程平台，用于解决多代理编码中反复出现的几类问题：代理写入范围悄然越过授权文件、代理自我评审时合理化本应发现的缺陷、自主模式只是粗暴的开关而非按决策风险分级的处置策略、技术栈事实每会话重新猜测且规则可能跨栈泄漏。该平台用被强制执行而非仅在提示词中请求的机制来逐一封堵这些问题。
主要组成
仓库是一个市场（marketplace），托管三个插件：
- agentic-os：产品本体，包含 /agentic-init、/agentic-doctor、/agentic-upgrade 三个技能，以及它们据以生成脚手架的模板库、生成器和角色预设。
- agentic-sdlc：SDLC 流水线及门仲裁器，按决策风险处置每个判断门（HITL 模式询问人类；自主模式走确定性→快速路径→替身子代理→升级），并保留完整的 decisions.jsonl 审计轨迹。
- agentic-qe：与工具无关的质量工程 AI 蓝图目录（28 个，按 STLC 阶段组织），含两个技能：qe-blueprints 从所选蓝图生成可填充的代理框架，eval-harness 为技能和代理生成双层评估框架。 此外还有 mcp/：只读 MCP 服务器，向不支持 Claude Code 或 Cursor 插件格式的 MCP 客户端提供同样的治理/SDLC/QE 方法论，独立打包，发布在 npm 和 MCP Registry。
主要能力
- 一次访谈（角色、自主级别、技术栈）后向项目脚手架出一致系统：规范代理契约、强制钩子（提交前盲审、写入范围守卫、指令质量生成门）、人类在环升级阶梯，并在适配技术栈时生成栈专属代理。
- 栈通用：即时识别六个精选配置文件（Next.js、Django、Spring、Rails、Go、Playwright）；其他栈（如 NestJS 后端、无模式 MongoDB 服务、或完全没有代码栈）通过实时仓库发现生成有证据支撑的持久化与 API 代理。前端/UI 生成使用相同发现机制，但处于更早的验证周期。
- 角色无关：支持开发者、QA、BA/PO、架构师、交付等角色，非编码角色完全通过普通聊天短语工作。
- 脚手架产出的契约按设计是与宿主无关的（各宿主薄指针文件覆盖规范化的、与宿主无关的主体）。
使用方式
在 AI 编码编辑器（Claude Code 或 Cursor）中安装两个插件。快速流程：为编辑器安装插件；打开想改进的 git 仓库（不是本市场仓库）；运行 /agentic-init --presets <角色[,角色...]>（或 /agentic-init 进行完整角色选择访谈）；运行 /agentic-doctor 期望在 .agentic/agentic-os/doctor.json 中看到 passed: true；git status 审查脚手架文件，不会自动提交；若使用 SDLC 流水线，运行 sdlc-preflight 期望在 .agentic/agentic-sdlc/doctor.json 中看到 passed: true。建议先用一次性仓库走通流程再接触真实项目。
依赖要求：Claude Code 或 Cursor；PATH 中有 python3（强制钩子是 Python 脚本）；git（目标仓库须为 git 仓库，/agentic-init 可执行 git init）；使用 agentic-sdlc 时需 PATH 中有 node；superpowers ≥ 6.1.0 和 agentic-sdlc ≥ 0.4.4（由 /agentic-init 要求）；可选 gh（GitHub CLI）用于 GitHub 工单/MR 适配器。
角色选择是显式的，例如工作偏需求、客户与交付时选 ba-po，只安装调度器和需求工作流，不装开发者/写代码代理。之后可重跑 /agentic-init --presets ba-po,developer 添加角色，安装器会合并现有架构并保留用户所有文件。
MCP 为可选项，设置时可选：立即连接、稍后配置、或不用 MCP 继续（粘贴表格、附加 CSV、分享截图或粘贴 Power BI 发现）。Cursor 项目 MCP 配置为 .cursor/mcp.json，全局为 ~/.cursor/mcp.json；Claude Code 共享项目配置为 .mcp.json。密钥应放在 OAuth 或环境变量中，绝不写入提交的 JSON。
适用场景
- 希望为 AI 编码代理设定明确边界、强制人类在环与独立评审的团队。
- 只想用护栏而不要流水线，或（在 Codex 上）只要流水线的团队。
- 非编程角色的需求、客户与交付工作流。
- 通过任意支持 MCP 的助手以只读方式查询此方法论、列出角色预设与 QE 蓝图、把角色转成安装计划、审计现有安装。
限制
- 插件交付形式为 Claude Code 和 Cursor 插件，agentic-sdlc 额外提供 Codex 打包。
- 该插件是自定义市场，不在 Cursor 的 Browse Marketplace → All 中，需添加自定义市场并从 User 标签安装。
- 非精选栈上的前端/UI 生成处于更早的验证周期。
- 文中未提供收费、价格等信息。
