Agent Skills
› SethGammon/Citadel
SethGammon/Citadel
GitHub基于PRD或现有代码库，生成包含文件树、组件分解、数据模型及分阶段构建计划的实现架构。支持绿色field与特性模式，对关键决策进行多方案评估，输出可执行的构建蓝图。
Install All Skills
npx skills add SethGammon/Citadel --all -g -y
Skills in Collection (50)
基于PRD或现有代码库，生成包含文件树、组件分解、数据模型及分阶段构建计划的实现架构。支持绿色field与特性模式，对关键决策进行多方案评估，输出可执行的构建蓝图。
收到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
自动化处理规划流水线中的待办事项，通过扫描、简报、构建和验证流程，将需求转化为交付物。适用于范围明确的小中型任务，实现从 intake 到 PR 的端到端执行。
需要自动化处理 .planning/intake/ 下的待办项
请求将 intake 项目转换为 PR 或进行批量构建
npx skills add SethGammon/Citadel --skill autopilot -g -y
通过读取本地脚本和遥测数据，提供会话、按日/周/全部及特定活动的深度成本探索与透明度报告，展示Token用量、花费、燃烧率及模型明细。
查询当前会话或历史周期的Token消耗与费用
询问花费、燃烧率、预算使用情况
需要查看具体活动的成本归属
npx skills add SethGammon/Citadel --skill cost -g -y
根据用户描述创建应用的全流程技能，支持从空白脚手架到全自动生成及现有项目功能添加的五种模式，涵盖需求、架构设计与执行验证。
从零开始构建新应用
基于详细描述自动生成完整应用
为现有代码库添加新功能
npx skills add SethGammon/Citadel --skill create-app -g -y
用于将用户重复性工作流程转化为可复用的 Agent Skill。通过访谈发现任务模式，分析失败场景，生成并测试标准化的 SKILL.md 文件，实现工作流的自动化编码。
用户希望自动化重复性任务
用户要求创建新的 Skill
用户提到‘我反复做这件事’
npx skills add SethGammon/Citadel --skill create-skill -g -y
提供持续自主运行模式，通过链式会话实现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
需要自动更新分支并等待CI通过后部署
npx skills add SethGammon/Citadel --skill deploy-steward -g -y
生成并维护设计清单以确保视觉一致性。支持从现有项目提取样式或为新项目生成初始配置，并通过后编辑钩子检测偏离行为。
新项目启动需建立设计规范
现有项目无设计清单需提取模式
发现视觉不一致问题
执行 design、style guide 等指令
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
基于标量指标的自动化优化循环，在隔离环境中提出变更、对比基线并保留验证通过的候选方案，支持收敛检测与边际收益分析。
需要优化可量化指标如包体积或错误率
存在多个技术方案需通过数据对比验证优劣
手动A/B测试效率低或易出错
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工具缓存及构建产物，生成迁移命令。适用于磁盘空间不足或需清理冗余数据场景。
磁盘空间不足
需要清理孤立的工作树
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 后需要归档知识
需要更新项目Wiki以集成新发现
npx skills add SethGammon/Citadel --skill learn -g -y
通过构建中截图验证UI组件视觉正确性，自动检测渲染异常、布局断裂及不可见功能，支持Playwright/Puppeteer，实现可视化回归测试与即时修复。
前端视图文件修改后
组件创建或替换时
视觉改版期间
需要验证UI渲染状态时
npx skills add SethGammon/Citadel --skill live-preview -g -y
在当前会话内执行有界的前台重复循环，协调动作与验证器直至通过或达到尝试上限。用于轻量级迭代修复，如代码检查或测试重试，并记录过程证据。
用户需要在当前会话中重复执行某项操作直到成功
用户要求对特定命令进行有限次数的重试以验证结果
npx skills add SethGammon/Citadel --skill loop -g -y
生成代码库结构索引，支持文件、依赖和角色分析。用于快速概览、关键词搜索及向Agent注入上下文切片，降低Token消耗。
需要熟悉陌生代码库结构
需要基于关键词快速定位相关文件
需要为Agent提供结构化代码上下文
npx skills add SethGammon/Citadel --skill map -g -y
Marshal是会话级元编排器，用于处理单会话内多步骤、跨技能且需先调研后执行的复杂任务。它自动解析意图、规划执行链、调用相关技能并生成报告，仅在无法推进时询问用户，适合单一会话内的综合开发工作流。
需要多步骤协调的复杂任务
跨越多个技能但无需持久化存储的任务
需要先调查再行动的综合性任务
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
自动从活动文件、遥测日志和版本控制历史中收集数据，生成结构化的事后分析报告。用于分析故障原因、安全系统拦截情况及模式，支持手动触发或活动结束后自动生成。
活动完成后需要结构化分析
用户询问发生了什么或什么出错了
输入包含 postmortem, retro, what broke, what happened
困难调试会话后
npx skills add SethGammon/Citadel --skill postmortem -g -y
本地PR自动修复工具，监控CI状态，通过读取失败日志应用针对性修复，并在检查通过后选择合并。适用于终端内自动化处理PR CI问题，替代云端功能。
需要监控特定PR的CI状态
希望自动修复失败的CI检查并尝试合并
npx skills add SethGammon/Citadel --skill pr-watch -g -y
根据自然语言描述生成产品需求文档，支持新建应用和现有功能扩展两种模式。通过澄清问题、研究参考应用及定义技术栈，产出结构化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 输入，输出具体可操作的发现与结论。
需要人工或 AI 辅助进行代码质量审查
检查提交内容的逻辑错误与安全漏洞
npx skills add SethGammon/Citadel --skill review -g -y
基于项目现有代码规范（命名、结构、导入等）生成符合约定的新文件，并自动注册到项目中。适用于创建组件、模块、服务等已有先例的新增场景。
需要生成新的代码文件且项目中有同类示例
要求新生成的代码严格遵循项目现有的编码规范和目录结构
npx skills add SethGammon/Citadel --skill scaffold -g -y
管理定时任务，支持本地OS计划任务和云端Cron。默认使用本地脚本以节省配额，需用户确认后才调用远程API。
设置重复或一次性任务
列出已调度任务
取消定时任务
npx skills add SethGammon/Citadel --skill schedule -g -y
将当前会话内容综合为结构化交接块，用于在不同会话间转移上下文。捕获已构建内容、关键决策及未决事项，确保后续会话能准确接续工作，避免重复审计或无关探索。
会话结束需要保留上下文
编排器在会话边界自动触发
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
统一遥测中心，用于查询会话成本、累计花费、Hook活动及信任等级，支持查看遥测命令目录并开关遥测功能或调整阈值。
询问系统追踪了哪些遥测数据
查询当前或历史会话的成本
要求关闭或开启遥测功能
查看 Hook 触发活动
检查信任等级
直接调用 /telemetry
npx skills add SethGammon/Citadel --skill telemetry -g -y
自动生成并验证测试用例，覆盖正常、边界及错误路径。自动识别项目测试框架与风格，生成通过且无红色的测试文件，仅 Mock 外部依赖。
为新模块生成初始测试覆盖
对指定文件或目录生成单元测试
npx skills add SethGammon/Citadel --skill test-gen -g -y
GitHub Issue和PR调查员，自动拉取、分类未标记Issue与PR，搜索代码库定位根因，提出修复方案并可选实施。支持批量处理、陈旧问题检测及Codex集成审查，辅助GitHub问题排查与PR评审。
需要调查GitHub Issue或PR时
批量分类未标记Issue时
检测陈旧无活动Issue时
结合issue-monitor钩子处理新Issue时
npx skills add SethGammon/Citadel --skill triage -g -y
用于安全卸载Citadel插件的技能，通过接收证验证所有权，生成不可变删除计划并需用户确认执行。支持遗留导入、导出归档及完整性校验，确保仅移除确切拥有的文件。
用户希望从项目中完全移除Citadel
需要生成Citadel的离线归档备份
处理Citadel遗留安装的清理与导入
npx skills add SethGammon/Citadel --skill unharness -g -y
用于验证 Citadel Hook 管道健康状态的自测技能。通过执行文件读写等工具调用，检查遥测数据增长和错误日志，确保 Hooks 正常触发且无异常，输出 PASS/FAIL 结果及详细排查建议。
Hooks 最近更新后需要现场 sanity check
怀疑工具响应慢或质量门未触发
新项目安装 Citadel 后
npx skills add SethGammon/Citadel --skill verify -g -y
文件哨兵技能，监控工作目录变更及标记注释，自动触发相应技能。支持本地轮询与云端定时任务，用于自动化响应文件变化，不适用于单次检查或需人工判断的场景。
用户希望自动响应文件更改时
检测到文件路径变化或包含@citadel:标记注释时
npx skills add SethGammon/Citadel --skill watch -g -y
LLM原生Markdown知识库技能，负责源数据摄入、去重、主题编译与交叉链接，通过结构化索引实现知识检索与维护，无需向量数据库。
构建或查询基于Markdown的知识库
摄入原始笔记并去重
根据Wiki内容回答特定问题
npx skills add SethGammon/Citadel --skill wiki -g -y
跨仓库活动协调器，用于在多个依赖的仓库间分解任务、管理版本及执行波次工作。适用于涉及基础设施扩展、多端协作或单体拆分的复杂场景，确保跨仓库上下文一致与契约合规。
需要在多个仓库间协调变更
拆分单体应用为独立服务
添加跨仓库的基础设施或共享API
npx skills add SethGammon/Citadel --skill workspace -g -y
这是一个通用模板技能，内容为占位符指令，尚未定义具体功能、触发场景或任务目标，需补充实际描述后方可使用。
需要创建新的 Agent Skill
初始化技能模板
npx skills add SethGammon/Citadel --skill template-skill -g -y
