kamkate/dev-team-maturity-performance-skills

# 研发团队成熟度与性能 — Claude Skills [](https://docs.claude.com/en/docs/claude-code/skills) [](LICENSE) 两个 [Claude Agent Skills](https://docs.claude.com/en/docs/claude-code/skills)，可将原始 Jira 导出数据转化为受治理、可解释的工程成熟度分析 —— 无需仪表板，无需 BI 设置，也无需繁琐的电子表格操作。只需将 Claude 指向你的数据并提问即可。 ## 痛点 工程领导者经常被问到“这个团队到底有多健康？”，他们通常会用以下三种令人不甚满意的选项之一来回答： - **直觉判断** —— 谁与团队沟通得最频繁，谁就主导了这套说辞 - **BI 仪表板** —— 某人在十八个月前搭建的，现在已经没人信任或维护了 - **临时拉取的电子表格** —— 耗费一个下午，且在 sprint 结束的那一刻就过时了 当董事会、VP 或答辩委员会要求“给我看证据”时，以上这些方法都站不住脚。而且，当引入 LLM 来“直接分析 Jira 数据”时，如果字段缺失，它往往会编造出听起来合理的数据，并想出一些听起来有道理但实际上没有任何可重复依据的干预措施。 ## 解决方案 这两个 skill 将其转化为一个受治理、可重复的工作流： 1. **`maturity-onboarding`** —— 一个一次性（或在每次更改时运行）的设置向导，用于捕获*你的*组织在 Jira 中实际跟踪工作的方式，并生成版本化的配置文件。 2. **`maturity-engine`** —— 读取这些配置文件以及你的 Jira 导出数据，并生成一份成熟度报告：**事实**（计算出的 KPI）、**信号**（基于规则的模式）和**干预措施**（来自固定的目录）—— 它们绝不会混为一谈，也绝非凭空捏造。 每个数字都可以追溯到数据中的某个字段。每项干预措施都可以追溯到目录中的某个条目。没有任何猜测成分。 ## 实际效果 **每个 KPI 都有可见的、任务级别的证据作为支撑** —— 而不是一个黑盒分数。当你问“为什么 cycle time 显示为红色（RED）？”时，引擎会展示其计算过程：  **提出后续问题，例如“我今天、本周以及进行 sprint 规划时分别需要做什么？”** Claude 会将计算出的模式直接转化为优先级的行动计划 —— 每一项仍可追溯到目录中的干预 ID（`INT-012`、`INT-008`、……）以及触发该干预的 KPI 证据：  ## 适用人群 | 角色 | 收益 | |---|---| | **CTO / VP Engineering** | 提供跨团队交付健康的可辩护、面向董事会的视图 —— 并有充足的证据支持每一项声明 | | **Engineering Manager** | 基于你实际的 Jira 数据，为你自己的团队提供当日行动计划（今日 / 本周 / sprint 规划） | | **Agile Coach / Delivery Lead** | 提供一种一致、可重复的方式，以便在多个团队中进行成熟度评估，而无需每次重新推导分析过程 | | **Management Consultant** | 提供一款结构化的诊断工具，能够为客户业务产出可审计、可复现的诊断结果 | ## 包含内容 | Skill | 用途 | |---|---| | [`maturity-engine`](plugins/maturity-engine/skills/maturity-engine) | 根据 Jira 数据计算 5 项确定性的交付 KPI，检测诊断模式，对团队成熟度进行评分（0–100），并从固定的目录中推荐干预措施。 | | [`maturity-onboarding`](plugins/maturity-onboarding/skills/maturity-onboarding) | 引导 CTO 或顾问完成为新组织配置引擎的过程 —— 包括 KPI 定义、阈值、活动模式以及数据质量说明。 | 这两个 skill 旨在结合使用：**onboarding** 会生成 `org-config.md` 和 `org-kpi-definitions.md` 文件，供 **engine** 在分析时使用。 ### 内置治理 - **确定性 KPI** —— 每一个数字均由你的 Jira 导出数据计算得出，绝不进行估算（[`kpi-definitions.md`](plugins/maturity-engine/skills/maturity-engine/references/kpi-definitions.md)） - **基于规则的模式检测** —— 相同的输入始终产生相同的信号，无需 LLM 进行主观判断（[`pattern-rules.md`](plugins/maturity-engine/skills/maturity-engine/references/pattern-rules.md)） - **固定的干预目录** —— 建议仅来自你控制的目录，绝不临时捏造 - **严格的护栏** —— 不进行个人（人员层面）的评估，不产生因果声明，不忽视数据缺失（[`guardrails.md`](plugins/maturity-engine/skills/maturity-engine/references/guardrails.md)） ## 前置要求 - [Claude Code](https://docs.claude.com/en/docs/claude-code/overview)、Claude Project，或任何支持 [Agent Skills](https://docs.claude.com/en/docs/claude-code/skills) 的 Claude 平台 - 分析时需提供你自己的数据文件： - `jira_db.json` —— 导出的 Jira 数据（任务、epic、initiative、sprint） - `catalog.json` —— 你的干预目录 - `org-config.md` + `org-kpi-definitions.md` —— 由 onboarding skill 生成 ## 安装说明 ### 选项 A — Claude Code 插件市场（推荐） 本仓库是一个自包含的插件市场，只需两条命令即可完成安装 —— 无需手动复制，且可通过 `/plugin marketplace update` 进行更新。 ``` /plugin marketplace add kamkate/dev-team-maturity-performance-skills /plugin install maturity-engine@dev-team-maturity-performance-skills /plugin install maturity-onboarding@dev-team-maturity-performance-skills ``` 或者从终端以非交互方式运行： ``` claude plugin marketplace add kamkate/dev-team-maturity-performance-skills claude plugin install maturity-engine@dev-team-maturity-performance-skills claude plugin install maturity-onboarding@dev-team-maturity-performance-skills ``` ### 选项 B — 手动复制 如果你只想要 skill 文件而不需要插件系统： ``` git clone https://github.com/kamkate/dev-team-maturity-performance-skills.git cp -r dev-team-maturity-performance-skills/plugins/maturity-engine/skills/maturity-engine ~/.claude/skills/ cp -r dev-team-maturity-performance-skills/plugins/maturity-onboarding/skills/maturity-onboarding ~/.claude/skills/ ``` Claude Code 会自动从 `~/.claude/skills/`（个人级，全平台）或 `.claude/skills/`（项目级）中发现 skill —— 开启新会话无需重启。 ## 使用说明 **1. 引导设置一个新组织**（仅在首次使用或 KPI 定义发生更改时）： onboarding skill 会逐步引导你完成组织背景、KPI 自定义、阈值、活动模式及数据质量说明的配置，随后生成 `org-config.md`、`org-kpi-definitions.md` 以及一份 `onboarding-report.md`。 **2. 运行分析：** 引擎会加载你的配置文件，计算 KPI，检测模式，对成熟度进行评分，并返回一份结构化的报告 —— 事实、信号以及源自目录的干预措施会被清晰地区分开来。请参阅 [`output-template.md`](plugins/maturity-engine/skills/maturity-engine/references/output-template.md) 了解确切的输出结构。 ## 仓库结构 ``` .claude-plugin/ marketplace.json marketplace catalog listing both plugins plugins/ maturity-engine/ .claude-plugin/plugin.json plugin manifest skills/maturity-engine/ SKILL.md entry point — governance, session startup, data model references/ kpi-definitions.md full KPI formulas, null handling, edge cases pattern-rules.md atomic + compound pattern detection logic scoring-model.md maturity score aggregation formula output-template.md required output structure for every response guardrails.md hard/soft rules the engine cannot break org-configs/ template.md copy this to configure a new organization maturity-onboarding/ .claude-plugin/plugin.json plugin manifest skills/maturity-onboarding/ SKILL.md entry point — 8-step onboarding flow references/ kpi-walkthrough.md per-KPI customization dialogue threshold-guide.md threshold calibration guidance per KPI output-generator.md exact file formats for onboarding outputs ``` ## 许可证 [MIT](LICENSE) —— 可自由使用、改编和分发。

标签：Claude Skills, Homebrew安装, Jira, KPI分析, 工程管理, 研发效能, 防御加固