Agent Skills
› SethGammon/Citadel
SethGammon/Citadel
GitHub基于PRD或现有代码库生成实施架构，包括文件树、组件分解、数据模型及分阶段构建计划。支持从零开始和特性模式，通过多候选评估关键决策，为执行提供明确终点条件。
Install All Skills
npx skills add SethGammon/Citadel --all -g -y
Skills in Collection (50)
基于PRD或现有代码库生成实施架构，包括文件树、组件分解、数据模型及分阶段构建计划。支持从零开始和特性模式，通过多候选评估关键决策，为执行提供明确终点条件。
收到PRD后需要制定实施架构
用户有清晰方向且存在现有代码库
收到构建请求并需规划方案
npx skills add SethGammon/Citadel --skill architect -g -y
Archon是多会话自主策略代理，用于将大型任务分解为阶段，委派子代理，审查输出并维护跨上下文窗口的活动状态，适用于需持久化、质量判断和战略分解的长期工作。
需要跨多个会话执行的复杂任务
需要持久化状态的大型项目
需要战略分解和多代理协作的工作流
npx skills add SethGammon/Citadel --skill archon -g -y
用于生成完美对齐的 ASCII 图表，包括架构图、流程图等。通过程序化字符网格确保对齐精度，支持多种边框样式和布局方向，适用于需要在文本或代码注释中嵌入可视化图表的场景。
用户需要生成 ASCII 风格的架构图、流程图或序列图
要求以纯文本形式嵌入 Markdown 或代码注释中的图表
对图表视觉对齐有严格要求的场景
npx skills add SethGammon/Citadel --skill ascii-diagram -g -y
自动化处理 .planning/intake/ 目录中的待办项，执行从需求简报、代码构建到验证交付的全流程管道，适用于范围明确的小型或中型任务。
需要自动处理待开发的任务清单
用户请求将 intake 项目转换为 PR
npx skills add SethGammon/Citadel --skill autopilot -g -y
会话与活动成本探索工具，提供实时Token用量、费用及燃烧率。通过运行脚本读取原始数据并渲染报告，支持按当前会话、今日、本周、指定活动或全生命周期进行成本分析。
查询当前会话成本
查看今日/本周花费
分析特定活动预算
询问费用、Token用量或燃烧率
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
实现全天候自主运行模式，通过链式会话自动延续营销活动。默认使用本地Runner节省配额，支持RemoteTrigger远程触发，具备状态恢复、预算控制和自动停止功能。
需要长时间无人值守运行任务
自动化连续执行营销活动
npx skills add SethGammon/Citadel --skill daemon -g -y
提供实时系统可观测性仪表盘，读取活动、会话遥测和队列状态。支持通过命令或自然语言触发，自动收集项目状态并生成快照报告。
用户询问当前系统状态或正在发生的事情
使用 /dashboard 或 /do status 等特定命令
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
生成和维护设计清单以确保持久视觉一致性。支持从现有项目提取样式或为新项目生成基础配置，并自动标记偏离设计的代码。
新项目初始化需要设计规范
现有项目缺少统一的设计语言文档
发现UI组件视觉风格不一致
用户请求生成设计清单或风格指南
npx skills add SethGammon/Citadel --skill design -g -y
/do 是统一意图路由器，自动将用户请求分类并路由至最合适的执行路径（如直接命令、技能或编排器），支持状态查询、设置向导及技能列表展示。
用户希望完成某项任务但不确定使用哪个工具
需要查看系统状态或操作控制台
首次运行配置项目环境
npx skills add SethGammon/Citadel --skill do -g -y
自动化代码文档生成工具，支持函数、模块和API参考三种模式。自动检测项目文档风格，分析代码逻辑后生成补充性注释或README，避免重复签名信息，保持风格一致。
需要为特定文件或目录添加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
作为需求澄清引擎，通过单次提问和推荐答案的方式，将模糊的计划或设计转化为清晰的共识。在编码前辅助prd等技能明确范围，触发条件包括用户主动请求或计划不明确时。
用户说'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
用于审计项目基础设施配置，扫描Docker、数据库、缓存及外部API等组件，追踪连接关系并生成结构化清单，辅助理解系统架构和规划变更。
需要理解不熟悉代码库的基础设施组成
在添加新数据库或中间件前评估现有架构
询问项目依赖的外部系统和内部服务
npx skills add SethGammon/Citadel --skill infra-audit -g -y
知识编译器，从已完成的活动或演进周期中提取模式与决策，整合至项目Wiki以积累知识。支持自动触发、增量编译及文档同步，避免孤立文件。
用户有已完成的活动或演进周期需要总结
执行 /postmortem 后需要整理知识
npx skills add SethGammon/Citadel --skill learn -g -y
通过截图工具在构建过程中对UI组件进行视觉验证，自动检测渲染异常、布局错误及视觉回归问题，并尝试修复，确保前端界面正确显示。
修改了 .tsx, .jsx, .vue, .svelte 等视图层文件后
创建或替换UI组件时
进行视觉重设计活动时
npx skills add SethGammon/Citadel --skill live-preview -g -y
提供当前会话内有界的前台循环执行能力，支持定义动作与验证器，自动重试直至通过或达到上限，并记录执行证据。适用于需要可见的重复尝试且无需后台守护进程的场景。
用户需要在当前会话中重复执行某项操作直到通过验证
用户希望限制最大尝试次数并停止失败的循环任务
npx skills add SethGammon/Citadel --skill loop -g -y
代码库结构索引生成器，构建文件、依赖和角色的紧凑JSON映射。用于快速概览、关键词搜索及向Agent注入上下文切片，降低Token消耗。
初始化不熟悉的项目结构
需要快速定位相关文件而不进行全文搜索
为Agent集群提供代码上下文切片
npx skills add SethGammon/Citadel --skill map -g -y
作为会话指挥官，自动编排技能链处理多步骤、跨领域任务。通过理解意图、规划执行链并调用子技能，实现从代码审计到修复验证的全流程自动化，适用于单次会话内的复杂工作。
需要多步骤协作的复杂任务
跨越多个技能但无需持久化的工作
npx skills add SethGammon/Citadel --skill marshal -g -y
审查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自动修复
已安装triage但希望在终端继续处理
npx skills add SethGammon/Citadel --skill pr-watch -g -y
根据自然语言描述生成结构化产品需求文档（PRD）。支持新建应用和现有项目新增功能两种模式，通过澄清问题、参考研究和定义范围，产出包含技术决策的PRD，为后续开发提供依据。
用户描述要构建的新应用或功能
在启动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
专注外部信息调研，将问题转化为结构化发现，包含置信度和来源引用。支持单代理或并行模式，用于评估依赖、查阅文档及最佳实践，为决策提供依据。
需要查询官方文档或社区最佳实践
评估技术选型或依赖版本变更
调查代码库中已知问题的解决方案
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
管理定时任务，支持本地OS级或远程Cron创建、列表及删除。默认使用本地脚本以节省配额，可选Codex自动化路径，适用于需跨会话持久化的周期性或一次性任务调度。
安排定期运行任务
设置一次性提醒
列出已调度的任务
取消定时任务
配置cron表达式
npx skills add SethGammon/Citadel --skill schedule -g -y
用于在会话结束时将当前上下文（代码变更、决策、未决事项）合成为结构化交接块，以便无缝转移至下一会话。
结束开发会话
需要上下文转移
npx skills add SethGammon/Citadel --skill session-handoff -g -y
用于新项目首次配置Citadel框架，自动安装钩子、检测技术栈、生成配置文件并可选运行演示。支持推荐、全览和快速三种模式，并可恢复历史归档数据。
新项目首次初始化配置
需要重新配置或更新现有设置
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调查工具，自动拉取、分类问题，搜索代码库定位根因或审查PR，提出修复建议并可选实施。
调查未标记的GitHub Issue
审查特定PR
批量处理开放Issue
npx skills add SethGammon/Citadel --skill triage -g -y
用于安全移除Citadel插件，基于所有权收据生成无写入审查计划，保留便携归档并精确清理。
用户希望从项目中移除Citadel
执行插件卸载或退出操作
npx skills add SethGammon/Citadel --skill unharness -g -y
对Citadel Hook管道进行自测，通过执行Write、Edit等工具调用并检查遥测数据，验证Hook是否正常触发且无错误，输出健康报告。
Hooks更新后需要现场 Sanity Check
怀疑工具响应慢或质量门未触发
新项目安装Citadel后验证
npx skills add SethGammon/Citadel --skill verify -g -y
文件哨兵技能，通过轮询监控工作目录变更及标记注释，自动触发相应操作。支持本地与云端持久轮询模式，用于实现基于文件变化的自动化响应流程。
用户希望自动响应文件变更时
需要监控特定路径的文件改动
npx skills add SethGammon/Citadel --skill watch -g -y
LLM原生Markdown知识库技能，支持源文件摄入、主题整理、交叉链接及索引维护，无需向量数据库即可实现结构化知识检索与问答。
构建基于Markdown的知识库
摄入原始笔记并去重
查询知识库以获取答案
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
