From team-standards
Loads documented code coordinates (file paths, line numbers) before writing any implementation code, acting as a mandatory bridge between design/bug docs and coding.
How this skill is triggered — by the user, by Claude, or both
Slash command
/team-standards:pre-implementation-code-orientationThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**分析/设计阶段已将代码坐标固化在文档中。实施阶段必须先消费这些坐标,禁止重新扫描。**
分析/设计阶段已将代码坐标固化在文档中。实施阶段必须先消费这些坐标,禁止重新扫描。
flowchart TD
A(["准备开始实施"]) --> B{"来源是哪份文档?"}
B -->|"Bug 修复"| C["读 docs/bug/{bug名称}/{bug名称}.md"]
B -->|"需求开发"| D["读 docs/design/{需求名称}/{需求名称}-current.md\n或最新 coding.md"]
C & D --> E["提取「涉及类清单」表\n获取全类名列表"]
E --> F["提取「关键代码路径」表\n获取文件路径 + 行号"]
F --> G["按行号逐个 Read 每个关键文件\n使用 offset+limit 精准加载,不读整个文件"]
G --> H["输出代码定位摘要\n确认已理解各关键位置"]
H --> I(["开始实施代码"])
询问或从上下文判断本次实施对应的是:
docs/bug/{bug名称}/{bug名称}.mddocs/design/{需求名称}/ 下的 current.md 或最新 coding.md从文档的「涉及类清单」表读取所有全类名,转换为文件路径:
全类名 → 文件路径规则:
com.kpaygroup.pos.order.modules.service.v1.impl.OrderV1ServiceImpl
→ kpay-pos-order-manage-server/src/main/java/
com/kpaygroup/pos/order/modules/service/v1/impl/OrderV1ServiceImpl.java
从文档的「关键代码路径」表读取每一行的:
对每个关键位置,使用 offset + limit 加载目标行附近的代码:
行号 5642,读前后 50 行:
Read(file, offset=5620, limit=80)
不允许读整个文件,除非文件本身很小(小于 100 行)。
完成所有 Read 后,输出如下格式的摘要,再开始实施:
已定位代码,关键位置确认:
1. OrderV1ServiceImpl:5616 queryOrderAllDataToB() — 入口,调用 queryOrderToB 后进 handleOrderRelationData
2. OrderV1ServiceImpl:5642 handleOrderRelationData() — 核心问题方法,10个并行Future + allOf.join()
3. PosOrderMapper.kt:184 queryOrderToB() — 主订单查询,无 deleted 过滤,无数据量上限
4. PosOrderMapperExtend.xml:798 queryOrderToB SQL — WHERE store_id AND order_time BETWEEN,缺索引风险
准备实施:[修复方案简述]
| 行为 | 原因 |
|---|---|
| 跳过本 skill 直接开始写代码 | 文档中已有坐标,重复扫描是浪费 |
| 用 Glob/Grep 重新搜索已在文档中的类 | 文档的涉及类清单就是为了避免这一步 |
| 读整个大文件 | 用 offset+limit 精准加载,保护上下文窗口 |
| 凭记忆判断代码位置 | 代码可能已被他人修改,必须实际 Read 确认 |
bug-doc-required / design-doc-required
↓ 文档写完,坐标已固化
pre-implementation-code-orientation ← 本 skill
↓ 代码已定位,上下文已加载
java-coding-standards(开始写代码)
↓
git-commit-standards(提交)
Provides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
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.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub exception-coder/team-standards --plugin team-standards