From team-standards
Locates code, traces call chains and behaviors across kpay POS projects (Flutter apps, Spring Cloud services, Rust SDK, TypeScript config) and registers topology knowledge in dedicated repo.
npx claudepluginhub exception-coder/team-standards --plugin team-standardsThis skill uses the workspace's default tool permissions.
| 模式 | 场景 | 入口动作 |
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Guides code writing, review, and refactoring with Karpathy-inspired rules to avoid overcomplication, ensure simplicity, surgical changes, and verifiable success criteria.
Executes ctx7 CLI to fetch up-to-date library documentation, manage AI coding skills (install/search/generate/remove/suggest), and configure Context7 MCP. Useful for current API refs, skill handling, or agent setup.
Share bugs, ideas, or general feedback.
| 模式 | 场景 | 入口动作 |
|---|---|---|
| 查询模式(Read) | 用户要定位、排查、追踪跨项目的代码 / 行为 / 调用链 | 读 kpay-pos-topology/CLAUDE.md § 查找索引表 |
| 登记模式(Write) | 即将写一份跨 ≥2 个工程的 markdown(对照 / 流程 / 数据流) | 落盘到 kpay-pos-topology/mapping/ 或 flows/,同时更新索引表 |
本 skill 仅路由以下工程之间的关系:
| 项目目录 | 类型 |
|---|---|
D:\Users\zhangkai\IdeaProjects\korepos\ | Flutter 终端主端 |
D:\Users\zhangkai\IdeaProjects\korepos-refund\ | Flutter 退款子端 |
D:\Users\zhangkai\IdeaProjects\kpay-pos-business-app-bff\ | BFF 聚合层(Spring Cloud) |
D:\Users\zhangkai\IdeaProjects\kpay-pos-order-manage\ | 订单微服务(Spring Cloud) |
D:\Users\zhangkai\IdeaProjects\kpay-possystem-commodity\ | 商品中心 |
D:\Users\zhangkai\IdeaProjects\pos-store-operation-manage\ | 门店经营管理 |
D:\Users\zhangkai\IdeaProjects\kpay-pos-report\ | 报表 |
D:\Users\zhangkai\IdeaProjects\price-calc-sdk\ | Rust 算价 SDK |
D:\Users\zhangkai\IdeaProjects\pos-config-ts\ | 配置中心 |
权威清单见
kpay-pos-topology/CLAUDE.md§ kpay POS 生态项目清单。若有新增项目,先在那里登记,再回本 skill 更新。
| 维度 | 关键词 |
|---|---|
| 动作意图 | 定位 / 追 / 查 / 排查 / 从...追到 / 调用链 / 链路 / 哪里处理 / 怎么走的 / 为什么返回 / end-to-end / trace |
| 工程名 | korepos / korepos-refund / bff / order-manage / commodity / store-ops / report / price-calc-sdk / Flutter(代指 korepos)/ 前端 / 终端 / 后端 / server |
| 业务域 | 退款 / 订单 / 支付 / 结账 / 反结账 / 日结 / 开班 / 发票 / 打印 / 购物车 / 算价 / 同步 / 钱箱 / 桌台 / 会员 / 员工 / 商品 / 库存 / 促销 / 报表 |
第一步:必读根索引
打开 D:\Users\zhangkai\IdeaProjects\kpay-pos-topology\CLAUDE.md,读到 § 查找索引表。不允许跳过这步直接 grep 项目源码。
第二步:路由判定
用户提到 A 和 B 两个明确工程名?
├─ 是 → 读 mapping/{A}-to-{B}.md(或 {B}-to-{A}.md,按索引表为准)
└─ 否 ↓
用户提到明确业务域(退款/日结/支付/...)?
├─ 是 → 读 flows/{业务域}-flow.md;若索引表标"部分/缺",同时读涉及的 mapping/*.md
└─ 否 ↓
用户只提到一个工程名 + 动作意图?
├─ 是 → 读 project-graph.md 定位该工程的上下游,再按"两工程名"分支重试
└─ 否 ↓
当前工作目录在某个生态工程下?
├─ 是 → 把该工程当作起点,读 project-graph.md 找上下游,再按"两工程名"分支重试
└─ 否 ↓
未命中 → STOP,告知用户未找到对应拓扑文档,询问是否需要新建(转登记模式)
第三步:顺拓扑追代码
拿到对照文档后,按 上游 → 下游 顺序 Read / Grep 各项目的源码。不要跳层。
kpay-pos-topology/kpay-pos-topology/ 为准)即将 Write / Edit 一份 markdown 文件,且:
只要命中登记模式触发信号,STOP 当前写入路径,强制走以下流程:
~/.claude/projects/*/memory/*.md)docs/team-standards/ 里任何位置D:\Users\zhangkai\IdeaProjects\kpay-pos-topology\ 下对应目录| 内容形态 | 落盘位置 | 命名 |
|---|---|---|
| 两项目间接口 / 类 / 表的字面对照 | mapping/ | {上游}-to-{下游}.md(短名,例:bff-to-server.md、korepos-to-bff.md) |
| 跨 ≥3 工程的业务全链路(含时序图 + 数据流图) | flows/ | {业务域}-flow.md(例:refund-flow.md、shift-flow.md) |
| 整体项目关系 / 新工程接入 | 追加到 project-graph.md | — |
mapping/bff-to-server.md 的结构做范本(元信息头 + Controller 级概览 + 接口级明细 + 未解项 + 更新指南)kpay-pos-topology/CLAUDE.md,立即更新 § 查找索引表对应业务域行的"对照文档" / "流程文档" / "状态"列project-graph.md § 二. 按业务域的项目参与度 如果业务域新增或项目参与度变化,同步更新| 场景 | 协作 skill | 关系 |
|---|---|---|
| 跨项目 bug 排查 | bug-doc-required | 先用本 skill 定位代码坐标,再由 bug-doc-required 生成 bug 分析文档(bug 文档仍然落到出问题的项目 docs/bug/,不落本仓库) |
| 跨项目新功能 | design-doc-required | 先用本 skill 理解现状拓扑,再由 design-doc-required 生成设计文档(设计文档落主要项目 docs/design/) |
| 写 Markdown 图表 | markdown-writing-standards | 写 mermaid 图时遵守 markdown-writing-standards 的语法规范 |
| 项目内知识图谱 | init-project-docs / project-docs-update | 那两个管单项目内,本 skill 管跨项目,不冲突 |
| 写 korepos backend | korepos-backend-service | 若 UI 对接手册含跨项目调用(比如 BFF 作为 UI 调用方),UI 对接手册仍然留在 korepos docs/,但跨项目对照部分应提取到本仓库 mapping |
kpay-pos-topology/CLAUDE.md?kpay-pos-topology/ 下,而不是 memory / 项目 docs / team-standards?kpay-pos-topology/CLAUDE.md § 查找索引表?project-graph.md 是否也同步了?kpay-pos-topology/CLAUDE.md § 项目清单 + project-graph.mdkpay-pos-topology/CLAUDE.md § 查找索引表team-standards/docs/skill-flow.md