Agent Skills
› SethGammon/Citadel
SethGammon/Citadel
GitHub根据产品需求文档或现有代码库，生成包含文件结构、组件分解、数据模型及分阶段构建计划的实施架构。支持新建与功能扩展模式，辅助后续开发执行。
Install All Skills
npx skills add SethGammon/Citadel --all -g -y
Skills in Collection (50)
根据产品需求文档或现有代码库，生成包含文件结构、组件分解、数据模型及分阶段构建计划的实施架构。支持新建与功能扩展模式，辅助后续开发执行。
收到已批准的产品需求文档(PRD)
用户提出明确的功能方向并关联现有代码库
需要制定详细的系统构建计划时
npx skills add SethGammon/Citadel --skill architect -g -y
Archon是多会话自主策略代理，负责将大型任务分解为阶段，委派子代理，审查输出并跨上下文窗口维护状态。适用于需要持久化、质量判断和战略分解的长期工作流。
大型任务需跨会话执行
需要多阶段分解与委派
长周期项目状态保持
npx skills add SethGammon/Citadel --skill archon -g -y
用于生成完美对齐的ASCII图表，如架构图、流程图等。通过程序化字符网格方法确保排版精确，适用于需在文本或Markdown中嵌入可视化结构图的场景。
需要生成架构或流程图等ASCII图表
需要在代码注释或纯文本中嵌入结构化图示
npx skills add SethGammon/Citadel --skill ascii-diagram -g -y
自动化处理待办事项从接收到交付的全流程。扫描、简报、构建和验证小中型任务，支持PR集成与状态追踪，适用于无需手动编排的标准化工作流。
需要自动处理 .planning/intake/ 中的待办项
执行从简报到代码提交的完整流水线
npx skills add SethGammon/Citadel --skill autopilot -g -y
用于查询和展示会话及活动的实际成本数据，包括令牌用量、燃烧率和模型细分。通过运行脚本读取实时遥测数据，支持按当前会话、天、周或特定活动过滤，提供精确的费用分析视图。
用户询问花费、成本、令牌使用量或燃烧率
执行 /cost 命令及其变体
npx skills add SethGammon/Citadel --skill cost -g -y
根据用户描述从零创建应用，涵盖空白项目、引导、模板、全自动生成及现有代码库功能添加五类场景。通过PRD、架构设计和Archon执行流程，确保端到端的应用构建与验证。
从零开始构建新应用
基于详细描述自动生成完整应用
在现有项目中添加新功能
npx skills add SethGammon/Citadel --skill create-app -g -y
通过访谈挖掘用户重复性工作流程，分析失败模式并生成可测试的生产级SKILL.md文件。用于将手动操作编码为自动化技能，不适用于一次性任务或修改现有技能。
用户希望自动化重复性工作流
用户要求创建新技能
npx skills add SethGammon/Citadel --skill create-skill -g -y
实现无人值守的持续自主运行模式，通过串联会话自动执行长期任务。支持本地循环和远程触发两种执行路径，具备预算控制、状态持久化和安全限制功能。
需要长时间后台运行的自动化任务
配置无人值守的连续工作流
npx skills add SethGammon/Citadel --skill daemon -g -y
提供 Harness 系统的实时可观测性仪表板，读取活动、会话、遥测和队列数据以展示系统状态。适用于查询项目动态、运行状况或查看近期活动快照的场景。
用户询问当前正在发生什么或系统状态
用户要求显示活动或仪表板
直接调用 /dashboard 命令
npx skills add SethGammon/Citadel --skill dashboard -g -y
将模糊想法转化为可追踪的决策地图，通过研究、原型和对话逐步厘清需求并解决阻塞问题。适用于工作尚未明确或规模较大的规划阶段，支持跨会话状态保持。
需求模糊不清需要梳理
任务过大无法直接执行
存在多个未解决的开放性问题
npx skills add SethGammon/Citadel --skill decision-map -g -y
主线上游部署管家，序列化并行PR落地流程。负责刷新PR状态、更新分支、等待CI检查、串行合并及执行部署命令，并在失败时自动创建修复任务，确保主分支安全稳定。
用户要求批量安全合并多个已就绪的PR
需要保持代理生成的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参考三种模式。通过检测现有风格并分析代码逻辑，生成符合规范且补充签名信息的注释或README，避免重复已知信息。
需要为文件或目录添加JSDoc/Docstring
需要编写或更新模块级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个以上可并行的任务场景。
需要并行处理多个独立工作流
任务可分解为无重叠文件范围的并发执行
npx skills add SethGammon/Citadel --skill fleet -g -y
一种在编码前通过单步提问澄清模糊需求的设计 elicitation 技能。自动触发于用户要求压力测试或需求不明确时，强制每次仅问一个问题并提供推荐答案，旨在消除歧义并生成明确决策记录供下游使用。
用户说 'grill me'
请求对计划进行压力测试
功能范围模糊不清
npx skills add SethGammon/Citadel --skill grill -g -y
跨盘存储审计与清理技能，扫描孤立Git工作树、AI工具缓存及构建产物，生成优先级迁移计划。适用于磁盘空间不足或需清理无用数据的场景，不用于项目结构整理。
磁盘空间不足
清理孤立Git工作树
释放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
从已完成的活动或演进周期中提取模式与决策，整合至项目知识库以复用经验。支持指定目标、增量编译及文档同步，避免孤立文件堆积。
用户询问如何整理已完成项目的经验教训
需要更新项目知识库中的最佳实践或反模式
npx skills add SethGammon/Citadel --skill learn -g -y
用于前端组件构建过程中的视觉验证，通过截图工具捕获页面状态，检测渲染错误、布局断裂及视觉回归问题，并自动修复或记录异常。
修改了 .tsx, .jsx, .vue, .svelte, .html 等视图层文件
创建或替换 UI 组件后
进行视觉重新设计时
npx skills add SethGammon/Citadel --skill live-preview -g -y
在当前会话中执行有界的前台重复循环，协调动作与验证器直至通过或达到最大尝试次数。用于代码修复、测试等需人工干预的迭代任务。
用户希望在当前会话中进行可见的重复直到通过的操作
需要重试某项操作并设置最大尝试次数
npx skills add SethGammon/Citadel --skill loop -g -y
代码库结构索引生成工具，构建文件、依赖及角色图谱，支持关键词查询与上下文切片注入，旨在降低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, what broke 等关键词
npx skills add SethGammon/Citadel --skill postmortem -g -y
本地PR自动修复助手，监控CI状态，通过读取失败日志自动应用针对性修复，并在检查通过后选择合并。作为Claude Code云自动修复的终端替代方案，支持指定PR号或当前分支。
需要监控PR的CI状态并自动修复失败的检查
在终端中进行PR自动化修复和合并操作
npx skills add SethGammon/Citadel --skill pr-watch -g -y
根据自然语言描述生成结构化产品需求文档，支持全新项目与功能新增两种模式。通过澄清问题、研究参考应用，定义范围、技术栈及架构，为后续开发提供规划基础。
用户描述要构建的新应用或功能
在启动新项目的 Archon 活动之前
npx skills add SethGammon/Citadel --skill prd -g -y
基于 Playwright 的浏览器端 QA 验证技能，自动启动应用并模拟用户操作（点击、填表等）以测试功能流程。支持检测环境、自动安装依赖及回退至截图验证，适用于功能构建后的交互与逻辑验证。
需要验证前端功能是否正常工作
执行自动化测试或质量保证流程
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输入，结合项目规范提供具体可执行的缺陷修复建议。
用户请求对特定文件或目录进行代码审查
用户请求对Git差异或提交历史进行审查
npx skills add SethGammon/Citadel --skill review -g -y
根据项目现有代码规范自动生成新文件。通过搜索同类示例提取命名、结构和导入导出等约定，生成符合项目风格的组件、模块或服务，并自动接入注册点。
需要创建新的前端组件或后端模块
希望新生成的代码完全符合项目现有编码规范
npx skills add SethGammon/Citadel --skill scaffold -g -y
管理定时任务，支持本地OS计划或远程Cron。默认使用本地脚本以节省配额，需用户确认；提供列表、删除功能及Codex自动化集成，确保任务持久化与安全。
设置重复任务
安排一次性运行
列出已调度任务
取消计划任务
npx skills add SethGammon/Citadel --skill schedule -g -y
用于在会话结束时将当前上下文（代码变更、决策、未决事项）合成为结构化 HANDOFF 块，以便跨会话转移上下文。支持自动触发，确保后续会话能无缝接续工作。
用户结束当前对话或会话
编排器（如 Archon, Fleet）在会话边界自动触发
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
根据项目现有测试框架和模式，自动生成并修复通过率的单元测试文件。覆盖正常路径、边界条件和错误路径，确保首次运行即通过，不修改源码。
为模块生成初始测试覆盖率
从0开始构建Happy path、Edge cases和Error paths测试
npx skills add SethGammon/Citadel --skill test-gen -g -y
GitHub Issue和PR调查技能，自动拉取并分类未标记问题或指定PR，搜索代码库定位根因，提出修复建议并可选实施。支持批量处理、陈旧问题检测及Codex集成审查。
用户请求调查GitHub Issue或PR
issue-monitor Hook报告新Issue
npx skills add SethGammon/Citadel --skill triage -g -y
用于安全移除 Citadel 插件的 Skill。通过生成无写入计划、获取确认令牌后执行精确卸载，并处理遗留导入与导出场景，确保操作可审计且不影响无关文件。
用户希望从项目中完全移除 Citadel
需要导出或清理插件残留配置
npx skills add SethGammon/Citadel --skill unharness -g -y
验证 Citadel hook 管道健康状态，通过执行实际工具调用并检查遥测数据变化，判断钩子是否正常触发及无错误。
hook 更新后验证
怀疑 hook 失效时
npx skills add SethGammon/Citadel --skill verify -g -y
文件哨兵技能，监控工作目录变更和标记注释，自动触发相应技能。通过轮询git diff检测变化，生成摄入项供批处理，并路由标记操作。适用于自动响应文件变更，不用于一次性检查。
用户希望自动响应文件变更
检测到@citadel:标记注释
npx skills add SethGammon/Citadel --skill watch -g -y
基于Markdown的LLM原生知识库技能，负责摄入原始资料、去重、整理主题文件并维护索引。支持通过自然语言查询获取答案，无需向量数据库，适用于构建和维护结构化知识体系。
需要构建或更新知识库
从多源素材中整理和去重信息
基于内部Wiki文档回答特定问题
检查知识库的健康状态或索引完整性
npx skills add SethGammon/Citadel --skill wiki -g -y
多仓库活动协调器，用于跨仓库（如前后端、基础设施）的协同开发。支持依赖分解、波次执行及上下文共享，适用于单体拆分或跨库基础设施添加等场景。
跨多个代码仓库进行协同开发
将单体应用拆分为微服务架构
添加涉及多个仓库的基础设施组件
npx skills add SethGammon/Citadel --skill workspace -g -y
该技能模板内容仅为占位符，未提供具体功能描述或操作指令。目前无法确定其实际用途、触发场景及所属领域，属于待填充的基础模板结构。
需要创建新的 Agent Skill
初始化技能模板
npx skills add SethGammon/Citadel --skill template-skill -g -y
