菜单
运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
流程编排引擎。推进 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。
工作流熵管理。清理 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。
| name | fitness-run |
| description | 运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。 |
| model | haiku |
跑确定性、结构性检查（依赖方向 / 契约 / 工件完整性），秒级反馈。
| 场景 | 说明 |
|---|---|
| 编码前 | 确认基线（全量跑） |
| 编码后 | 修改结构 / 新增文件后跑相关 rule |
| PreToolUse | Edit/Write 后由 post-tool-linter-feedback.py hook 自动触发 |
fail_fast: true）post-tool-linter-feedback.py hook 按文件变更自动触发相关 rule)fail_fast: true — 任意 rule 红整体就红,不会跑完所有 rulecontract-diff 退出码 1 = 有破坏性变更,是预期结果不是 bugpython scripts/fitness-run.py # 全量
python scripts/fitness-run.py layer-boundary # 单规则
python scripts/fitness-run.py layer-boundary openapi-lint # 多规则
/fitness-run [rule-name] # Claude Code 内召唤
| Rule | 目的 | 退出码 |
|---|---|---|
layer-boundary | 目录依赖方向校验 | 0=pass, 1=fail |
openapi-lint | OpenAPI spec 合法性 | 0=pass, 1=error |
handoff-lint | handoff 工件完整性 | 0=pass, 1=fail |
dep-scan | 依赖漏洞 + 过期 | 0=pass, 1=高危, 2=中危 |
contract-diff | OpenAPI 破坏性变更 | 0=无破坏, 1=有破坏 |
flowchart LR
A[文件变更] --> B[hook 推断相关 rule]
B --> C[fitness-run.py]
C --> D[执行 fitness/*.py]
D --> E[报告 + 退出码]
E --> F{红?}
F -->|是| G[追加到 fitness-backlog.md]
F -->|否| H[pass]
docs/reports/fitness/fitness-run.jsondocs/reports/fitness/<rule>.logdocs/reports/fitness/fitness-backlog.md(hook 失败时追加)fitness/*.pydocs/knowledge/tech/backend/fitness-rules.md.claude/hooks/post-tool-linter-feedback.py