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图表
要求文本可视化且对视觉对齐有严格要求
npx skills add SethGammon/Citadel --skill ascii-diagram -g -y
自动化处理 .planning/intake/ 目录中的待办事项，执行从需求简报、代码构建到验证交付的全流程流水线，适用于范围明确的小型或中型开发任务。
需要自动化处理待开发的特性或任务
有文件放入 .planning/intake/ 目录等待执行
希望无需人工编排地推进小中型开发工作
npx skills add SethGammon/Citadel --skill autopilot -g -y
提供会话与活动成本探索功能，展示真实Token用量、费用及燃烧率。通过读取原生会话数据和脚本获取精确数字，支持按当前会话、今日、本周、特定活动或历史全量维度进行成本查询与分析。
用户询问花费、成本、Token使用情况或燃烧率
使用 /cost 命令及其变体（如 today, week, campaign）
npx skills add SethGammon/Citadel --skill cost -g -y
根据用户描述自动将应用创建需求分为五类，从空白脚手架到全自动生成及现有代码库功能添加。通过PRD、架构设计和验证流程，实现端到端的应用构建。
用户希望从零开始创建新应用
需要为现有项目添加新功能
提供详细的应用描述以自动生成
npx skills add SethGammon/Citadel --skill create-app -g -y
通过访谈挖掘用户重复性工作流程，分析失败模式与质量要求，自动生成并安装经过测试的标准化 SKILL.md 文件，帮助用户将经验编码为可复用的自动化技能。
用户希望将重复性工作流自动化或编码为技能
用户明确要求创建新的 Skill
npx skills add SethGammon/Citadel --skill create-skill -g -y
实现持续自主运行模式，通过链式会话自动执行长期任务。支持本地循环与远程触发两种路径，管理状态、预算及配额限制，适用于夜间或无人值守场景。
需要长时间无人值守运行的任务
自动化连续执行多个会话的流水线
npx skills add SethGammon/Citadel --skill daemon -g -y
提供项目实时可观测性仪表盘，聚合活动、遥测和成本数据。支持命令触发或自然语言查询，用于快速掌握项目状态和活跃度。
用户询问当前状态或正在发生的事情
使用/dashboard命令或类似短语如'show activity'
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
生成并维护设计清单以确保持视觉一致性。支持从现有代码提取样式或为新项目生成初始配置，并通过后编辑钩子检测偏离规范的设计偏差。
新项目启动需初始化设计风格
现有项目无设计文档需提取样式
发现界面视觉不一致问题
用户指令包含 design, style guide 等关键词
npx skills add SethGammon/Citadel --skill design -g -y
统一意图路由器，自动将用户请求分类并路由至最合适的执行路径（如直接命令、技能或编排器），支持状态查询、设置及技能列表管理。
用户希望完成某事但不确定使用哪个工具
需要查看系统状态或仪表盘
npx skills add SethGammon/Citadel --skill do -g -y
智能文档生成工具，支持函数、模块及API参考三种模式。自动检测项目文档风格，仅补充签名外的语义信息，避免冗余，适用于代码注释、README编写及接口文档生成。
为指定文件或目录添加JSDoc或docstrings
生成或更新模块级README.md
生成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
一种在编码前通过单轮问答澄清模糊需求的技能，自动触发于需求不明确时，提供推荐答案并深挖决策点。
用户说 '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 知识库。支持增量更新、冲突标记及语义记忆编译，避免孤立文件堆积，提升后续会话效率。
需要汇总项目经验教训时
完成活动或演化周期后
希望优化知识库结构时
npx skills add SethGammon/Citadel --skill learn -g -y
通过截图工具在构建过程中对UI组件进行视觉验证，检测渲染错误、布局断裂及不可见特性，实现快速发现并修复视觉回归问题。
修改 .tsx, .jsx, .vue, .svelte 或 .html 文件后
创建或替换组件时
进行视觉重新设计时
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工作树待合并分支，检测文件级冲突，评估风险并建议安全合并顺序及冲突解决方案。
检查待合并项
查询冲突情况
审查Fleet代理的合并请求
验证合并安全性
npx skills add SethGammon/Citadel --skill merge-review -g -y
用于审计和整理代码仓库结构，检测文件放置是否符合项目约定，执行移动计划并更新导入路径。
决定文件归属位置
审计文件放置规范性
运行命名规范扫描
移动文件以匹配目录布局
npx skills add SethGammon/Citadel --skill organize -g -y
自动分析已完成的 Campaign 或故障事件，聚合规划文件、遥测日志及 Git 历史数据，生成结构化复盘报告，识别失败原因、安全系统拦截情况及潜在模式。
Campaign 完成后的自动建议
用户询问 'what broke' 或 'retro'
执行 /do postmortem 命令
复杂调试会话结束后
npx skills add SethGammon/Citadel --skill postmortem -g -y
本地PR自动修复技能，监控CI状态，读取失败日志并应用针对性修复，检查通过后可选合并。作为终端内替代云端自动修复的工具，支持指定PR或当前分支。
需要监控PR的CI状态
希望从终端自动修复失败的CI检查
未安装Claude GitHub App需本地操作
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
用于将问题转化为结构化研究结果，提供置信度和来源引用。支持单代理或并行模式，执行搜索、提取信息并生成报告，为后续决策提供依据，不直接采取行动。
评估依赖版本或替代方案
查找技术最佳实践
阅读官方 API 文档
调查类似问题的解决方案
检查代码模式已知问题
npx skills add SethGammon/Citadel --skill research -g -y
执行五遍结构化代码审查，涵盖正确性、安全性、性能、可读性和一致性。支持文件、目录或Git diff范围输入，结合项目规范输出具体可操作的修复建议。
用户请求对特定文件或目录进行代码审查
用户提供Git diff范围要求审查变更内容
npx skills add SethGammon/Citadel --skill review -g -y
根据项目现有代码规范生成新文件，自动识别命名、结构及测试模式并集成到项目中。
需要创建符合项目惯例的新组件或模块
要求生成的代码风格与现有代码库保持一致
npx skills add SethGammon/Citadel --skill scaffold -g -y
管理定时任务，支持本地OS级调度、Codex自动化及远程Cron。提供添加、列表、删除功能，默认使用本地脚本以节省配额并保证持久性，仅在显式确认时使用远程API。
安排定期运行的任务
设置一次性定时提醒
查看已调度的任务
取消计划任务
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
根据项目现有测试框架和风格，自动生成并验证单元测试。覆盖正常路径、边界条件和错误路径，确保测试首次运行即通过，不修改源码。
生成模块的初始测试覆盖率
从0开始编写正常、边缘及错误路径测试
npx skills add SethGammon/Citadel --skill test-gen -g -y
GitHub Issue 和 PR 调查工具，自动拉取、分类未标记问题，搜索代码库定位根因，审查 PR 并生成修复方案。支持批量处理、过期问题筛选及与 Codex 集成，辅助 GitHub 工作流管理。
需要调查或分类 GitHub Issue
需要审查 GitHub Pull Request
issue-monitor 报告新问题时
npx skills add SethGammon/Citadel --skill triage -g -y
用于安全移除 Citadel 插件的技能。通过验证采纳凭证生成无写入计划，执行精确文件清理并保留归档，确保项目状态可审查且操作受控。
用户希望从项目中彻底移除 Citadel
需要导出 Citadel 遗留配置但不执行删除
npx skills add SethGammon/Citadel --skill unharness -g -y
对 Citadel Hook 管道进行自测，通过执行 Write、Edit、Bash 等工具调用验证钩子是否触发、遥测数据是否正确累积且无错误，最终输出挂钩健康状态报告。
更新 Hook 后需要快速健康检查
怀疑工具响应慢或质量门禁未触发
新项目安装 Citadel 后验证配置
npx skills add SethGammon/Citadel --skill verify -g -y
文件哨兵技能，监控工作目录变更及标记注释，自动触发相应处理。支持本地轮询或云端定时任务，用于自动化响应文件变化，不适用于一次性检查。
用户希望自动响应文件变更时
检测到文件内容或标记注释变化时
npx skills add SethGammon/Citadel --skill watch -g -y
构建基于Markdown的LLM原生知识库，支持内容摄取、去重、索引维护及跨文件关联查询，无需向量数据库。
需要构建或管理本地知识库
通过自然语言查询已整理的事实性知识
整合多源笔记并生成结构化索引
npx skills add SethGammon/Citadel --skill wiki -g -y
多仓库活动协调器，用于跨多个代码库的复杂变更管理。通过分波次执行、依赖管理和跨库契约协调，实现单体拆分或基础设施扩展等场景下的协同开发。
跨多个代码库的基础设施添加
前后端及基础设施的协同变更
单体架构拆分为微服务
存在跨库依赖关系的任务
npx skills add SethGammon/Citadel --skill workspace -g -y
该 Skill 为通用模板，目前内容为占位符。用户需自行填写具体用途、触发场景及操作指令。适用于尚未定义具体功能的初始状态或作为自定义技能的基座。
需要创建新的自定义技能时
替换通用技能描述时
npx skills add SethGammon/Citadel --skill template-skill -g -y
