Cluster444/agentic

# Agentic [](https://www.npmjs.com/package/agentic-cli) [](https://opensource.org/licenses/MIT) **模块化 AI 代理与命令，用于配合 OpenCode 进行结构化软件开发。** ## 功能简介 Agentic 是一个上下文工程工具，旨在协助 [OpenCode](https://github.com/sst/opencode) 生成可靠的软件改进方案。 Agentic 是一个使用 OpenCode 进行 AI 辅助软件开发的工作流管理系统。它提供： * **上下文管理**：组织化的 "thoughts" 目录结构，用于存储架构文档、研究、计划和审查 * **模块化 AI 代理与命令**：预配置的提示词和专用子代理，通过任务分解和上下文压缩来增强 [OpenCode](https://github.com/sst/opencode) 的能力 * **结构化开发工作流**：分阶段的方法（研究 → 计划 → 执行 → 提交 → 审查）用于处理工单和功能 * **分发系统**：一个 CLI 工具，用于通过 `.opencode` 目录将代理/命令配置分发到项目中 ## 目的 该系统旨在： - 使 AI 辅助开发更加系统化和可重复 - 通过专用子代理减少上下文窗口的使用 - 长期维护项目知识（架构决策、研究、实施历史） - 通过结构化工作流为 AI 代理提供引导 ## 快速开始 ### 安装 #### 通过 bun/npm（推荐） ``` npm install -g agentic-cli # 或 bun add -g agentic-cli ``` #### 从源码安装 ``` git clone https://github.com/Cluster444/agentic.git cd agentic bun run build bun install bun link # Makes 'agentic' command available globally ``` ### 全局部署 这将把所有代理/命令拉取到你的全局 `~/.config/opencode/` 目录中。 ``` agentic pull -g ``` ### 部署到你的项目 这将把所有代理/命令拉取到本地的 `.opencode` 目录中。 ``` cd ~/projects/my-app agentic pull ``` ### 开发工作流 1. 使用 **ticket** 命令与代理协作，构建工单详情 2. 使用 **research** 命令根据工单详情分析代码库 3. 使用 **plan** 命令利用研究结果生成工单的实施计划 4. 使用 **execute** 命令实施更改 5. 使用 **commit** 命令提交你的工作 6. 使用 **review** 命令验证实施情况 在每个阶段之间，重要的是检查每个阶段的输出，并确保它实际上与你希望项目所做的一致，以及与项目的发展方向一致。这些文件中的错误会级联影响到下一阶段，并产生不是你想要的代码。 在 OpenCode 中，这些命令通过斜杠调用：`/ticket`、`/research`、`/plan`、`/execute` 等。 大多数这些命令都需要你想要审查的相关工单，例外是 ticket 本身，以及 commit/review。对于 ticket，你需要给出一个描述你试图做什么的实际提示词，而 commit/review 旨在你运行 execute 的上下文窗口中工作，以便它拥有流程本身如何进行的所有细节。 ## 文档 ### 入门指南 - [使用指南](./docs/usage.md) - 使用 Agentic 的完整指南 - [开发工作流](./docs/workflow.md) - 详细的流程阶段 ### 核心组件 - [Agentic CLI](./docs/agentic.md) - 命令行工具参考 - [命令](./docs/commands.md) - 可用的 OpenCode 命令 - [代理](./docs/agents.md) - 专用 AI 子代理 ### 项目结构 - [Thoughts 目录](./docs/thoughts.md) - 知识管理系统 - [架构文档](./docs/architecture.md) - 系统设计文档 ## 环境要求 - [Bun](https://bun.sh) 运行时 - [OpenCode](https://github.com/opencodeco/opencode) CLI - Git ## 贡献 该项目正在积极开发中。欢迎贡献、想法和反馈！ ## 许可证 MIT 许可证 - 详情请参阅 [LICENSE](./LICENSE) 文件

标签：Agentic Workflow, AI编程助手, Bun, Context Engineering, LLM辅助编程, OpenCode, RAG, TypeScript, 上下文工程, 代码生成, 任务分解, 安全可观测性, 安全插件, 提示词工程, 暗色界面, 模块化代理, 渗透测试工具, 版本控制, 知识管理, 研发效能, 策略决策点, 结构化开发, 网络安全研究, 自动化攻击, 软件开发, 项目脚手架