Menu
运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
流程编排引擎。推进 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