dev-agent-flow

流程编排引擎。推进 task.json.flow 步骤（init/check/complete/reset）并维护任务级事件流 task.json.events（emit/check/recent）。触发关键词：flow advance、推进流程、当前步骤、初始化流程、emit event、查事件、task.json.events、flow-engine。

TAPD 统一入口 skill。工单拉取、共识管理、子任务回填、事件驱动同步。触发关键词：tapd、初始化、ticket sync、共识、Wiki 评审、子任务、工时回填、QA 通过、QA 打回、TAPD 事件、契约推送、同步工单、拉工单。

产出结构化 handoff 工件，让新 session 无痕接续当前任务。ctx-guard 阻断或主动切换 session 时使用。触发关键词：context reset、上下文重置、新开 session、切换 session、handoff。

运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。

工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。

Git 操作统一入口。分支生命周期（create/merge/cleanup）、worktree（create/remove）、提交推送（commit-push）。按 docs/git-brance-spec.md + Conventional Commits 中文规范执行。触发关键词：创建分支、合并到 dev、合并到 uat、删除分支、清理分支、git push、commit、推送代码、worktree、提交代码。

统一集成测试入口。按 env.yaml 显式指定 / 文件名约定 fallback 探测被测项目的 testing skill,委托其跑测试输出统一 schema 的 verdict.json。

为 Java / Spring Boot 项目编写符合团队规范的测试——覆盖单元/集成测试、AOP Mock 第三方异常、错误码契约（@ExceptionHandler）与 X-Simulate-Failure 故障注入 Header 协作。可作为 integration-test skill 委托的 testing adapter——按 spec.md §7 生成集成测试 + 跑 mvn verify + 输出 verdict.json。TRIGGER：写/补/改测试，Mock 第三方异常（Token 过期/限流/超时），定义错误码,被 evaluator 委托跑集成测试,编辑 *Test.java。SKIP：性能压测、覆盖率配置、只问 JUnit API 用法。

Jenkins 构建部署技能。触发 CI/CD 构建、轮询构建状态、发送企业微信通知。被 /tapd start 或 start-dev-flow 在开发完成后自动调用。触发关键词：jenkins、构建部署、CI/CD、发布、deploy、构建。

Send structured notification to team IM channel (WeChat Work webhook) — project-aware / per-project install

动态编排逃生舱。当任务不规则、7 个静态 flow(vibe/plan/spec/tapd-full/bugfix-*)都不合身时(大规模迁移、跨模块审计、深度调研、规模化分类),指导主 Claude 按 fan-out-synthesize 协议在运行时把任务分解为并行子代理 + 单点 join。触发关键词:orchestrate、动态编排、大规模迁移、跨模块审计、深度调研、扇出。

远程日志获取工具。通过 SSH 访问远程服务器查询日志。 当用户说：查询日志、获取日志、查看日志、远程日志、日志追踪、traceId 查日志、 "帮我看看某台机器的日志"、"log" + traceId、"日志文件" + 服务器 等关键词时使用。 也适用于：诊断问题、排查 bug、分析日志、需要从服务器获取日志内容的场景。

USE WHEN: 用户想新建 skill / 评估现有 skill 结构 / 生成 skill 骨架。OUTPUT: 完整 skill 目录(SKILL.md + scripts/ + references/),按 Anthropic 6 铁律 + 本项目约定。DO NOT USE: 单纯查 skill 用法(直接读 SKILL.md) / 创建 agent 或 command(那是 `.claude/agents/` 和 `.claude/commands/` 的入口)。

USE WHEN: 创建任务记录 / 恢复已有任务 / 列任务索引 / 绑定 git 分支到任务 / 查询历史任务。OUTPUT: task.json (SSOT) + _index.jsonl 注册 + .current_task 切换。DO NOT USE: 推进 flow 步骤(走 flow-engine) / TAPD 工单同步(走 tapd) / git 分支创建本身(走 git)。

记录与读取架构决策记录(Architecture Decision Records, ADR)。在做出、提议或推翻任何"架构重要"的决策时务必使用本 skill——例如选型或替换数据库、框架、编程语言、通信协议(REST/gRPC/消息队列),引入或移除重要依赖或服务,拆分/合并服务,或确立某种贯穿全局的约定(鉴权、错误处理、数据一致性、API 版本策略)。同样地,在开始任何会触及架构的任务之前,先用本 skill 读取已有 ADR,理解当前设计背后的约束与理由,再动手修改。即使用户没有明说"ADR",只要某个决策难以逆转、或未来维护者会问"当初为什么这么设计",就应当触发本 skill 来记录或查阅。

Phased audit for spec-implementation alignment — spec / architecture / api / behavior / integration / issue-process / rule-coverage

Check pending handoff tasks from PM/SA, execute by priority

Issue / Bug standard handling flow — dual platform (GitHub + TAPD) with 5-scenario handoff discipline, doc-first approach

Trigger CI/CD build for deployment — select branch, trigger job, report status, post-process labels

Apply agent-dev-standard writing style when authoring or editing project markdown (rules / protocols / skills / docs / CHANGELOG / ADR / handoff / spec). Triggers when user writes / edits / drafts .md files, creates new rule or protocol or skill docs, writes ADR or CHANGELOG entries, or asks how to write project docs. Enforces section markers, table-first organization, Chinese-English mixed convention, bold-only-for-discipline, and anti-pattern checklist.

USE WHEN: 读/写/重构 Python CLI 脚本或工具(.claude/skills/*/scripts/ 下任意 .py)、规划模块拆分、code review Python 改动。OUTPUT: 设计建议 + 复杂度评估,基于 Ousterhout《A Philosophy of Software Design》。DO NOT USE: 业务代码逻辑设计 / pytest 用法咨询 / 性能调优 / Web 框架问题。