AIWG
为你在用的 AI 编程工具提供可复用的项目上下文、专家代理与结构化工作流，让决策在会话之间持续沉淀。
- 本次评审未提供任何源文件，结果不构成对该仓库质量或安全性的任何肯定或否定判断。
- 如需有效评估，请提供固定修订版下的 README、LICENSE、package.、工作流及代表性代理/工作流文件。
这个 Agent 能做什么，适合哪些场景？
AIWG（AI Working Group）是一个用于 AI 增强软件开发的认知架构框架，将代理、技能、规则、模板与工作流工具打包成可在 15 个已命名 AI 平台上部署的统一来源。它的部署层通过 `aiwg use` 把 Markdown/YAML 源文件复制到各平台读取的原生路径，而项目产出则持久保存到 `.aiwg/` 工件目录，跨越会话复用。核心组件包括语义记忆（`.aiwg/`）、多代理评审与综合、Ralph 自纠错循环、双向可追溯性、基于 Cooper Stage-Gate 的阶段门规划，以及可控的语音风格生成。它提供九个领域框架（如 SDLC Complete、Forensics Complete、Research Complete）和数十个可选插件（如 Agent Loop、Compound Memory、Dataset Intelligence）。它不是模型也不替代订阅，部署的核心产物是平台原生可读的纯文本文件，可选的编排与运行时组件需另行启用。
安装后，aiwg use all --provider <provider> 一次性将内核技能、专家代理（如 Security Auditor、Test Architect）、规则、模板复制到平台原生目录（如 .claude/skills/、.codex/agents/），构建工件索引，并在项目根目录生成 AIWG.md / AGENTS.md，最后自校验并报告是否需要重载。日常使用时用自然语言描述目标（例如“评审这个设计的安全风险”），助手通过能力图检索并加载对应技能执行；工作流遵循 Primary Author → 并行评审 → Synthesizer → 人工审批门 → 归档的模式。工作产物（需求、架构决策、测试策略、部署计划）保存在 .aiwg/ 中，通过 @-mentions 互相关联，代码中可用 @implements 注解建立文档-代码-测试的双向追溯。可选的 Ralph 循环执行“执行-验证-根因分析-调整策略-重试”的有界迭代，aiwg doctor 用于诊断部署健康状态。
- 工程团队启动多周或数月的新功能项目，需要架构、安全、测试等多视角评审和阶段门审批。
- 遗留系统迁移需要分阶段回滚策略和跨会话保存的架构决策记录。
- 安全或合规敏感领域（医疗、金融、航空）需要审计线索和可追溯的需求-代码-测试链条。
- 事件响应团队需要取证工作流：证据保全、日志分析、持久化排查、时间线构建与 IOC 提取。
- 营销或研究团队需要可复用的简报、来源记录、引用核查和跨会话的内容沉淀。
- 个人开发者希望在现有 Claude Code / Codex / Cursor 会话中获得结构化评审而不更换工具。
这个 Agent 有哪些优点和局限？
- 一套源文件部署到 15 个具名平台加一个通用适配器，避免为每个 AI 工具重复维护指令。
.aiwg/工件记忆加双向追溯（Doc↔Code↔Tests）让跨会话的决策和评审结论可查阅、可审计。- 规模罕见：仅 SDLC Complete 就有 100 个代理、116 个技能、217 个模板、39 条规则，且覆盖取证、营销、研究、运维、安全工程等九个领域。
- 项目的自定义扩展以字节一致的形式存放在
.aiwg/extensions/等目录，可零重写地向上游提升。
- 需要 Node.js >= 20 和已订阅的 AI 平台，本身不替代任何模型或订阅；大多数工作流运行在项目工件而非独立运行时上。
- 安装面较复杂：存在 project/user/global 三种作用域、可选原生特性、macOS EACCES、PATH 问题等多种文档记录的故障路径。
- README 明确声明：代理角色定义不是独立模型，规则文件不等于约束被执行；多评审者仍可能共享同一错误，收益依赖工件持续维护。
- 完整生命周期对小任务过重，额外上下文、评审者与验证步骤会增加模型调用与人工成本。
如何安装或部署这个 Agent？
前置条件：Node.js >= 20.0.0（新装建议 Node 24）和一个受支持的 AI 平台。标准安装：npm i -g aiwg，然后 cd /path/to/your/project && aiwg use all --provider claude（将 claude 替换为实际平台名，如 codex、copilot、cursor、warp、factory、opencode、devin 等）。也可安装仅从发布主机获取签名版本资源的轻量可执行文件：npm i -g @aiwg/cli。可选安装 AIWG Cockpit 与 Agentic Sandbox（自托管 Docker 或 KVM/libvirt 执行器）：按 https://aiwg.io/agentic-sandbox/setup.aiwg.yaml 的提示词引导安装。macOS 上若 npm 报 EACCES，请参阅 macOS 安装指南，避免用 sudo 全局安装。
如何使用这个 Agent？
部署后直接在 AI 工具中用自然语言下指令，例如：“Set up the SDLC framework for this project and my AI tool.”或“Review this design for security risks.”助手会自动发现并加载对应技能。可按需部署单个框架：aiwg use sdlc --provider claude、aiwg use forensics --provider claude、aiwg use research --provider claude 等。维护命令：aiwg refresh 刷新上下文，aiwg doctor 诊断健康状态，npx aiwg doctor 无需调整 PATH。项目级扩展直接写在 .aiwg/{extensions,addons,frameworks}/<name>/ 下，由 aiwg use 自动发现，无需 fork。