软件工程
跨 UI、API、数据、作业和配置追踪功能
单个功能的端到端追踪,将用户操作连接到界面、API、领域逻辑、数据、异步作业、配置和可观察结果。
流程
按这个顺序做。
- 说明功能、用户或系统结果、修订、环境、入口事件,以及范围内行为与相邻行为的边界。
- 从界面状态和路由追踪交互,经过身份验证、API 验证、领域命令、查询和数据写入。
- 跟随事件、队列、定时作业、Webhook、第三方调用、重试,以及配置或功能开关分支直到消费者。
- 将成功、失败、空值、权限、超时、重复和恢复状态映射到用户反馈、日志、指标、追踪和审计记录。
- 用源代码、测试、模式或授权的运行时证据验证每一跳,标记未知链接,不把看似合理的路径当成事实。
- 识别合同、版本、所有权、隔离和失败边界,避免一层变化时破坏功能。
- 发布时序图或追踪表,包含源代码位置、证据置信度、缺失链接、下一步检查和未解决风险。
先准备
猫会向你要的输入。
- 功能定义与用户结果
- 仓库修订与环境
- 界面、API、数据和作业边界
- 所需证据与负责人
路由器 + 一份 playbook
先路由。只选一份。
Cat Paw 每次任务只加载一份 playbook,不合并多份。先走这个路由器;其余路径是此 workflow 可检查的候选。
- 路由器:
code-graph-pack skills/code-graph-pack/cross-layer-feature-trace/SKILL.md
界限
界限跟着提示一起走。
- 开始前核实实际工具、账号、权限和工作区;绝不声称拥有不可用的工具、账号、来源或能力。
- 私有代码、产物、实时探测或非公开数据使用 Latch/target-workspace;如果无法访问,就在边界停止并报告阻塞,不要用猜测替代。
- 任何有后果的外部行动前先暂停并取得明确批准;返回证据、未解决风险、假设以及仍等待批准的行动。
完成代表
一个可核对的终点。
跨层功能追踪将用户操作连接到界面、API、领域、数据、作业、配置和可观测性,并带有源代码证据与明确缺口。
来源
这个流程从哪来。
- github.com/Graphify-Labs/graphify/tree/4c735618f3d56fd622c2049771584621c31ba9ff/
- c4model.com/
- github.com/open-telemetry/semantic-conventions-genai
来源确立 workflow 的模式。如有 Reddit 或社区帖子,视为实务轶事,不是普遍事实。