Agent Skills
› SethGammon/Citadel
SethGammon/Citadel
GitHub根据PRD或需求生成可执行的实施架构，包含文件树、组件分解、数据模型及分阶段构建计划。支持从零开始和现有代码库扩展两种模式，确保方案可直接由Agent执行。
Install All Skills
npx skills add SethGammon/Citadel --all -g -y
Skills in Collection (50)
根据PRD或需求生成可执行的实施架构，包含文件树、组件分解、数据模型及分阶段构建计划。支持从零开始和现有代码库扩展两种模式，确保方案可直接由Agent执行。
用户拥有已批准的PRD并需要架构设计
用户有明确方向且存在现有代码库需规划变更
接收到构建请求或规格说明书
npx skills add SethGammon/Citadel --skill architect -g -y
Archon是自主多会话策略代理，负责将大型工作分解为阶段，委派子代理执行，审查输出并跨会话维护状态。适用于需要持久化状态、质量判断和战略分解的多日或多轮任务。
需要跨多个会话完成的大型复杂任务
需要持续状态管理和分阶段执行的长期项目
npx skills add SethGammon/Citadel --skill archon -g -y
生成完美对齐的ASCII图表，支持架构、流程图等。采用程序化字符网格方法确保数学级对齐，避免依赖Token预测。包含布局规划与渲染后验证步骤。
需要生成文本/ASCII图表
要求图表在Markdown或代码注释中视觉对齐
npx skills add SethGammon/Citadel --skill ascii-diagram -g -y
自动化处理规划目录中的待办事项，从接收、简报到构建验证的完整流水线。自动扫描状态，为待定项生成简报，执行已批准任务并验证结果，最后输出处理报告。
用户询问或需要处理 .planning/intake/ 下的待办事项
用户指定某个 intake 文件或请求从 intake 到 PR 的交付流程
npx skills add SethGammon/Citadel --skill autopilot -g -y
用于探索和分析会话及活动成本的工具。通过读取实时Token使用量、花费和燃烧率数据，提供当前会话、今日、本周或特定活动的详细成本视图，支持模型拆分和缓存效率分析。
用户询问费用、花费或燃烧率
需要查看Token使用统计
执行/cost命令及其变体
npx skills add SethGammon/Citadel --skill cost -g -y
根据描述从零生成应用，支持空白、引导、模板、全自动及现有项目功能添加五类场景。通过PRD、架构设计与验证流程，实现从需求到代码的端到端自动化构建。
创建新项目或脚手架
构建特定类型应用
在现有代码库中添加功能
npx skills add SethGammon/Citadel --skill create-app -g -y
根据用户重复性工作流创建新的 SKILL.md。通过访谈挖掘任务、失败模式和成功标准，自动生成结构化技能文件并安装测试，用于编码可复用的自动化流程。
用户希望将重复性工作流程自动化或编码为技能
用户要求创建针对特定场景的新技能
npx skills add SethGammon/Citadel --skill create-skill -g -y
实现Campaign的持续自主运行模式，通过串联会话实现24/7无人值守执行。支持本地循环和远程触发两种路径，自动管理状态、预算及上下文耗尽后的调度与停止。
需要长时间无人值守运行任务
自动化连续执行Campaign流程
管理跨会话的持久化工作状态
npx skills add SethGammon/Citadel --skill daemon -g -y
提供项目实时状态的可观测性仪表盘，通过读取活动、会话遥测及队列数据生成快照。支持命令触发，展示阶段进度、成本及最近活动，帮助用户快速掌握系统运行状况。
用户询问当前状态或发生了什么
执行 /dashboard 命令
用户要求显示活动或仪表盘
npx skills add SethGammon/Citadel --skill dashboard -g -y
作为规划循环引擎，将模糊想法转化为可追踪的决策地图，通过逐个解决研究、原型或决策票证来推进工作，直到任务明确并移交自动执行。
想法存在未解决的开放性问题
工作过于模糊不适合直接启动活动
需要跨会话保持规划上下文
npx skills add SethGammon/Citadel --skill decision-map -g -y
主行部署管家，用于序列化并行代理工作。自动处理就绪PR的队列、刷新状态、等待CI检查、串行合并及部署，并在失败时创建修复任务，防止合并冲突。
批量合并已就绪的PR
保持分支与主干同步
执行安全串行部署
npx skills add SethGammon/Citadel --skill deploy-steward -g -y
用于生成和维护设计清单，确保视觉一致性。支持从现有项目提取样式或为新项目生成初始配置，并通过后编辑钩子标记偏差。
新项目启动需要设计风格
现有项目缺乏设计规范
发现视觉不一致问题
npx skills add SethGammon/Citadel --skill design -g -y
统一意图路由器，自动将用户请求分类并路由至最合适的执行路径（命令、技能或编排器），提供状态查看、操作控制台及技能注册等功能。
用户不确定使用哪个工具时
需要查看系统状态或仪表盘
需要列出可用技能
需要进行项目初始化配置
npx skills add SethGammon/Citadel --skill do -g -y
自动为代码生成文档的助手，支持函数级、模块级和API参考三种模式。能识别项目现有文档风格，仅对非平凡逻辑补充语义信息，避免重复签名内容，确保文档质量与一致性。
需要为代码文件添加JSDoc或docstrings注释
需要编写或更新模块目录的README文档
需要生成HTTP API端点或库导出的参考文档
npx skills add SethGammon/Citadel --skill doc-gen -g -y
自主改进导演技能，通过多周期循环假设验证与实验攻击，持续优化目标质量。构建信念模型与模式库，支持跨会话知识积累与复用，直至达到性能上限或预算耗尽。
需要持续的自主质量提升
希望建立跨周期的信念模型和可复用模式
npx skills add SethGammon/Citadel --skill evolve -g -y
自动化指标优化循环，通过隔离工作区提议修改、测量指标并保留改进，支持收敛检测与收益递减判断。
用户希望自动优化代码以提升特定指标（如构建体积、错误数）
需要基于量化反馈进行多轮迭代式代码调优
npx skills add SethGammon/Citadel --skill experiment -g -y
并行活动协调器，用于在孤立工作树中同时运行多个独立任务流。通过波次执行、隔离代理和上下文共享，高效处理可分解为3个以上并行流的复杂工作。
需要并行处理多个独立开发任务
工作可分解为3个以上无依赖的流
需要多代理协同完成大规模重构或功能开发
npx skills add SethGammon/Citadel --skill fleet -g -y
作为需求澄清引擎，通过单次追问和推荐答案，将模糊计划转化为清晰共识。在编码前触发，辅助规划技能明确范围，避免重复造轮子。
用户说 'grill me'
要求压力测试或审查模糊的计划/设计
启动范围不确定的新功能
npx skills add SethGammon/Citadel --skill grill -g -y
跨盘存储审计与清理工具，扫描磁盘空间、孤立Git工作树及AI工具缓存，生成迁移命令以释放磁盘。
磁盘空间不足
需要清理孤立的工作树
AI工具缓存膨胀
npx skills add SethGammon/Citadel --skill houseclean -g -y
基于评分标准对目标进行迭代式自主质量改进，包含评分、攻击薄弱点、验证及循环机制，支持战役模式与断点续传。
需要按评分标准迭代优化产品或代码
启动自主质量改进循环
恢复之前的质量改进战役
npx skills add SethGammon/Citadel --skill improve -g -y
扫描项目配置文件，识别数据库、缓存、队列等基础设施组件及其连接关系，生成结构化清单并提示缺失层。适用于理解现有架构或新增服务前的审计。
需要梳理项目当前使用的中间件和外部服务
对新代码库进行基础设施层面的快速上手
在添加新组件前评估现有架构完整性
npx skills add SethGammon/Citadel --skill infra-audit -g -y
将已完成的活动或演进周期中的模式、决策及反模式提取并编译为结构化 Wiki 页面，整合至现有知识库而非孤立文件，支持自动触发与多种输入形式。
用户拥有已完成的活动或演进周期并希望汇总经验
通过 /postmortem 或 /evolve Phase 6 自动触发
npx skills add SethGammon/Citadel --skill learn -g -y
通过构建时截图验证前端组件视觉渲染，检测回归与不可见特性。自动检测UI文件变更，使用Playwright等工具捕获页面截图，人工或AI核对布局、数据及设计匹配度，修复渲染失败问题并保存验证产物。
修改了 .tsx, .jsx, .vue, .svelte, .html 等视图层文件
完成组件创建或替换后
进行视觉重设计期间
Agent代理UI工作时
npx skills add SethGammon/Citadel --skill live-preview -g -y
在当前会话内执行有界的前台重复循环，通过定义动作和显式验证器，在达到最大尝试次数前自动重试直至通过，并记录执行证据。
需要当前会话内重复执行某操作直到成功
用户明确要求进行有限次数的重试循环
npx skills add SethGammon/Citadel --skill loop -g -y
代码库结构索引生成工具，构建文件、依赖图及角色信息的JSON索引，支持关键词查询与上下文切片注入，旨在降低Token消耗并加速代码导航。
初始化不熟悉的项目结构
需要快速定位相关文件
为Agent提供结构化代码上下文
npx skills add SethGammon/Citadel --skill map -g -y
会话指挥官，用于处理单会话内多步骤、跨技能且需调查的复杂任务。自动解析意图、规划执行链并调用相关技能，最终输出结构化报告。
需要跨多个技能协作完成的任务
单次会话内可完成的复杂多步工作
需要调查后执行的混合任务
npx skills add SethGammon/Citadel --skill marshal -g -y
审查Fleet工作区合并队列，检测文件级冲突与重叠变更，评估风险并推荐安全合并顺序及冲突解决计划。
审查待处理的Fleet分支合并
检查合并队列中的文件冲突
确定多分支同时修改的安全合并顺序
npx skills add SethGammon/Citadel --skill merge-review -g -y
用于管理仓库目录结构、文件命名及存放位置的技能。自动检测项目规范，审计文件合规性，并执行移动计划以更新导入路径，确保代码库布局整洁一致。
决定文件归属位置
审计文件放置是否符合约定
运行命名规范清理
移动文件以匹配声明的布局
npx skills add SethGammon/Citadel --skill organize -g -y
自动生成交接复盘报告，分析项目失败原因、安全系统拦截情况及模式。通过收集战役文件、遥测数据和Git历史，识别问题与漂移，输出结构化文档。
用户询问发生了什么或什么出错了
完成调试会话后
收到postmortem或retro指令
npx skills add SethGammon/Citadel --skill postmortem -g -y
本地PR自动修复工具，监控CI状态，通过读取失败日志应用针对性修复，并在检查通过后选择合并。作为Claude Code云端自动修复的终端替代方案。
需要监控PR的CI状态
自动修复失败的CI检查
在终端中进行PR自动化流程
npx skills add SethGammon/Citadel --skill pr-watch -g -y
根据自然语言描述生成产品需求文档（PRD），支持新建应用和现有功能两种模式。通过澄清问题、参考研究和定义范围，输出结构化文档以指导后续开发。
用户描述要构建的新应用或功能
在 Archon 项目启动前需要明确需求
npx skills add SethGammon/Citadel --skill prd -g -y
基于 Playwright 的浏览器自动化 QA 技能，支持启动应用、模拟用户交互（点击、填表）及验证功能流程。具备依赖检测与回退机制，适用于 Web 应用的功能测试与发布前验证。
构建功能后验证实际运行效果
路由包含 qa、test the app、does it work 等指令
需要验证页面交互和用户流程
npx skills add SethGammon/Citadel --skill qa -g -y
提供安全的跨文件重构能力，支持重命名、提取、内联、移动、拆分和合并等操作。通过建立类型/测试基线、详细规划及逐文件执行，确保零回归并具备自动回滚机制。
需要跨文件重命名符号或模块
从现有代码中提取函数或组件
将大文件拆分为更小单元
合并相关文件
调整文件位置并更新导入
npx skills add SethGammon/Citadel --skill refactor -g -y
该技能已弃用，仅作为重定向存根。不再执行实际研究任务，而是将调用直接转发至 /research --parallel 模式进行并行多侦察员研究。
用户尝试使用已弃用的 research-fleet 命令
系统检测到对旧版并行研究接口的直接调用
npx skills add SethGammon/Citadel --skill research-fleet -g -y
用于将技术问题转化为结构化研究结果，包含置信度和来源引用。支持单代理或并行模式，旨在收集外部信息以辅助决策，不直接执行操作。
评估依赖版本或替代方案
查找社区最佳实践
阅读官方API文档
调查类似问题的解决方案
npx skills add SethGammon/Citadel --skill research -g -y
执行五遍结构化代码审查，涵盖正确性、安全性、性能、可读性和一致性。支持文件、目录或Git diff范围输入，依据项目规范输出具体可操作的发现报告。
需要审查代码逻辑错误
检查潜在安全漏洞
评估代码性能与可读性
npx skills add SethGammon/Citadel --skill review -g -y
根据项目现有代码规范生成新文件，自动识别命名、结构及导入导出模式，确保新代码与项目风格一致。
需要创建新的组件、模块或服务
要求新生成的文件符合项目既定的编码规范和目录结构
npx skills add SethGammon/Citadel --skill scaffold -g -y
管理定时任务，支持本地Cron和远程CronCreate。默认使用本地脚本以节省配额，提供添加、列表、删除功能，并区分会话内循环与后台调度场景。
设置定时任务
安排重复工作
cron表达式配置
列出已调度任务
取消计划任务
npx skills add SethGammon/Citadel --skill schedule -g -y
用于在会话结束时将当前上下文（变更、决策、未决项）结构化为 HANDOFF 块，以便跨会话无缝转移工作上下文。
结束当前开发会话需要保存进度时
编排器需要在会话边界自动转移上下文时
npx skills add SethGammon/Citadel --skill session-handoff -g -y
用于新项目的初始配置，自动检测技术栈、安装钩子、生成配置文件并支持从归档恢复历史数据。提供推荐、全览和快速三种模式，帮助用户快速上手系统。
首次运行项目初始化
需要恢复旧版项目归档数据
npx skills add SethGammon/Citadel --skill setup -g -y
提供四阶段系统化调试流程：观察、假设、验证、修复。强调在修改代码前必须先定位根因，防止盲目修补和错误连锁反应，包含紧急停止规则以应对多次修复失败的情况。
根因未知且频繁修复失败
需要系统性排查深层Bug
npx skills add SethGammon/Citadel --skill systematic-debugging -g -y
统一遥测中心，提供会话成本、花费统计、钩子活动及信任等级查询，支持遥测开关控制与阈值调整。
询问系统追踪内容或遥测详情
查询会话成本或总花费
关闭或开启遥测功能
查看钩子活动或触发记录
npx skills add SethGammon/Citadel --skill telemetry -g -y
根据项目现有测试框架和风格，自动生成单元测试文件。覆盖正常路径、边界条件和错误路径，并自动运行修复直至通过，确保测试套件无失败。
为新模块生成初始测试用例
指定文件或目录生成完整测试覆盖
npx skills add SethGammon/Citadel --skill test-gen -g -y
GitHub Issue 和 PR 调查工具，用于自动拉取、分类未标记问题，分析代码根因并提出修复方案。支持单条或批量处理，集成 Codex 进行 PR 审查，辅助开发者快速定位和解决 GitHub 上的技术问题。
需要排查 GitHub Issue 根本原因
需要对 PR 进行代码审查
批量整理未标记的开放 Issue
查找长期无活动的过期 Issue
npx skills add SethGammon/Citadel --skill triage -g -y
用于安全移除 Citadel 插件的 Skill。通过读取采纳凭证生成不可变删除计划，执行精确文件清理并保留归档，确保无副作用退出。
用户希望完全移除项目中的 Citadel
需要导出 Citadel 状态但不删除文件
npx skills add SethGammon/Citadel --skill unharness -g -y
用于在实时会话中自测 Citadel Hook 管道健康状态。通过执行 Write、Edit、Bash 等工具调用，检查 Telemetry 数据增长及错误日志，验证 Hooks 是否正常触发并报告 PASS/FAIL 结果。
Hook 更新后需要快速验证
怀疑工具响应慢或质量门未触发
新项目安装 Citadel 后初始化检查
npx skills add SethGammon/Citadel --skill verify -g -y
文件哨兵技能，监控工作目录变更及标记注释，自动触发相应任务。支持本地轮询与远程定时扫描，用于自动化响应文件变化，不适用于一次性检查或需人工判断的场景。
用户希望自动响应文件变更
需要监控特定路径并触发后续动作
npx skills add SethGammon/Citadel --skill watch -g -y
基于Markdown的原生知识库技能，负责摄入原始素材、自动去重合并、维护主题文件及索引。支持通过LLM进行结构化导航与查询，无需向量数据库，适用于构建和维护项目知识体系。
需要构建或查询基于Markdown的知识库
摄入新资料并自动整理到知识库中
检查知识库健康状态或重建索引
npx skills add SethGammon/Citadel --skill wiki -g -y
多仓库活动协调器，用于跨多个仓库的复杂变更管理。支持基础设施扩展、微服务拆分等场景，通过分波次执行和共享上下文协调依赖关系，确保跨库协作的一致性。
跨仓库添加基础设施
前后端及基础架构协同变更
单体应用拆分为微服务
npx skills add SethGammon/Citadel --skill workspace -g -y
这是一个空模板，尚未定义具体用途、触发场景或执行逻辑。需填充实际指令后方可使用。
npx skills add SethGammon/Citadel --skill template-skill -g -y
